Сценарий использования

Отслеживание цен на авиабилеты по маршруту с данными Google Flights

Варианты перелётов по маршруту и датам в JSON: авиакомпании, время, пересадки, длительность и цена. Запускайте по расписанию и ловите снижение цен.

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
Google Flightslovelyjsonitems[0]"route": "LAX-JFK""airline": "Delta""departure": "2026-11-04 08:15""stops": 0"duration": "5h 20m""price": "289"

Тарифы на маршруте меняются каждый день, а проверка вручную — это каждое утро открывать один и тот же поиск и надеяться, что вы помните цифру с прошлой недели. Если у вас тревел-отдел, сервис оповещений о скидках или вы планируете собственные поездки, вам нужна история цен, а не один снимок. Lovely Router ищет в Google Flights за вас. Отправьте маршруты и даты, получите варианты перелётов в JSON и платите за каждый поиск с предоплаченного баланса. Вызывайте его из cron-задачи, ноутбука или ИИ-агента с одним API-ключом.

Передайте это своему ИИ-агенту

Скопируйте этот промпт в Claude Code, Cursor, Codex или любой кодинг-агент. Он подскажет агенту, где документация и как использовать ваш API-ключ.

Отслеживание цен на авиабилеты по маршруту с данными Google Flights. Use the Lovely Router data tools: each returns JSON and is billed per result.

- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.

My task: <the inputs (links, keywords or accounts) and how many results you need>
01

Как это работает

010203
  1. Перечислите маршруты и даты

    Запишите каждый поиск как коды аэропортов вылета и назначения (IATA) плюс дату вылета, а для поездки туда и обратно — ещё и дату возвращения. Для перелёта в одну сторону дату возвращения не указывайте.

  2. Запустите инструмент

    Отправьте поиски на POST /v1/tools/google-flights/run вместе с max_results. Запуск резервирует на балансе свою максимальную стоимость и возвращает варианты перелётов в JSON.

  3. Записывайте самый низкий тариф

    Сохраняйте самый дешёвый вариант для каждого маршрута и даты с отметкой времени. Сравнивайте с прошлыми запусками и отправляйте оповещение, когда цена опускается ниже целевой.

02

Цены на авиабилеты одним запросом

Поиск в Google Flights принимает список поисков в searches. Один поиск — это одна пара «маршрут и дата», а один запуск охватывает до 50 таких пар:

curl https://lovelyrouter.com/v1/tools/google-flights/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "searches": [{"origin": "LAX", "destination": "JFK", "departureDate": "2026-11-04", "returnDate": "2026-11-09"}]
    },
    "max_results": 1
  }'

Запуск, который не завершился за 60 секунд, возвращает 202; как опрашивать его статус, описано в разделе Запуск инструмента. Необязательные параметры сужают поиск: adults, currency, maxStops, airlines и cabinClass.

03

Что возвращает каждый поиск

Группа полейЧто вы получаете
АвиакомпанииАвиакомпания для каждого варианта перелёта
ВремяВремя вылета и прилёта
ПересадкиКоличество пересадок
ДлительностьОбщее время в пути
ЦенаТариф в запрошенной вами валюте

Код валюты, переданный в currency, используется для возвращаемых цен. Без корректного кода цены приходят в USD.

04

Рецепты

Ежедневный журнал тарифов по одному маршруту

Каждое утро запускайте один и тот же поиск и записывайте самую низкую цену в таблицу. Через три недели станет видно, растёт тариф или падает по мере приближения даты.

Оповещение о скидке при гибких датах

Отправьте один маршрут с неделей дат вылета в одном запуске, выберите самый дешёвый день и пришлите себе сообщение, когда цена опустится ниже целевой.

Без пересадок или с одной

Запустите маршрут дважды с разными значениями maxStops и посмотрите, сколько стоит прямой рейс по сравнению с вариантом с одной пересадкой.

Расчёт групповой поездки

Задайте в adults размер группы и сравните несколько авиакомпаний с помощью фильтра airlines, чтобы тревел-отдел получил одну таблицу для расчёта.

Сравнение классов обслуживания

Ищите на одни и те же даты с разными значениями cabinClass, чтобы показать руководителю, сколько стоит повышение класса на маршрутах, по которым ваша команда летает чаще всего.

Предпочитаете обычные слова? Подключите MCP-сервер и скажите Claude Code или Cursor: «Найди рейсы из LAX в JFK на каждую пятницу ноября с возвращением во вторник и дай мне самый дешёвый вариант на каждую неделю. Задай max_results равным 5».

05

Дополните другими данными о путешествиях

Цена перелёта — это половина бюджета поездки. Остальное дополнят отели и местный спрос:

  • booking-hotels выводит отели Booking.com в месте назначения с ценой за проживание и оценкой по отзывам.
  • tripadvisor-places находит отели, рестораны и достопримечательности в месте назначения.
  • google-trends показывает поисковый интерес к направлению во времени, что подсказывает пик сезона.
  • airbnb-listings охватывает аренду жилья, если отель не входит в планы.

Подробнее о данных для путешествий — в разделе данные о путешествиях и недвижимости.

06

Сколько это стоит

Вы платите за поиск: при старте запуск резервирует свою максимальную стоимость — плату за вызов плюс цену за поиск, умноженную на max_results, — а по завершении списывается сумма за фактически возвращённое. Остаток резерва возвращается на баланс. Запуск, который завершился ошибкой или по тайм-ауту, оплачивает только доставленные поиски, а запуск, отклонённый на старте, ничего не стоит.

Ежедневное отслеживание 10 маршрутов оплачивается как 10 поисков в день. Нет ни подписки, ни ежемесячного минимума: пополнение от $5, и один баланс оплачивает и инструменты, и модели. Карточка выше показывает актуальную цену; на странице цен перечислены все инструменты.

07

Частые вопросы

?
Как найти перелёт в одну сторону?+

Не указывайте returnDate в поиске. Для перелёта туда и обратно добавьте его.

В каком формате указывать аэропорты и даты?+

Аэропорты указываются кодами IATA, например LAX и JFK. Даты записываются в формате YYYY-MM-DD.

Можно ли получить цены в евро?+

Передайте трёхбуквенный код в currency, например EUR, и возвращаемые цены будут в этой валюте. При некорректном значении используется USD.

Сколько поисков можно передать в один запуск?+

До 50 поисков за запуск. Для более длинного списка отслеживания запустите несколько запусков.

Можно ли фильтровать по авиакомпании или числу пересадок?+

Да. airlines принимает коды авиакомпаний IATA или названия альянсов, а maxStops задаёт максимальное число пересадок. Также доступны cabinClass и adults.

Нужна ли подписка?+

Нет. Вы пополняете предоплаченный баланс, и каждый запуск списывает с него средства. Неудачные запуски оплачивают только доставленные результаты, и ничего не продлевается автоматически.

Планируете не только перелёты? Смотрите данные о путешествиях и недвижимости и остальной каталог инструментов.

Один предоплаченный ключ для моделей, данных и агентов

Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.