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

Кросс-доменные запросы разрешены с любого сайта. Пожалуйста, не больше одного запроса в секунду; более частые запросы замедляются.

ИИ-ассистенты

Awwab держит удалённый MCP-сервер, чтобы ИИ-ассистенты могли находить киблу для своих пользователей, указывая Awwab. Вход не нужен.

https://awwab.app/mcp

Его инструмент для киблы, find_qibla, принимает координаты или город. В ChatGPT ответ приходит с небольшой карточкой компаса; в Claude и других ассистентах — текстом и данными с той же ссылкой на компас. Чтобы попробовать, добавьте адрес выше как пользовательский коннектор в Claude или как приложение в режиме разработчика ChatGPT.

Тот же сервер запускает викторину Awwab с помощью ещё двух инструментов. 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 или коннектор. После ответа ничего не сохраняется, cookie не ставятся. Для защиты от злоупотреблений Cloudflare около минуты считает запросы с каждого IP-адреса. Подробности — в нашей политике конфиденциальности.

Как рассчитываются цифры

Угол — это начальное направление дуги большого круга от места до Каабы (21,422487° с. ш., 39,826206° в. д.) на сфере; так обычно и вычисляют киблу. От расчёта на земном эллипсоиде он отличается меньше чем на полградуса. Расстояние считается по среднему радиусу Земли. Магнитное склонение берётся из World Magnetic Model 2025, действующей до конца 2029 года.

Условия

Бесплатно при условии, что везде, где показан результат, вы указываете «Qibla direction by Awwab» со ссылкой на awwab.app/qibla. Названия и координаты городов взяты из GeoNames по лицензии CC BY 4.0; при их повторном использовании указывайте и GeoNames. Вопросы: support@awwab.app.