API de datos y agentes de IA
Todo lo que muestran el mapa y el Atlas de Criora se puede consultar también de forma programática: el pronóstico a siete días y su riesgo para cualquier punto, el perfil climático a largo plazo de cualquier punto, los eventos de amenaza cercanos a un punto y el perfil de riesgo de cada país. Los mismos datos se ofrecen de dos maneras: un servidor MCP para asistentes de IA y una API JSON para su propio código.
No necesita cuenta ni clave. Ambos accesos son de solo lectura.
Para asistentes de IA: el servidor MCP
Criora ofrece un servidor remoto de Model Context Protocol en:
https://criora.com/mcpAñádalo como conector personalizado en cualquier asistente que admita servidores MCP remotos (Claude, ChatGPT, Cursor, VS Code y otros). No se requiere autenticación. Por ejemplo, en un archivo de configuración de MCP:
{
"mcpServers": {
"criora": { "url": "https://criora.com/mcp" }
}
}El servidor ofrece siete herramientas. Cada una admite latitud y longitud, o bien un nombre de lugar, que asocia a la coincidencia más probable e indica en la respuesta.
| Herramienta | Qué responde |
|---|---|
assess_place | Todo sobre un lugar en una sola respuesta: riesgo pronosticado por día, amenazas cercanas, perfil climático, país |
get_forecast | Tiempo y riesgo meteorológico a siete días, por día local o paso a paso |
get_climate_profile | Exposición a largo plazo: inundaciones, subida del nivel del mar, calor, sequía, estrés hídrico y más |
get_hazards_near | Incendios forestales, terremotos, inundaciones, ciclones, volcanes, sequías y calidad del aire cerca de un lugar |
get_country_profile | Las puntuaciones de riesgo de un país y, si se solicita, cada indicador con sus valores de referencia |
compare_countries | De dos a diez países en paralelo, con su posición en la clasificación |
find_place | Coordenadas a partir del nombre de un lugar, cuando el nombre es ambiguo |
El servidor ofrece además tres prompts, preguntas ya preparadas con las que un asistente puede empezar: assess_trip, sobre el riesgo de un viaje en sus fechas; compare_places_to_live, que compara la exposición a largo plazo de varios lugares, y country_briefing, que sitúa un país frente a su región y al resto del mundo.
Para su código: la API JSON
Todos los endpoints están bajo https://criora.com/api/v1 y responden a solicitudes GET con JSON.
| Endpoint | Devuelve |
|---|---|
/place/forecast?lat=&lon= | La pasada de pronóstico vigente en un punto: cada paso y un resumen por día local |
/place/climate?lat=&lon= | Todas las capas climáticas a largo plazo en un punto; categories= acota la selección (p. ej., flooding) |
/place/report?lat=&lon= | Pronóstico por día, amenazas cercanas, perfil climático y país en una sola respuesta |
/geodata/live-events/nearby?lat=&lon= | Eventos de amenaza cerca de un punto; radius_km=, event_types= y since= acotan la selección |
/countries/risks | La puntuación global y por dimensión de cada país |
/country/{ISO3}/summary | Las puntuaciones y la clasificación de un país |
/country/{ISO3}/risks | Los indicadores de un país, cada uno con su referencia mundial y regional |
/geocode/search?q= | Lugares que coinciden con un nombre, según OpenStreetMap Nominatim |
Por ejemplo, el pronóstico para Sevilla:
curl "https://criora.com/api/v1/place/forecast?lat=37.39&lon=-5.99"Cómo leer el riesgo pronosticado
Cada paso del pronóstico incluye una clase de riesgo de 0 (Mínimo) a 4 (Crítico), la amenaza que la determina y el valor físico en que se basa: la sensación térmica UTCI para el calor y el frío, la velocidad de las rachas para el viento y la intensidad de la precipitación para la lluvia y la nieve. La lluvia, la nieve y el viento prevalecen sobre la temperatura, la misma regla que aplica el mapa. El resumen de cada día indica su riesgo principal y recoge la clase más alta que alcanza ese día cada amenaza.
Límites
Las búsquedas por nombre de lugar pasan por OpenStreetMap Nominatim, que permite una sola solicitud por segundo para el conjunto de Criora, así que envíe coordenadas siempre que las tenga.
Las respuestas de pronóstico cambian cuando se publica una nueva pasada del modelo, dos veces al día. Las capas climáticas cambian cuando se reconstruye un conjunto de datos. Pueden añadirse campos a las respuestas; los campos existentes conservan su significado.
Fuentes y atribución
Cada respuesta indica su fuente. Si publica o redistribuye datos de Criora, cite a Criora y respete la licencia de la fuente indicada: el pronóstico procede de Environment and Climate Change Canada (ECCC) bajo su Data Server End-use Licence, los nombres de lugares proceden de OpenStreetMap bajo la licencia ODbL y cada capa climática indica su propio proveedor y licencia. Consulte la lista completa en Fuentes de datos. El uso de la API se rige por los Términos de servicio.
Criora publica datos, no asesoramiento. Sus cifras no sustituyen el asesoramiento profesional financiero, de seguros o de seguridad.