Qiblə API-si, vidcet və süni intellekt konnektoru

JSON API

Onluq dərəcələrlə lat və lon və ya city ilə GET sorğusu göndərin: əhalisi 15 000 və daha çox olan, bir çox dildə yazılmış istənilən şəhər. Bir ad bir neçə yerə aiddirsə, country əlavə edin.

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

Cavab həqiqi şimaldan bucağı, maqnit kompasındakı bucağı və bugünkü maqnit meylini, istiqaməti, kilometr və millə məsafəni, bir sətirlik cümləni, müəllif sətrini və həmin yer üçün canlı kompas keçidini 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"
}

İstənilən saytdan çarpaz mənbə sorğularına icazə verilir. Xahiş edirik, saniyədə təxminən bir sorğunu keçməyin; daha sürətli müştərilər yavaşladılır.

Süni intellekt köməkçiləri

Awwab uzaq MCP serveri işlədir ki, süni intellekt köməkçiləri istifadəçiləri üçün qibləni tapıb Awwab adını qeyd edə bilsin. Giriş tələb olunmur.

https://awwab.app/mcp

Onun qiblə aləti find_qibla koordinatları və ya şəhəri qəbul edir. ChatGPT tətbiqində cavab kiçik kompas kartı ilə gəlir; Claude və digər köməkçilərdə isə canlı kompasa eyni keçidlə mətn və məlumat kimi gəlir. Sınamaq üçün yuxarıdakı ünvanı Claude tətbiqində xüsusi konnektor kimi və ya ChatGPT tərtibatçı rejimində tətbiq kimi əlavə edin.

Həmin server daha iki alətlə Awwab Knowledge sınağını işlədir. start_quiz istəyə bağlı mövzu və dil qəbul edir və cavabları olmadan beş sualdan ibarət bir raund qaytarır; check_answer bir cavabı yoxlayır, izahı və mənbələrini qaytarır. Vidjetləri dəstəkləyən tətbiqlərdə raund sınaq kartında oynanılır; digər müştərilərdə isə mətn və məlumat kimi gəlir. Nəticələrdə “Quiz by Awwab · awwab.app” müəlliflik qeydi olur.

Süni intellekt tətbiqinizi qoşun

Tətbiqiniz üçün ayarı kopyalayın. Hamısı eyni serverə yönəlir və açar tələb etmir.

Claude (xüsusi konnektor)

Claude-da Settings → Connectors → Add custom connector bölməsini açın, sonra 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 (developer rejimi)

ChatGPT-də Settings → Apps → Advanced settings bölməsini açın, developer rejimini yandırın, Create app seçin, sonra 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 və 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])

Kəşf

Server kartı /mcp/server-card ünvanındadır və /.well-known/ai-catalog.json siyahısındadır. JSON API GPT əməliyyatları və digər agent çərçivələri üçün OpenAPI 3.1 ilə təsvir olunub.

Məscidlər, məktəblər və bloqlar bir neçə sətir kodla qibləni öz səhifələrində göstərə bilər. Qiblə tapıcısı səhifəsində şəhəri və ya hər ziyarətçinin yerini, açıq və ya tünd görünüşü və dili seçin.

Məxfilik

API-yə və ya konnektora göndərilən koordinatları və şəhərləri qeyd etmir və saxlamırıq. Cavabdan sonra heç nə saxlanmır və kuki qoyulmur. Sui-istifadənin qarşısını almaq üçün Cloudflare hər IP ünvanından gələn sorğuları təxminən bir dəqiqə ərzində sayır. Bütün təfərrüatlar məxfilik siyasətimizdədir.

Rəqəmlər necə hesablanır

Bucaq — kürə üzərində yerdən Kəbəyə (21,422487° şm. e., 39,826206° ş. u.) qədər böyük dairənin başlanğıc istiqamətidir; qiblə adətən belə hesablanır. Onun Yer ellipsoidi üzərindəki hesabdan fərqi yarım dərəcədən azdır. Məsafə Yerin orta radiusu ilə hesablanır. Maqnit meyli 2029-cu ilin sonunadək qüvvədə olan World Magnetic Model 2025 modelindən götürülür.

Şərtlər

Nəticənin göstərildiyi hər yerdə “Qibla direction by Awwab” yazısını awwab.app/qibla keçidi ilə qeyd etmək şərti ilə pulsuzdur. Şəhər adları və yerləri GeoNames mənbəyindən, CC BY 4.0 lisenziyası ilə götürülüb; onlardan təkrar istifadə etsəniz, GeoNames mənbəyini də qeyd edin. Suallar: support@awwab.app.