API de données et agents IA
Tout ce qu’affichent la carte et l’Atlas de Criora est aussi accessible par programmation : la prévision à sept jours et son risque en tout point, le profil climatique à long terme de tout point, les aléas en cours à proximité d’un point et le profil de risque de chaque pays. Ces données sont proposées de deux façons : un serveur MCP pour les assistants IA et une API JSON pour votre propre code.
Aucun compte ni aucune clé ne sont nécessaires. Les deux accès sont en lecture seule.
Pour les assistants IA : le serveur MCP
Criora héberge un serveur Model Context Protocol distant, à l’adresse suivante :
https://criora.com/mcpAjoutez-le comme connecteur personnalisé dans tout assistant compatible avec les serveurs MCP distants (Claude, ChatGPT, Cursor, VS Code, entre autres). Aucune authentification n’est requise. Par exemple, dans un fichier de configuration MCP :
{
"mcpServers": {
"criora": { "url": "https://criora.com/mcp" }
}
}Le serveur propose sept outils. Chacun accepte une latitude et une longitude, ou un nom de lieu qu’il rattache à la meilleure correspondance, précisée dans la réponse.
| Outil | Ce qu’il renvoie |
|---|---|
assess_place | Tout sur un lieu en une seule réponse : risque prévu jour par jour, aléas à proximité, profil climatique, pays |
get_forecast | Météo et risque météorologique sur sept jours, par jour local ou pas à pas |
get_climate_profile | Exposition à long terme : inondations, élévation du niveau de la mer, chaleur, sécheresse, stress hydrique, etc. |
get_hazards_near | Feux de forêt, séismes, inondations, cyclones, volcans, sécheresses et qualité de l’air à proximité d’un lieu |
get_country_profile | Les scores de risque d’un pays et, sur demande, chaque indicateur avec ses valeurs de référence |
compare_countries | De deux à dix pays côte à côte, avec leur rang |
find_place | Les coordonnées d’un lieu à partir de son nom, lorsque ce nom est ambigu |
Le serveur propose aussi trois prompts, des questions toutes prêtes par lesquelles un assistant peut commencer : assess_trip pour savoir si un voyage est risqué aux dates prévues, compare_places_to_live pour comparer l’exposition à long terme de plusieurs lieux, et country_briefing pour situer un pays par rapport à sa région et au reste du monde.
Pour votre code : l’API JSON
Tous les points de terminaison se trouvent sous https://criora.com/api/v1 et répondent en JSON aux requêtes GET.
| Point de terminaison | Renvoie |
|---|---|
/place/forecast?lat=&lon= | La dernière exécution de la prévision en un point : chaque pas de temps et un résumé par jour local |
/place/climate?lat=&lon= | Toutes les couches climatiques de long terme en un point ; categories= restreint la sélection (par ex. flooding) |
/place/report?lat=&lon= | Prévision jour par jour, aléas à proximité, profil climatique et pays, en une seule réponse |
/geodata/live-events/nearby?lat=&lon= | Les aléas en cours à proximité d’un point ; radius_km=, event_types= et since= restreignent la sélection |
/countries/risks | Le score global et les scores par dimension de chaque pays |
/country/{ISO3}/summary | Les scores et la classification d’un pays |
/country/{ISO3}/risks | Les indicateurs d’un pays, chacun avec sa valeur de référence mondiale et régionale |
/geocode/search?q= | Les lieux correspondant à un nom, d’après OpenStreetMap Nominatim |
Par exemple, la prévision pour Séville :
curl "https://criora.com/api/v1/place/forecast?lat=37.39&lon=-5.99"Lire le risque prévu
Chaque pas de prévision porte une classe de risque de 0 (Minime) à 4 (Critique), l’aléa qui la détermine et la grandeur physique sur laquelle elle repose : la température ressentie UTCI pour la chaleur et le froid, la vitesse des rafales pour le vent, l’intensité des précipitations pour la pluie et la neige. La pluie, la neige et le vent l’emportent sur la température, selon la même règle que sur la carte. Le résumé de chaque journée indique son risque principal et donne, pour chaque aléa, la classe la plus élevée atteinte ce jour-là.
Limites
Les recherches par nom de lieu passent par OpenStreetMap Nominatim, qui n’autorise qu’une requête par seconde pour l’ensemble de Criora : transmettez donc des coordonnées lorsque vous en disposez.
Les réponses de prévision changent à chaque publication d’une nouvelle exécution du modèle, soit deux fois par jour. Les couches climatiques changent lorsqu’un jeu de données est reconstruit. Des champs peuvent être ajoutés aux réponses ; les champs existants conservent leur signification.
Sources et attribution
Chaque réponse cite sa source. Lorsque vous publiez ou redistribuez des données de Criora, mentionnez Criora et respectez la licence de la source indiquée : la prévision provient d’Environnement et Changement climatique Canada (ECCC), sous sa licence d’utilisation finale des serveurs de données, les noms de lieux proviennent d’OpenStreetMap sous licence ODbL, et chaque couche climatique indique son propre fournisseur et sa licence. La liste complète figure dans Sources de données. L’utilisation de l’API est régie par les Conditions d’utilisation.
Criora publie des données, pas des conseils. Ses chiffres ne remplacent pas l’avis d’un professionnel en matière de finance, d’assurance ou de sécurité.