API kiblat, widget, dan konektor AI

API JSON

Kirim permintaan GET dengan lat dan lon dalam derajat desimal, atau dengan city: kota mana pun berpenduduk 15.000 jiwa atau lebih, ditulis dalam banyak bahasa. Tambahkan country jika satu nama dipakai 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

Jawabannya memuat derajat dari utara sejati, derajat pada kompas magnetis dan deklinasi magnetis hari ini, arah mata angin, jarak dalam kilometer dan mil, satu kalimat ringkas, baris kredit, dan tautan ke kompas langsung untuk 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 lintas asal diizinkan dari situs mana pun. Mohon batasi sekitar satu permintaan per detik; klien yang lebih cepat akan diperlambat.

Asisten AI

Awwab menjalankan server MCP jarak jauh, agar asisten AI dapat menemukan kiblat bagi penggunanya dan menyebut Awwab. Tidak perlu masuk akun.

https://awwab.app/mcp

Alat kiblatnya, find_qibla, menerima koordinat atau kota. Di ChatGPT, jawabannya disertai kartu kompas kecil; di Claude dan asisten lain, jawabannya berupa teks dan data dengan tautan yang sama ke kompas langsung. Untuk mencobanya, tambahkan alamat di atas sebagai konektor khusus di Claude, atau sebagai aplikasi di mode pengembang ChatGPT.

Server yang sama menjalankan Kuis Pengetahuan Awwab dengan dua alat tambahan. start_quiz menerima topik dan bahasa opsional, lalu mengembalikan satu putaran berisi lima pertanyaan tanpa jawabannya; check_answer menilai satu jawaban dan mengembalikan penjelasan beserta sumbernya. Di aplikasi yang mendukung widget, putaran dimainkan dalam kartu kuis; di klien lain, putaran tiba sebagai teks dan data. Hasilnya menyertakan kredit “Quiz by Awwab · awwab.app”.

Hubungkan aplikasi AI Anda

Salin pengaturan untuk aplikasi Anda. Semuanya mengarah ke server yang sama dan tidak memerlukan kunci.

Claude (konektor khusus)

Di Claude, buka Settings → Connectors → Add custom connector, lalu 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 (mode pengembang)

Di ChatGPT, buka Settings → Apps → Advanced settings, aktifkan mode pengembang, pilih Create app, lalu 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

Kartu server ada di /mcp/server-card dan tercantum di /.well-known/ai-catalog.json. API JSON dijelaskan dalam OpenAPI 3.1, untuk GPT actions dan kerangka agen lainnya.

Masjid, sekolah, dan blog dapat menampilkan kiblat di halaman mereka dengan beberapa baris kode. Pilih kota atau lokasi setiap pengunjung, tampilan terang atau gelap, dan bahasa di halaman pencari kiblat.

Privasi

Kami tidak mencatat atau menyimpan koordinat maupun kota yang dikirim ke API atau konektor. Tidak ada yang disimpan setelah jawaban, dan tidak ada cookie yang dipasang. Untuk mencegah penyalahgunaan, Cloudflare menghitung permintaan per alamat IP selama sekitar satu menit. Rinciannya ada di kebijakan privasi kami.

Cara angka-angka ini dihitung

Derajat arah adalah arah awal lingkaran besar dari tempat itu ke Ka'bah (21,422487° LU, 39,826206° BT) pada bola, cara yang lazim untuk menghitung kiblat. Selisihnya dengan perhitungan pada elipsoid bumi kurang dari setengah derajat. Jaraknya memakai jari-jari rata-rata bumi. Deklinasi magnetis berasal dari World Magnetic Model 2025, yang berlaku hingga akhir 2029.

Ketentuan

Gratis digunakan, dengan syarat mencantumkan “Qibla direction by Awwab” dengan tautan ke awwab.app/qibla di mana pun hasilnya ditampilkan. Nama dan posisi kota berasal dari GeoNames dengan lisensi CC BY 4.0; sebutkan juga GeoNames jika Anda memakainya kembali. Pertanyaan: support@awwab.app.