ホテルの料金比較、賃貸市場の調査、旅行プランを立てるエージェント、物件のスクリーニング。どれも出発点は同じで、選んだ場所と日程の、価格付きの最新の掲載情報です。Lovely Router はこれを Booking.com、Airbnb、Tripadvisor、Zillow、Google Flights から JSON で返します。料金は返ったホテル、物件、スポット 1 件ごとに 1 つのプリペイド残高から支払い、ツールは自分のコードから呼び出すことも、MCP 経由で AI エージェントに呼び出させることもできます。
AI エージェントに任せる
このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。
Get hotel prices and review scores from Booking.com, Airbnb stays, Tripadvisor places, Zillow homes and Google Flights fares. 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 destinations, dates, budget and what to compare>仕組み
場所と日程を選ぶ
ホテルなら目的地、Airbnb なら日程入りの検索 URL、Tripadvisor なら都市、Zillow なら ZIP コード、航空券なら路線を指定します。
上限を付けてツールを実行する
入力を
max_resultsと一緒にPOST /v1/tools/{id}/runに送ります。実行は最大費用を仮押さえし、実際に返った結果の分で精算されます。比較して繰り返す
価格を収集日と一緒に保存し、定期的に再実行して、宿泊料金、家賃、運賃の推移を追います。
1 回のリクエストでホテルの料金を取得する
Booking.com のホテルは、指定した日程で目的地を検索し、各ホテルを宿泊料金付きで返します。次の実行は、リスボンで大人 2 名・5 泊のホテルを 20 件、ユーロ建ての料金で取得します。
curl https://lovelyrouter.com/v1/tools/booking-hotels/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"search": "Lisbon",
"checkin": "2026-11-09",
"checkout": "2026-11-14",
"adults": 2,
"currency": "EUR"
},
"max_results": 20
}'items の各ホテルには、名前、宿泊料金、レビュースコア、星の数、住所、無料キャンセルの可否が含まれます。checkin を空にすると、30 日後の 1 泊分の料金になります。60 秒を過ぎても実行中の場合は 202 が返ります。ポーリングの方法はツールを実行するをご覧ください。
ツール
目的地（と日程）で Booking.com のホテルを検索：名前、評価、料金、住所。
Booking.com ホテルの宿泊者レビュー：スコア、良かった点、悪かった点、旅行者タイプ、日付。
場所と日程で Airbnb の物件を検索：料金、評価、ホスト、設備。
指定した地域の Tripadvisor のホテル・レストラン・観光スポット。
検索 URL で Zillow の物件を取得：価格、寝室数、浴室数、住所、Zestimate。
ルートと日程を指定して Google フライトの便と運賃を取得：航空会社、時刻、乗継、所要時間、価格。
| ツール | 送るもの | 各結果の内容 |
|---|---|---|
booking-hotels | search、checkin、checkout、adults、currency | 名前、宿泊料金、レビュースコア、星の数、住所、無料キャンセル |
booking-reviews | ホテルの startUrls、sortReviewsBy、reviewScores | スコア、良かった点、良くなかった点、旅行者のタイプ、日付 |
airbnb-listings | urls：日程入りの Airbnb 検索 URL（地名でも可） | 宿泊全体と 1 泊あたりの料金、評価、レビュー、ホスト、設備・アメニティ、ハウスルール、写真 |
tripadvisor-places | query（場所またはキーワード）、includeHotels、includeRestaurants | その場所のホテル、レストラン、観光スポット |
zillow-listings | locations（ZIP コード）、operation（buy、rent、sold）、minPrice、maxPrice | 価格、寝室数、浴室数、居住面積、住所、Zestimate |
google-flights | searches：出発地、目的地、日付（IATA コード）、加えて adults、cabinClass、maxStops | 航空会社、時刻、経由回数、所要時間、価格 |
レシピ
毎朝、自社の都市と販売している日程で booking-hotels を実行し、競合ホテルの宿泊料金を追跡します。"sortReviewsBy": "f_recent_desc" を指定した booking-reviews を加えれば、競合の宿泊客が今月何を気に入り、何を不満に思っているかがわかります。
https://www.airbnb.com/s/Lisbon/homes?checkin=2026-11-09&checkout=2026-11-14&adults=2 で airbnb-listings を実行し、同じ日程の Booking.com のホテルと 1 泊あたりの料金や評価を比べます。
ZIP コード 78701 に対して、operation を buy、rent、sold に変えて zillow-listings を 3 回実行し、売り出し価格、直近の成約価格、居住面積あたりの家賃を比べます。各物件には Zestimate が付いています。
"searches": [{"origin": "LAX", "destination": "JFK", "departureDate": "2026-11-04", "returnDate": "2026-11-09"}] を指定した google-flights で航空券の価格を調べ、同じ日程のホテルを booking-hotels で、アクティビティを tripadvisor-places で探します。
"query": "Chicago" と "includeRestaurants": true を指定して tripadvisor-places を実行し、ホテル、レストラン、観光スポットを一覧にしてから、掲載するものについて Tripadvisor のレビューでレビューを取得します。
MCP サーバーに接続したエージェントなら、Claude Code や Cursor で 1 つのプロンプトから同じことができます。「11 月 4 日に LAX を出発して 11 月 9 日に戻る JFK 往復の航空券と、その日程で 1 泊 300 ドル以下のミッドタウンで評価の高いホテル 5 軒を探してください。どちらも表で示し、すべての実行に max_results を設定してください。」
料金
各ツールは結果単位、つまりホテル、物件、スポット、レビュー、航空券の検索 1 件ごとに課金され、呼び出し料金があるツールではそれも加わります。現在の価格は上のカードに表示されています。実行を開始すると最大費用（呼び出し料金 + 結果単価 × max_results）が仮押さえされ、実際に返った分で精算されます。失敗またはタイムアウトした実行は返した結果の分だけを支払い、開始時に拒否された実行は無料です。
サブスクリプションや最低契約期間はありません。$5 からチャージでき、エージェントやコードで結果を要約する場合のモデル呼び出しも同じ残高から支払えます。すべてのツールの料金は料金をご覧ください。
よくある質問
ホテルのデータには指定した日程の料金が含まれますか？+
はい。Booking.com をスクレイピングする booking-hotels ツールは、チェックイン日、チェックアウト日、大人の人数を受け取り、その宿泊の料金を返します。チェックイン日を指定しない場合は、30 日後の 1 泊分の料金になります。
ホテルの料金はどの通貨で取得できますか？+
booking-hotels ツールは、USD、EUR、GBP、JPY、CNY、AUD など 20 通貨のリストから通貨を指定できます。Google Flights は、価格の通貨として任意の 3 文字の通貨コードを受け付けます。
売り出し中の物件だけでなく、Zillow の賃貸物件や最近売れた物件も取得できますか？+
はい。operation を buy ではなく rent または sold に設定します。賃貸の場合、minPrice と maxPrice は週単位の金額です。
Airbnb で特定の日程を検索するには？+
/s/Lisbon/homes?checkin=…&checkout=…&adults=2 のように、日程と人数を含む Airbnb の検索 URL を渡します。地名だけでも検索できます。各物件は宿泊全体と 1 泊あたりの料金付きで返ります。
API でホテルや航空券を予約できますか？+
いいえ。これらのツールは公開されている掲載情報と価格を読み取るもので、予約は行いません。クリックやフォーム入力が必要な Web 上のタスクには、ブラウザエージェントをご覧ください。
米国以外の不動産データも利用できますか？+
Zillow のツールは米国の ZIP コードで検索します。それ以外の地域の宿泊については、Booking.com、Airbnb、Tripadvisor が地名で検索するため、これらのサイトで指定できる都市や地域であればどこでも使えます。
より多くのサイトの宿泊客レビューについてはレビューモニタリングを、これらのツールを Web 検索と組み合わせるエージェントについてはリサーチエージェントをご覧ください。