قبلہ API، ویجٹ اور اے آئی کنیکٹر

JSON API

GET درخواست بھیجیں جس میں اعشاری ڈگریوں میں lat اور lon ہوں، یا city: 15,000 یا اس سے زیادہ آبادی والا کوئی بھی شہر، کئی زبانوں میں لکھا ہوا۔ اگر ایک نام کئی جگہوں کا ہو تو country شامل کریں۔

https://awwab.app/api/qibla?lat=51.5074&lon=-0.1278
https://awwab.app/api/qibla?city=Karachi
https://awwab.app/api/qibla?city=Hyderabad&country=IN

جواب میں حقیقی شمال سے زاویہ، مقناطیسی کمپاس پر زاویہ اور آج کا مقناطیسی انحراف، سمت، کلومیٹر اور میل میں فاصلہ، ایک سطر کا جملہ، حوالے کی سطر اور اس جگہ کے لائیو کمپاس کا لنک ہوتا ہے:

{
  "place_name": "Karachi",
  "bearing_true": 267.7,
  "bearing_magnetic": 266.4,
  "magnetic_declination": 1.3,
  "cardinal": "W",
  "distance_km": 2801,
  "distance_mi": 1740,
  "attribution": "Qibla direction by Awwab · https://awwab.app/qibla",
  "live_compass_url": "https://awwab.app/qibla?city=karachi"
}

کسی بھی ویب سائٹ سے کراس اوریجن درخواستوں کی اجازت ہے۔ براہِ کرم تقریباً ایک سیکنڈ میں ایک درخواست تک رہیں؛ اس سے تیز درخواستیں سست کر دی جاتی ہیں۔

اے آئی اسسٹنٹس

اوّاب ایک ریموٹ MCP سرور چلاتا ہے، تاکہ اے آئی اسسٹنٹس اپنے صارفین کے لیے قبلہ معلوم کریں اور اوّاب کا حوالہ دیں۔ اس کے لیے سائن اِن کی ضرورت نہیں۔

https://awwab.app/mcp

اس کا قبلہ ٹول، find_qibla، کوآرڈینیٹس یا شہر لیتا ہے۔ ChatGPT میں جواب ایک چھوٹے کمپاس کارڈ کے ساتھ آتا ہے؛ Claude اور دوسرے اسسٹنٹس میں یہ متن اور ڈیٹا کی صورت میں، لائیو کمپاس کے اسی لنک کے ساتھ آتا ہے۔ آزمانے کے لیے اوپر کا پتہ Claude میں کسٹم کنیکٹر کے طور پر، یا ChatGPT کے ڈویلپر موڈ میں ایپ کے طور پر شامل کریں۔

یہی سرور دو مزید ٹولز کے ساتھ اوّاب علمی کوئز چلاتا ہے۔ start_quiz اختیاری موضوع اور زبان لیتا ہے اور جوابات کے بغیر پانچ سوالوں کا ایک راؤنڈ واپس کرتا ہے؛ check_answer ایک جواب جانچتا ہے اور وضاحت اور اس کے ماخذ واپس کرتا ہے۔ جو ایپس ویجٹ کی سہولت رکھتی ہیں ان میں راؤنڈ کوئز کارڈ میں کھیلا جاتا ہے؛ باقی کلائنٹس میں یہ متن اور ڈیٹا کی صورت میں آتا ہے۔ نتائج میں “Quiz by Awwab · awwab.app” کا حوالہ شامل ہوتا ہے۔

اپنی اے آئی ایپ جوڑیں

اپنی ایپ کی ترتیب کاپی کریں۔ سب ایک ہی سرور کی طرف اشارہ کرتی ہیں اور کسی کلید کی ضرورت نہیں۔

Claude (کسٹم کنیکٹر)

Claude میں Settings ← Connectors ← Add custom connector کھولیں، پھر یہ بھریں:

Name: Awwab Qibla
URL:  https://awwab.app/mcp

Claude Code

claude mcp add --transport http awwab-qibla https://awwab.app/mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "awwab-qibla": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://awwab.app/mcp"]
    }
  }
}

ChatGPT (ڈویلپر موڈ)

ChatGPT میں Settings ← Apps ← Advanced settings کھولیں، ڈویلپر موڈ آن کریں، Create app چنیں، پھر یہ بھریں:

Name:                Awwab Qibla
MCP server URL:      https://awwab.app/mcp
Authentication:      No authentication

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "awwab-qibla": { "url": "https://awwab.app/mcp" }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "awwab-qibla": { "type": "http", "url": "https://awwab.app/mcp" }
  }
}

Gemini CLI (~/.gemini/settings.json)

{
  "mcpServers": {
    "awwab-qibla": { "httpUrl": "https://awwab.app/mcp" }
  }
}

OpenAI: Responses API اور Agents SDK

// Responses API: a remote MCP tool
{
  "type": "mcp",
  "server_label": "awwab_qibla",
  "server_url": "https://awwab.app/mcp",
  "allowed_tools": ["find_qibla"],
  "require_approval": "never"
}

# Agents SDK (Python)
from agents import Agent
from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(name="awwab-qibla", params={"url": "https://awwab.app/mcp"}) as qibla:
    agent = Agent(name="Assistant", mcp_servers=[qibla])

دریافت

سرور کارڈ /mcp/server-card پر ہے اور /.well-known/ai-catalog.json میں درج ہے۔ JSON API کی تفصیل OpenAPI 3.1 میں ہے، GPT ایکشنز اور دوسرے ایجنٹ فریم ورکس کے لیے۔

ویجٹ

مساجد، مدارس اور بلاگ کوڈ کی چند سطروں سے اپنے صفحات پر قبلہ دکھا سکتے ہیں۔ قبلہ فائنڈر کے صفحے پر شہر یا ہر وزیٹر کا مقام، روشن یا گہرا انداز اور زبان منتخب کریں۔

رازداری

API یا کنیکٹر کو بھیجے گئے کوآرڈینیٹس یا شہر ہم نہ لاگ کرتے ہیں نہ محفوظ کرتے ہیں۔ جواب کے بعد کچھ نہیں رکھا جاتا اور کوئی کوکی نہیں رکھی جاتی۔ غلط استعمال روکنے کے لیے Cloudflare ہر IP ایڈریس کی درخواستیں تقریباً ایک منٹ تک گنتا ہے۔ پوری تفصیل ہماری رازداری پالیسی میں ہے۔

اعداد کیسے نکالے جاتے ہیں

زاویہ اس جگہ سے کعبہ (21.422487° شمال، 39.826206° مشرق) تک کُرے پر عظیم دائرے کی ابتدائی سمت ہے، اور قبلہ عموماً اسی طرح نکالا جاتا ہے۔ زمین کی بیضوی شکل پر حساب سے اس کا فرق آدھی ڈگری سے کم ہے۔ فاصلہ زمین کے اوسط نصف قطر سے نکلتا ہے۔ مقناطیسی انحراف ورلڈ میگنیٹک ماڈل 2025 سے ہے، جو 2029 کے آخر تک کارآمد ہے۔

شرائط

استعمال مفت ہے، اس شرط پر کہ جہاں بھی نتیجہ دکھائیں وہاں «Qibla direction by Awwab» کا حوالہ awwab.app/qibla کے لنک کے ساتھ دیں۔ شہروں کے نام اور مقامات GeoNames سے CC BY 4.0 کے تحت ہیں؛ انہیں دوبارہ استعمال کریں تو GeoNames کا حوالہ بھی دیں۔ سوالات: support@awwab.app۔