API qibla, widget et connecteur pour l’IA

API JSON

Envoyez une requête GET avec lat et lon en degrés décimaux, ou avec city : toute ville de 15 000 habitants ou plus, écrite dans de nombreuses langues. Ajoutez country quand un nom est partagé par plusieurs lieux.

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

La réponse donne le cap depuis le nord géographique, le cap sur une boussole magnétique et la déclinaison magnétique du jour, la direction, la distance en kilomètres et en miles, une phrase d’une ligne, la mention à citer et un lien vers la boussole en direct pour ce lieu :

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

Les requêtes depuis n’importe quel site sont autorisées. Merci de vous limiter à environ une requête par seconde ; les clients plus rapides sont ralentis.

Assistants IA

Awwab fait tourner un serveur MCP distant, pour que les assistants IA trouvent la qibla pour leurs utilisateurs en citant Awwab. Aucune connexion n’est nécessaire.

https://awwab.app/mcp

Son outil qibla, find_qibla, prend des coordonnées ou une ville. Dans ChatGPT, la réponse s’accompagne d’une petite carte avec une boussole ; dans Claude et les autres assistants, elle arrive sous forme de texte et de données, avec le même lien vers la boussole en direct. Pour l’essayer, ajoutez l’adresse ci-dessus comme connecteur personnalisé dans Claude, ou comme application dans le mode développeur de ChatGPT.

Le même serveur fait tourner le quiz Awwab Savoir avec deux autres outils. start_quiz prend un thème et une langue facultatifs et renvoie une partie de cinq questions sans leurs réponses ; check_answer corrige une réponse et renvoie l’explication et ses sources. Dans les applications qui prennent en charge les widgets, la partie se joue dans une carte de quiz ; ailleurs, elle arrive sous forme de texte et de données. Les résultats portent la mention « Quiz by Awwab · awwab.app ».

Connecter votre app d’IA

Copiez le réglage de votre app. Tous pointent vers le même serveur et aucun ne demande de clé.

Claude (connecteur personnalisé)

Dans Claude, ouvrez Settings → Connectors → Add custom connector, puis remplissez :

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 développeur)

Dans ChatGPT, ouvrez Settings → Apps → Advanced settings, activez le mode développeur, choisissez Create app, puis remplissez :

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

Découverte

La fiche du serveur est à /mcp/server-card et figure dans /.well-known/ai-catalog.json. L’API JSON est décrite en OpenAPI 3.1, pour les actions GPT et les autres frameworks d’agents.

Mosquées, écoles et blogs peuvent afficher la qibla sur leurs propres pages en quelques lignes de code. Choisissez une ville ou la position de chaque visiteur, une apparence claire ou sombre et une langue sur la page de l’outil qibla.

Confidentialité

Nous ne journalisons ni ne conservons les coordonnées ou les villes envoyées à l’API ou au connecteur. Rien n’est gardé après la réponse, et aucun cookie n’est déposé. Pour éviter les abus, Cloudflare compte les requêtes par adresse IP pendant environ une minute. Tous les détails sont dans notre politique de confidentialité.

Comment les chiffres sont calculés

Le cap est la direction de départ du grand cercle allant du lieu à la Kaaba (21,422487° N, 39,826206° E) sur une sphère, la façon habituelle de calculer la qibla. Il diffère d’un calcul sur l’ellipsoïde terrestre de moins d’un demi-degré. La distance utilise le rayon moyen de la Terre. La déclinaison magnétique vient du World Magnetic Model 2025, valable jusqu’à fin 2029.

Conditions

Utilisation gratuite, à condition de citer « Qibla direction by Awwab » avec un lien vers awwab.app/qibla partout où le résultat est affiché. Les noms et positions des villes viennent de GeoNames sous licence CC BY 4.0 ; citez aussi GeoNames si vous les réutilisez. Questions : support@awwab.app.