API dei dati e agenti AI
Tutto ciò che mostrano la mappa e l’Atlante di Criora è accessibile anche in modo programmatico: la previsione a sette giorni con il relativo rischio per qualsiasi punto, il profilo climatico di lungo periodo di qualsiasi punto, gli eventi pericolosi vicino a un punto e il profilo di rischio di ogni Paese. Gli stessi dati sono disponibili in due modi: un server MCP per gli assistenti AI e un’API JSON per il tuo codice.
Non servono account né chiavi. Entrambi gli accessi sono in sola lettura.
Per gli assistenti AI: il server MCP
Criora gestisce un server Model Context Protocol remoto all’indirizzo:
https://criora.com/mcpAggiungilo come connettore personalizzato in qualsiasi assistente che supporti i server MCP remoti (Claude, ChatGPT, Cursor, VS Code e altri). Non è richiesta alcuna autenticazione. Ad esempio, in un file di configurazione MCP:
{
"mcpServers": {
"criora": { "url": "https://criora.com/mcp" }
}
}Il server offre sette strumenti. Ognuno accetta latitudine e longitudine, oppure il nome di un luogo, che associa alla corrispondenza migliore e riporta nella risposta.
| Strumento | A cosa risponde |
|---|---|
assess_place | Tutto su un luogo in un’unica risposta: rischio previsto giorno per giorno, pericoli nelle vicinanze, profilo climatico, Paese |
get_forecast | Meteo e rischio meteorologico a sette giorni, per giorno locale o passo per passo |
get_climate_profile | Esposizione di lungo periodo: alluvioni, innalzamento del livello del mare, caldo, siccità, stress idrico e altro |
get_hazards_near | Incendi, terremoti, alluvioni, cicloni, vulcani, siccità e qualità dell’aria vicino a un luogo |
get_country_profile | I punteggi di rischio di un Paese e, su richiesta, ogni indicatore con i relativi valori di riferimento |
compare_countries | Da due a dieci Paesi a confronto, con la rispettiva posizione in classifica |
find_place | Le coordinate di un luogo a partire dal nome, quando il nome è ambiguo |
Il server offre anche tre prompt, domande già pronte da cui un assistente può partire: assess_trip per capire quanto è rischioso un viaggio nelle sue date, compare_places_to_live per confrontare l’esposizione a lungo termine di più luoghi e country_briefing per mettere un paese a confronto con la sua regione e con il resto del mondo.
Per il tuo codice: l’API JSON
Tutti gli endpoint si trovano sotto https://criora.com/api/v1 e rispondono alle richieste GET in JSON.
| Endpoint | Restituisce |
|---|---|
/place/forecast?lat=&lon= | L’ultima corsa della previsione in un punto: ogni passo e un riepilogo per giorno locale |
/place/climate?lat=&lon= | Tutti i layer climatici di lungo periodo in un punto; categories= restringe la selezione (ad es. flooding) |
/place/report?lat=&lon= | Previsione giorno per giorno, pericoli nelle vicinanze, profilo climatico e Paese in un’unica risposta |
/geodata/live-events/nearby?lat=&lon= | Eventi pericolosi vicino a un punto; radius_km=, event_types= e since= restringono la selezione |
/countries/risks | Il punteggio complessivo e i punteggi per dimensione di ogni Paese |
/country/{ISO3}/summary | Punteggi e classificazione di un singolo Paese |
/country/{ISO3}/risks | Gli indicatori di un singolo Paese, ciascuno con il proprio riferimento mondiale e regionale |
/geocode/search?q= | I luoghi che corrispondono a un nome, da OpenStreetMap Nominatim |
Ad esempio, la previsione per Siviglia:
curl "https://criora.com/api/v1/place/forecast?lat=37.39&lon=-5.99"Leggere il rischio previsto
Ogni passo della previsione riporta una classe di rischio da 0 (Minimo) a 4 (Critico), il pericolo che la determina e il valore fisico su cui si basa: la temperatura percepita UTCI per caldo e freddo, la velocità delle raffiche per il vento, l’intensità delle precipitazioni per pioggia e neve. Pioggia, neve e vento prevalgono sulla temperatura, secondo la stessa regola usata dalla mappa. Il riepilogo di ogni giorno indica il rischio principale e riporta, per ciascun pericolo, la classe più alta raggiunta quel giorno.
Limiti
Le ricerche per nome di luogo passano da OpenStreetMap Nominatim, che consente una sola richiesta al secondo per tutta Criora, quindi passa le coordinate quando le hai.
Le risposte di previsione cambiano quando viene pubblicata una nuova corsa del modello, due volte al giorno. I layer climatici cambiano quando un dataset viene ricostruito. Alle risposte possono aggiungersi nuovi campi; quelli esistenti mantengono il loro significato.
Fonti e attribuzione
Ogni risposta indica la propria fonte. Se pubblichi o ridistribuisci dati di Criora, cita Criora e rispetta la licenza della fonte indicata: la previsione proviene da Environment and Climate Change Canada (ECCC) con la sua Data Server End-use Licence, i nomi dei luoghi da OpenStreetMap con licenza ODbL, e ogni layer climatico indica il proprio fornitore e la propria licenza. L’elenco completo è in Fonti dei dati. L’uso dell’API è regolato dai Termini di servizio.
Criora pubblica dati, non consulenza. I suoi valori non sostituiscono una consulenza professionale in materia finanziaria, assicurativa o di sicurezza.