API kiblat, widget dan penyambung AI

API JSON

Hantar permintaan GET dengan lat dan lon dalam darjah perpuluhan, atau dengan city: mana-mana bandar berpenduduk 15,000 orang atau lebih, ditulis dalam pelbagai bahasa. Tambah country jika satu nama dikongsi beberapa tempat.

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

Jawapannya memberikan bearing dari utara benar, bearing pada kompas magnet dan serongan magnet hari ini, arah mata angin, jarak dalam kilometer dan batu, satu ayat ringkas, baris kredit dan pautan ke kompas langsung bagi tempat itu:

{
  "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"
}

Permintaan rentas asal dibenarkan dari mana-mana laman. Sila hadkan kepada kira-kira satu permintaan sesaat; pelanggan yang lebih laju akan diperlahankan.

Pembantu AI

Awwab menjalankan pelayan MCP jauh, supaya pembantu AI boleh mencari kiblat untuk pengguna mereka dan memberi kredit kepada Awwab. Ia tidak memerlukan log masuk.

https://awwab.app/mcp

Alat kiblatnya, find_qibla, menerima koordinat atau bandar. Dalam ChatGPT, jawapan disertai kad kompas kecil; dalam Claude dan pembantu lain, ia tiba sebagai teks dan data dengan pautan yang sama ke kompas langsung. Untuk mencubanya, tambah alamat di atas sebagai penyambung tersuai dalam Claude, atau sebagai aplikasi dalam mod pembangun ChatGPT.

Pelayan yang sama menjalankan Kuiz Ilmu Awwab dengan dua alat lagi. start_quiz menerima topik dan bahasa pilihan, lalu memulangkan satu pusingan lima soalan tanpa jawapannya; check_answer menilai satu jawapan dan memulangkan penjelasan serta sumbernya. Dalam aplikasi yang menyokong widget, pusingan dimainkan dalam kad kuiz; dalam klien lain, ia tiba sebagai teks dan data. Keputusan membawa kredit “Quiz by Awwab · awwab.app”.

Sambungkan aplikasi AI anda

Salin tetapan untuk aplikasi anda. Semuanya menghala ke pelayan yang sama dan tidak memerlukan kunci.

Claude (penyambung tersuai)

Dalam Claude, buka Settings → Connectors → Add custom connector, kemudian isi:

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 (mod pembangun)

Dalam ChatGPT, buka Settings → Apps → Advanced settings, hidupkan mod pembangun, pilih Create app, kemudian isi:

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 dan 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])

Penemuan

Kad pelayan berada di /mcp/server-card dan disenaraikan dalam /.well-known/ai-catalog.json. API JSON diterangkan dalam OpenAPI 3.1, untuk tindakan GPT dan rangka kerja ejen lain.

Masjid, sekolah dan blog boleh memaparkan kiblat pada halaman mereka dengan beberapa baris kod. Pilih bandar atau lokasi setiap pelawat, rupa cerah atau gelap, dan bahasa di halaman pencari kiblat.

Privasi

Kami tidak merekod atau menyimpan koordinat atau bandar yang dihantar ke API atau penyambung. Tiada apa yang disimpan selepas jawapan, dan tiada kuki dipasang. Untuk mengelakkan penyalahgunaan, Cloudflare mengira permintaan bagi setiap alamat IP selama kira-kira satu minit. Butiran penuh ada dalam dasar privasi kami.

Cara angka-angka ini dikira

Bearing ialah arah permulaan bulatan besar dari tempat itu ke Kaabah (21.422487° U, 39.826206° T) pada sfera, cara biasa mengira kiblat. Bezanya dengan pengiraan pada elipsoid bumi kurang daripada setengah darjah. Jarak menggunakan jejari purata bumi. Serongan magnet diambil daripada World Magnetic Model 2025, yang sah hingga akhir 2029.

Terma

Percuma digunakan, dengan syarat anda memberi kredit “Qibla direction by Awwab” dengan pautan ke awwab.app/qibla di mana-mana hasilnya dipaparkan. Nama dan kedudukan bandar daripada GeoNames di bawah CC BY 4.0; beri kredit kepada GeoNames juga jika anda menggunakannya semula. Pertanyaan: support@awwab.app.