Подключить «Где бензин» к ИИ-агенту
Поиск заправок, наличия нужной марки топлива и цен через официальный API. Скилл помогает агенту найти подходящую АЗС и дать ссылку на её карточку на нашей карте.
Установить в Codex, Claude Code или Cursor
Запустите команду в папке своего проекта. Установщик предложит выбрать агента.
npx skills add tylnyi/Gde-Benzin-Skill --skill gde-benzinДля установщика нужен Node.js 22.20+, для работы клиента — Python 3.10+ и интернет. API-ключ и Python-пакеты не требуются.
Код GitHub-версии распространяется под MIT, отдельная сборка ClawHub — под MIT-0. Условия использования API действуют отдельно от лицензии кода.
Без Node.js распакуйте ZIP и перенесите папку gde-benzin целиком в каталог skills вашего агента. Инструкция, клиент и условия API находятся внутри.
Что спросить после подключения
- «Найди АЗС с АИ-95 в радиусе 5 км от координат 55.7539, 37.6208».
- «Где заправиться дизелем рядом с центром Твери? Дай ссылки на карту».
- «Проверь наличие и цены на АЗС с ID 41134».
Агент должен использовать указанные вами координаты или уточнить место. Центр города отличается от вашей геопозиции. Скилл работает после установки в агенте с доступом к Python и сети; он не подключает API автоматически ко всем обычным ИИ-чатам.
Поддерживаются АИ-92, АИ-95, АИ-98, АИ-100 и ДТ. Клиент не заменяет запрошенную марку другой. Наличие и цена проверяются отдельно; расстояние до АЗС считается по прямой.
Подключить API к своему приложению
Публичная база — https://gde-benzin.ru/api. Для чтения используйте HTTPS GET. Например, запрос заправок в прямоугольнике Москвы:
curl 'https://gde-benzin.ru/api/stations?bbox=55.72,37.58,55.78,37.67'Порядок координат: юг, запад, север, восток. Ответ содержит stations, count и признак truncated. Если выдача обрезана, уменьшите область поиска.
GET /geocode?text=Тверь— варианты места и координаты.GET /stations/{id}— карточка АЗС.GET /stations/{id}/recent?limit=3— последние отметки станции.
В fuels и prices данные разделены по маркам. Цена не подтверждает наличие; отсутствие актуальных сведений не означает, что бензин закончился.
Полный контракт, формат ответа клиента и обработка ошибок.
Не обходите ответы 429 и не запускайте массовую выгрузку страны. Для регулярной нагрузки большого приложения согласуйте подключение с автором.
Обязательные ссылки при использовании данных
При публичном показе данных API разместите две ссылки: Где бензин и Автор проекта — Дмитрий Тыльный.
На сайте или в приложении ссылки можно разместить рядом с данными либо в доступном разделе об интеграции. В ответе агента или бота достаточно одного общего блока источников. Ссылки на конкретные АЗС на нашей карте также сохраняются.
Клиент выводит обе ссылки в тексте и передаёт их в объекте attribution в JSON. Приложение должно показать их пользователю.