API danych i agenci AI
Wszystko, co pokazują mapa i Atlas Criora, można również pobrać programowo: siedmiodniową prognozę wraz z ryzykiem dla dowolnego punktu, długoterminowy profil klimatyczny dowolnego punktu, niebezpieczne zdarzenia w pobliżu punktu oraz profil ryzyka każdego kraju. Te same dane są dostępne na dwa sposoby: przez serwer MCP dla asystentów AI oraz przez JSON API dla własnego kodu.
Nie trzeba zakładać konta ani uzyskiwać klucza. Oba interfejsy służą wyłącznie do odczytu.
Dla asystentów AI: serwer MCP
Criora udostępnia zdalny serwer Model Context Protocol pod adresem:
https://criora.com/mcpWystarczy dodać go jako własny konektor w dowolnym asystencie obsługującym zdalne serwery MCP (Claude, ChatGPT, Cursor, VS Code i inne). Uwierzytelnianie nie jest wymagane. Przykładowy wpis w pliku konfiguracyjnym MCP:
{
"mcpServers": {
"criora": { "url": "https://criora.com/mcp" }
}
}Serwer udostępnia siedem narzędzi. Każde przyjmuje szerokość i długość geograficzną albo nazwę miejsca, którą dopasowuje do najtrafniejszego wyniku i podaje w odpowiedzi.
| Narzędzie | Na jakie pytanie odpowiada |
|---|---|
assess_place | Wszystko o miejscu w jednej odpowiedzi: prognozowane ryzyko na każdy dzień, zagrożenia w pobliżu, profil klimatyczny, kraj |
get_forecast | Pogoda i ryzyko pogodowe na siedem dni, w podziale na lokalne doby lub krok po kroku |
get_climate_profile | Długoterminowa ekspozycja: powodzie, wzrost poziomu morza, upał, susza, stres wodny i inne |
get_hazards_near | Pożary, trzęsienia ziemi, powodzie, cyklony, wulkany, susze i jakość powietrza w pobliżu miejsca |
get_country_profile | Oceny ryzyka kraju oraz, na życzenie, wszystkie wskaźniki z ich wartościami odniesienia |
compare_countries | Od dwóch do dziesięciu krajów zestawionych obok siebie, z ich pozycjami w rankingu |
find_place | Współrzędne dla nazwy miejsca, gdy nazwa jest niejednoznaczna |
Serwer udostępnia też trzy prompty, czyli gotowe pytania, od których asystent może zacząć: assess_trip ocenia ryzyko podróży w wybranych terminach, compare_places_to_live zestawia długoterminowe narażenie kilku miejsc, a country_briefing porównuje jeden kraj z jego regionem i resztą świata.
Dla własnego kodu: JSON API
Wszystkie endpointy znajdują się pod adresem https://criora.com/api/v1 i odpowiadają na żądania GET w formacie JSON.
| Endpoint | Zwraca |
|---|---|
/place/forecast?lat=&lon= | Bieżący przebieg prognozy w punkcie: każdy krok i podsumowanie dla każdej lokalnej doby |
/place/climate?lat=&lon= | Wszystkie długoterminowe warstwy klimatyczne w punkcie; categories= zawęża wynik (np. flooding) |
/place/report?lat=&lon= | Prognozę na każdy dzień, zagrożenia w pobliżu, profil klimatyczny i kraj w jednej odpowiedzi |
/geodata/live-events/nearby?lat=&lon= | Niebezpieczne zdarzenia w pobliżu punktu; wynik zawężają radius_km=, event_types= i since= |
/countries/risks | Ocenę ogólną i oceny w poszczególnych wymiarach dla każdego kraju |
/country/{ISO3}/summary | Oceny i klasyfikację jednego kraju |
/country/{ISO3}/risks | Wskaźniki jednego kraju, każdy ze światową i regionalną wartością odniesienia |
/geocode/search?q= | Miejsca pasujące do nazwy, według OpenStreetMap Nominatim |
Na przykład prognoza dla Sewilli:
curl "https://criora.com/api/v1/place/forecast?lat=37.39&lon=-5.99"Jak czytać ryzyko w prognozie
Każdy krok prognozy zawiera klasę ryzyka od 0 („Słabe”) do 4 („Skrajne”), zagrożenie, które ją wyznacza, oraz wartość fizyczną, na której się opiera: temperaturę odczuwalną UTCI dla upału i mrozu, prędkość porywów dla wiatru oraz natężenie opadu dla deszczu i śniegu. Deszcz, śnieg i wiatr mają pierwszeństwo przed temperaturą, zgodnie z tą samą regułą, którą stosuje mapa. Podsumowanie każdego dnia wskazuje jego główne ryzyko i podaje najwyższą klasę, jaką danego dnia osiąga każde zagrożenie.
Limity
Wyszukiwanie po nazwie miejsca odbywa się przez OpenStreetMap Nominatim, który pozwala na jedno zapytanie na sekundę dla całej usługi Criora łącznie, dlatego jeśli współrzędne są znane, lepiej przekazywać właśnie je.
Odpowiedzi z prognozą zmieniają się, gdy zostaje opublikowany nowy przebieg modelu, czyli dwa razy na dobę. Warstwy klimatyczne zmieniają się, gdy zbiór danych zostaje przebudowany. W odpowiedziach mogą pojawiać się nowe pola; istniejące pola zachowują swoje znaczenie.
Źródła i uznanie autorstwa
Każda odpowiedź podaje swoje źródło. Publikując lub rozpowszechniając dane z Criora, należy wskazać Criora i przestrzegać licencji podanego źródła: prognoza pochodzi od Environment and Climate Change Canada (ECCC) na licencji Data Server End-use Licence, nazwy miejsc pochodzą z OpenStreetMap na licencji ODbL, a każda warstwa klimatyczna podaje własnego dostawcę i licencję. Pełna lista znajduje się w sekcji Źródła danych. Korzystanie z API podlega Regulaminowi.
Criora publikuje dane, a nie porady. Podawane liczby nie zastępują profesjonalnego doradztwa finansowego, ubezpieczeniowego ani w zakresie bezpieczeństwa.