API & Serveur MCP GeoDecrypt
Accédez aux données d'intelligence géopolitique : scores de risque par pays, corridors maritimes critiques, scénarios, analyses à la demande et protocoles pour agents autonomes (MCP).
La clé, en 44 secondes
Vos outils savent déjà obtenir des données. Il leur manque une seule chose : un code d'accès. Ce film montre ce qui circule, en combien de temps, et ce que vous gardez la main.
LA CLÉ API EN 44 SECONDES
Authentification
Toutes les routes nécessitent une clé API envoyée dans le header Authorization. Créez une clé depuis votre offre Corporate & Supply Chain (route POST /api/keys, réservée aux comptes Corporate). Une seule clé peut être partagée dans toute une équipe.
curl https://geodecrypt.fr/api/v1/countries/taiwan/risk \ -H "Authorization: Bearer gdi_xxxxxxxx"
Endpoints REST disponibles
GET /api/v1/chokepoints
État des 9 détroits et corridors maritimes critiques mondiaux : statut de crise, niveau de friction, menaces balistiques/navales, déroutement et surcoûts fret calculés.
Paramètres optionnels : ?critical=true (filtre les crises aiguës), ?lang=en|fr
GET /api/v1/countries/{slug}/risk
Score de risque géopolitique (0-100), niveau, dimensions, scénarios, acteurs clés, sources.
Exemple : /api/v1/countries/taiwan/risk, /api/v1/countries/iran/risk, /api/v1/countries/ukraine/risk
POST /api/v1/analyze
Génère une analyse géopolitique complète (JSON structuré) sur un sujet à la demande. Timeout ~60s. Comptabilisée dans le quota mensuel de la clé.
GET /api/v1/analysis/{slug}
Récupère une analyse par slug (y compris en attente via flag poll).
POST /api/v1/webhook/dispatch
Pousse une alerte géopolitique vers Slack, Discord ou Telegram : plateforme, URL du webhook et alerte (titre, gravité, résumé, entité/pays). Hors quota.
Exemple — pousser une alerte dans un canal Slack :
curl -X POST https://geodecrypt.fr/api/v1/webhook/dispatch \
-H "Authorization: Bearer gdi_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"platform":"slack","targetUrl":"https://hooks.slack.com/services/XXX/YYY/ZZZ","alert":{"title":"Ormuz : tension navale","severity":"élevé","summary":"Escalade signalée sur le détroit — 12 % du pétrole mondial y transite.","entityOrCountry":"Iran"}}'Serveur MCP — Agents IA & Systèmes Autonomes
GeoDecrypt expose nativement son moteur de renseignement géopolitique et de calcul de risque maritime via le standard Model Context Protocol (MCP). Vos agents autonomes (Claude, Cursor, OpenCode ou pipelines internes) interrogent directement les données stratégiques.
chokepoint_status
Surveillance des 9 détroits critiques mondiaux + 10 alertes tactiques avec compteurs de trafic.
country_risk(slug: "taiwan" | "iran" | ...)
Fiche risque pays structurée, dimensions de friction, acteurs clés et scénarios actifs.
Snippet de configuration (ex: claude_desktop_config.json) :
"geodecrypt": {
"command": "npx",
"args": ["-y", "tsx", "./mcp-server/server.ts"],
"env": {
"GEODECRYPT_API_KEY": "gdi_xxxxxxxx"
}
}Provenance et fraîcheur
Chaque réponse porte l'origine de ses données. Vous savez ainsi ce que vous intégrez, et à quelle fraîcheur — avant de le brancher dans un processus de conformité.
GET /api/v1/countries/{slug}/risk
Score calculé à partir du référentiel interne (indicateurs publics et sources citées) et de l'analyse associée. Le champ sources de la réponse ne contient que des documents réellement récupérés par la recherche : sans résultat, l'analyse est marquée « non sourcée » plutôt que citée de mémoire.
SourceCatalogue GeoDecrypt · référentiel pays versionné · méthode
SourceTavily (recherche web) · sources réelles remplaçant toute citation du modèle · méthode
POST /api/v1/analyze
Génération à la demande. Le texte soumis est transmis à notre fournisseur de modèle — c'est le seul point où une donnée sort de l'infrastructure GeoDecrypt. Le résultat est mis en cache (6 h à 30 jours selon le type d'analyse) : un même sujet ne consomme pas deux fois le quota.
SourceDeepSeek (modèles) · fournisseur d'inférence actuellement utilisé · état vérifié le 2026-09-23 · méthode
SourceTavily (recherche web) · recherche préalable des sources · méthode
POST /api/v1/webhook/dispatch
La charge utile d'alerte est construite par l'appelant ; l'API la relaie vers votre webhook sans l'interpréter. Aucune donnée n'est ajoutée par nos soins, donc aucune provenance implicite.
SourceStockage Airtable · les identifiants d'analyse sont stockés en base · méthode
L'intégralité des sources, leurs méthodes et leur état vérifié sont publiés dans le registre des sources.
Obtenir une clé API
L'API REST est accessible avec l'offre Corporate & Supply Chain (149 €/mois). Chaque clé dispose de son quota mensuel, d’une authentification Bearer et d’un compteur d’usage en temps réel — et peut être partagée entre collaborateurs.
Découvrir l'offre Corporate & Supply ChainLimitations : 60 req/min par IP, 20 analyses/min par clé (100/min si quota mensuel supérieur à 1 000), quota mensuel par clé (500 analyses par défaut, ajustable). Le catalogue complet (80 pays, 278 entreprises, 9 détroits critiques) sera exposé dans une prochaine version de l'API.