Kıble API'si, widget ve yapay zekâ bağlayıcısı

JSON API

Ondalık derece cinsinden lat ve lon ile ya da city ile bir GET isteği gönderin: nüfusu 15.000 ve üzeri olan, birçok dilde yazılmış herhangi bir şehir. Bir ad birkaç yerde kullanılıyorsa country ekleyin.

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

Yanıt; gerçek kuzeyden açıyı, manyetik pusuladaki açıyı ve bugünkü manyetik sapmayı, yönü, kilometre ve mil cinsinden uzaklığı, tek satırlık bir cümleyi, atıf satırını ve o yer için canlı pusula bağlantısını verir:

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

Her siteden çapraz kaynak isteklerine izin verilir. Lütfen saniyede yaklaşık bir isteği aşmayın; daha hızlı istemciler yavaşlatılır.

Yapay zekâ asistanları

Awwab, yapay zekâ asistanlarının kullanıcıları için kıbleyi bulup Awwab'ı anabilmesi için uzak bir MCP sunucusu çalıştırır. Oturum açmak gerekmez.

https://awwab.app/mcp

Kıble aracı olan find_qibla, koordinat ya da şehir alır. ChatGPT'de yanıt küçük bir pusula kartıyla gelir; Claude ve diğer asistanlarda ise canlı pusulaya aynı bağlantıyla metin ve veri olarak ulaşır. Denemek için yukarıdaki adresi Claude'da özel bağlayıcı olarak ya da ChatGPT'nin geliştirici modunda uygulama olarak ekleyin.

Aynı sunucu, iki araçla daha Awwab Bilgi Yarışması’nı çalıştırır. start_quiz, isteğe bağlı konu ve dil alır ve cevapları olmadan beş soruluk bir tur döndürür; check_answer tek bir cevabı değerlendirir, açıklamayı ve kaynaklarını döndürür. Uygulama widget’larını destekleyen ortamlarda tur bir yarışma kartında oynanır; diğer istemcilerde metin ve veri olarak gelir. Sonuçlar “Quiz by Awwab · awwab.app” atfını taşır.

Yapay zekâ uygulamanızı bağlayın

Uygulamanızın ayarını kopyalayın. Hepsi aynı sunucuyu gösterir ve anahtar gerektirmez.

Claude (özel bağlayıcı)

Claude'da Settings → Connectors → Add custom connector'ı açın, sonra şunları doldurun:

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 (geliştirici modu)

ChatGPT'de Settings → Apps → Advanced settings'i açın, geliştirici modunu etkinleştirin, Create app'i seçin, sonra şunları doldurun:

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

Keşif

Sunucu kartı /mcp/server-card adresindedir ve /.well-known/ai-catalog.json dosyasında listelenir. JSON API, GPT eylemleri ve diğer ajan çerçeveleri için OpenAPI 3.1 ile tanımlanmıştır.

Camiler, okullar ve bloglar birkaç satır kodla kıbleyi kendi sayfalarında gösterebilir. Kıble bulucu sayfasında bir şehir ya da her ziyaretçinin konumunu, açık veya koyu görünümü ve dili seçin.

Gizlilik

API'ye ya da bağlayıcıya gönderilen koordinatları veya şehirleri kaydetmez ve saklamayız. Yanıttan sonra hiçbir şey tutulmaz ve çerez kullanılmaz. Kötüye kullanımı önlemek için Cloudflare, her IP adresinden gelen istekleri yaklaşık bir dakika boyunca sayar. Tüm ayrıntılar gizlilik politikamızda.

Sayılar nasıl hesaplanır

Açı, bir küre üzerinde o yerden Kâbe'ye (21,422487° K, 39,826206° D) giden büyük dairenin başlangıç yönüdür; kıble genellikle böyle hesaplanır. Dünya elipsoidi üzerindeki hesaptan farkı yarım dereceden azdır. Uzaklık, Dünya'nın ortalama yarıçapıyla hesaplanır. Manyetik sapma, 2029 sonuna kadar geçerli olan World Magnetic Model 2025'ten gelir.

Koşullar

Sonucun gösterildiği her yerde “Qibla direction by Awwab” ibaresini awwab.app/qibla bağlantısıyla vermeniz şartıyla ücretsizdir. Şehir adları ve konumları GeoNames'ten, CC BY 4.0 lisansıyla gelir; yeniden kullanırsanız GeoNames'i de anın. Sorular: support@awwab.app.