API данных и ИИ-агенты
Всё, что показывают карта и Атлас Criora, доступно и программно: семидневный прогноз погоды и его риск для любой точки, долгосрочный климатический профиль любой точки, опасные события рядом с точкой и профиль рисков каждой страны. Эти данные можно получить двумя способами: через MCP-сервер для ИИ-ассистентов и через JSON API для Вашего собственного кода.
Ни регистрация, ни ключ не нужны. Оба интерфейса работают только на чтение.
Для ИИ-ассистентов: MCP-сервер
Criora предоставляет удалённый сервер Model Context Protocol по адресу:
https://criora.com/mcpПодключите его как пользовательский коннектор в любом ассистенте, который поддерживает удалённые MCP-серверы (Claude, ChatGPT, Cursor, VS Code и другие). Аутентификация не требуется. Например, в конфигурационном файле MCP:
{
"mcpServers": {
"criora": { "url": "https://criora.com/mcp" }
}
}Сервер предлагает семь инструментов. Каждый принимает широту и долготу либо название места: инструмент сам находит наиболее подходящее совпадение и сообщает, какое место выбрал.
| Инструмент | На какой вопрос отвечает |
|---|---|
assess_place | Всё о месте в одном ответе: риск по прогнозу на каждый день, угрозы поблизости, климатический профиль, страна |
get_forecast | Погода и погодный риск на семь дней, по местным суткам или по шагам прогноза |
get_climate_profile | Долгосрочная подверженность: наводнения, подъём уровня моря, жара, засуха, водный стресс и другие угрозы |
get_hazards_near | Лесные пожары, землетрясения, наводнения, циклоны, вулканы, засухи и качество воздуха рядом с местом |
get_country_profile | Оценки рисков страны и, по запросу, все индикаторы с их ориентирами для сравнения |
compare_countries | От двух до десяти стран в сравнении, с их местами в рейтинге |
find_place | Координаты по названию места, если название неоднозначно |
Кроме того, сервер предлагает три промпта, готовых вопроса, с которых ассистент может начать: assess_trip показывает, насколько рискована поездка в выбранные даты, compare_places_to_live сравнивает долгосрочные риски нескольких мест, а country_briefing сопоставляет страну с её регионом и остальным миром.
Для Вашего кода: JSON API
Все эндпоинты находятся по адресу https://criora.com/api/v1, отвечают на запросы GET и возвращают JSON.
| Эндпоинт | Что возвращает |
|---|---|
/place/forecast?lat=&lon= | Актуальный прогон прогноза в точке: все шаги и сводку по каждым местным суткам |
/place/climate?lat=&lon= | Все долгосрочные климатические слои в точке; параметр categories= сужает выборку (например, flooding) |
/place/report?lat=&lon= | Прогноз по дням, угрозы поблизости, климатический профиль и страну в одном ответе |
/geodata/live-events/nearby?lat=&lon= | Опасные события рядом с точкой; выборку сужают radius_km=, event_types= и since= |
/countries/risks | Общую оценку и оценки по измерениям для каждой страны |
/country/{ISO3}/summary | Оценки и классификацию одной страны |
/country/{ISO3}/risks | Индикаторы одной страны, каждый со своим мировым и региональным ориентиром |
/geocode/search?q= | Места, подходящие под название, по данным OpenStreetMap Nominatim |
Например, прогноз для Севильи:
curl "https://criora.com/api/v1/place/forecast?lat=37.39&lon=-5.99"Как читать риск в прогнозе
Каждый шаг прогноза содержит класс риска от 0 («Слабый») до 4 («Опасный»), угрозу, которая его определяет, и физическую величину, на которой он основан: ощущаемую температуру по индексу UTCI для жары и холода, скорость порывов для ветра, интенсивность осадков для дождя и снега. Дождь, снег и ветер имеют приоритет над температурой: по тому же правилу работает карта. Сводка каждого дня называет главный риск дня и перечисляет наивысший класс, которого в этот день достигает каждая угроза.
Ограничения
Поиск по названию места идёт через OpenStreetMap Nominatim, который разрешает один запрос в секунду на всю Criora вместе взятую, поэтому, если координаты известны, передавайте их.
Ответы с прогнозом меняются, когда публикуется новый прогон модели, то есть дважды в сутки. Климатические слои меняются, когда пересобирается набор данных. В ответах могут появляться новые поля; существующие поля сохраняют свой смысл.
Источники и атрибуция
Каждый ответ указывает свой источник. Публикуя или распространяя данные Criora, указывайте Criora и соблюдайте лицензию источника, названного в ответе: прогноз предоставляет Министерство окружающей среды и изменения климата Канады (ECCC) по лицензии Data Server End-use Licence, названия мест взяты из OpenStreetMap по лицензии ODbL, а у каждого климатического слоя указаны свой поставщик и своя лицензия. Полный список см. в разделе Источники данных. Использование API регулируется Условиями использования.
Criora публикует данные, а не рекомендации. Её цифры не заменяют профессиональную консультацию по финансовым и страховым вопросам или по вопросам безопасности.