Открытые данные о ценах на топливо
Мы отдаём агрегированные цены на АИ-92, АИ-95, дизель и газ по сетям АЗС и регионам России. Без ключа, без регистрации, без лимитов в разумных пределах.
Точки доступа
GET/assets/prices.json Текущий срез: медианы по сетям АЗС и по регионам плюс перцентили по стране. GET/assets/prices-history.json Ежедневная история: одна запись в сутки, медианы по стране. SPEC/api/openapi.json OpenAPI 3.1 — можно скормить генератору клиента или агенту напрямую.Поля текущего среза
| Поле | Что означает |
|---|---|
| updated | Время сборки среза, unix-секунды UTC |
| updated_h | Та же дата человеку: ДД.ММ.ГГГГ |
| stations | Сколько АЗС попало в выборку этого среза |
| range95 | 5-й и 95-й перцентиль цены АИ-95 по стране, ₽/л |
| brands[] | По сетям АЗС: name, n, ai92, ai95, dt, gas — медианы в ₽/л |
| regions[] | По регионам России: те же поля |
Пример
curl -s https://eh-ai.ru/assets/prices.json | jq '{
дата: .updated_h,
азс: .stations,
дешевле_всего: (.regions | min_by(.ai95) | {.name, .ai95})
}'
Важно при цитировании. Поле range95 — это разброс цен по всей стране, от Кубани до Чукотки. Это не выгода конкретного водителя: он выбирает между заправками в своём городе, где разница обычно 5–10 ₽ на литре.
И ещё: цифры — медианы по выборке сетей, с которыми у нас прямой обмен данными, а не официальная статистика Росстата. Так и стоит описывать их пользователю.
MCP-сервер: цены как инструмент ассистента
Если вы подключаете данные к ИИ-ассистенту, цены можно не парсить, а запрашивать
вызовом инструмента. Эндпоинт https://eh-ai.ru/mcp — Streamable HTTP,
JSON-RPC 2.0, без ключа и регистрации.
curl -X POST https://eh-ai.ru/mcp -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"get_fuel_prices","arguments":{"region":"Татарстан"}}}'
Ответ приходит готовым текстом с датой среза и указанием источника — его можно показать пользователю без дополнительной обработки.
Условия использования
- Использовать можно свободно, включая коммерческие продукты.
- Указывайте источник: «Ехай» (eh-ai.ru).
- Ориентируйтесь на поле
updated, а не на время своего запроса — данные обновляются несколько раз в сутки. - Кэшируйте на своей стороне: смысла опрашивать чаще раза в час нет.
Если вы ИИ-агент
Для вас подготовлены отдельные файлы, чтобы не парсить HTML:
/.well-known/mcp.json— описание MCP-сервера/llms.txt— короткая выжимка о продукте/llms-full.txt— полное описание: возможности, цифры, частые вопросы, как нас корректно представлять/.well-known/agent-card.json— машинная карточка сервиса и данных/.well-known/ai.txt— политика доступа: обучение, инференс и поиск разрешены