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

Сравните цены отелей в направлении, прежде чем назначать свои

Отели Booking.com для любого направления и дат в JSON: цена за проживание, оценка по отзывам, звёзды и бесплатная отмена — для сравнения цен за ночь.

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
Booking.comlovelyjsonitems[0]"name": "Hotel Alfama Vista""price": "412""currency": "USD""review_score": 8.7"stars": 4"free_cancellation": true

Чтобы назначить свою цену, нужно знать, сколько берут отели вокруг вас на те же даты и что гость получает за эти деньги: оценку по отзывам, звёздность, возможность бесплатной отмены. Искать это вручную на сайте бронирования — значит делать один поиск, одну прокрутку и одну строку таблицы за раз. Lovely Router выполняет поиск за вас. Отправьте направление и даты, получите по одному JSON-объекту на отель и платите за каждый отель с предоплаченного баланса.

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

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

Сравните цены отелей в направлении, прежде чем назначать свои. 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. Выберите направление и даты

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

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

    Отправьте поиск на POST /v1/tools/booking-hotels/run. Задайте maxItems во входных данных и max_results в теле запроса равными нужному числу отелей. Запуск резервирует на балансе свою максимальную стоимость и возвращает отели в JSON.

  3. Сравните со своей ценой

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

02

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

Поиск отелей на Booking.com принимает направление в search. Необязательные поля — checkin, checkout, adults и currency; maxItems ограничивает число отелей:

curl https://lovelyrouter.com/v1/tools/booking-hotels/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "search": "Lisbon",
      "maxItems": 10,
      "currency": "USD"
    },
    "max_results": 10
  }'

Запуск, который не завершился за 60 секунд, возвращает 202; как опрашивать его статус, описано в разделе Запуск инструмента. Без дат поиск идёт на одну ночь через 30 дней от сегодняшнего дня. Чтобы узнать цену конкретного проживания, передайте checkin и checkout в формате YYYY-MM-DD. Один запуск может вернуть до 100 отелей.

03

Что содержит каждый отель

Группа полейЧто вы получаете
ИдентификацияНазвание и адрес отеля
ЦенаЦена за проживание в выбранной вами валюте
КачествоОценка по отзывам и звёздность
УсловияВозможна ли бесплатная отмена
04

Рецепты

Цена на выходные

Запустите поиск по направлению на ближайшие пятницу–воскресенье, оставьте отели с похожими на ваши звёздностью и оценкой по отзывам и ориентируйтесь на их медиану.

Наблюдение за датой высокого спроса

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

Наценка за бесплатную отмену

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

Оценка нового рынка

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

Расчёт поездки для клиентов

Турагентство может запустить три направления на одни и те же даты и показать клиентам таблицу «цена против оценки по отзывам».

Предпочитаете обычные слова? Подключите MCP-сервер и скажите Claude Code или Cursor: «Найди отели Booking.com в Лиссабоне на 12–15 марта для 2 взрослых в EUR и покажи цену, оценку по отзывам и звёзды, отсортировав по цене. Задай max_results равным 50».

05

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

Цены отелей понятнее рядом с тем, что говорят гости, и с тем, что ещё продаётся в том же городе:

  • booking-reviews читает, что гости пишут об отелях, с которыми вы сравнивались.
  • tripadvisor-places добавляет второй взгляд на отели и на то, что ещё есть поблизости.
  • airbnb-listings показывает альтернативу в виде краткосрочной аренды на те же даты.
  • google-flights показывает, сколько стоит добраться до места, а это влияет на спрос.

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

06

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

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

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

07

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

?
Как узнать цену конкретного проживания?+

Передайте checkin и checkout в формате YYYY-MM-DD. Если оставить их пустыми, поиск идёт на одну ночь через 30 дней от сегодняшнего дня.

Какие валюты можно использовать?+

currency принимает USD, EUR, GBP, AUD, CAD, CHF, CNY, JPY, INR, BRL, MXN, SEK, NOK, DKK, PLN, AED, SGD, ZAR, TRY и RUB. По умолчанию — USD.

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

До 100 за запуск. Лимит во входных данных задаёт maxItems.

Можно ли указать число гостей?+

Да. adults задаёт число взрослых гостей, по умолчанию — 2.

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

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

Оцениваете направление? Смотрите данные о путешествиях и недвижимости, аналитику электронной коммерции — тот же метод для товаров — и каталог инструментов.

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

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