同じ日程で似た物件がいくらで出ているかを知らずに 1 泊の料金を決めるのは、勘に頼ることです。勘で決めると、取りこぼしや空室が生まれます。比較対象は Airbnb にありますが、見られるのは検索ページ 1 つずつです。Lovely Router が代わりに読み取ります。日程入りの検索リンクを送るとリスティング 1 件ごとに 1 つの JSON オブジェクトが返り、プリペイド残高からリスティング 1 件ごとに課金されます。スクリプト、料金設定用のシート、AI エージェントのどこからでも、1 つの API キーで呼び出せます。
AI エージェントに任せる
このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。
Airbnb の類似物件を日程ごとに調べて民泊の料金を決める. 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>仕組み
検索リンクを作る
Airbnb で、チェックイン、チェックアウト、人数を指定してエリアを検索し、そのリンクをコピーします。
上限を付けてツールを実行する
入力の
limitPerUrlとリクエストのmax_resultsを付けて、リンクをPOST /v1/tools/airbnb-listings/runに送ります。実行は最大費用を残高から仮押さえし、リスティングを JSON で返します。料金を決める
1 泊料金を評価、レビュー数、設備と比べ、最も近い類似物件の中で自分の物件を位置づけます。
1 回のリクエストで日程ごとの類似物件を取得する
Airbnb の物件を検索するは、日程を含む検索リンクを urls に受け取ります。limitPerUrl でリンクごとの取得件数を制限でき、1 回の実行で 10 件から 100 件までです。
curl https://lovelyrouter.com/v1/tools/airbnb-listings/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"urls": [
"https://www.airbnb.com/s/Lisbon/homes?checkin=2026-11-09&checkout=2026-11-14&adults=2"
],
"limitPerUrl": 10
},
"max_results": 10
}'リンクの代わりに地名を指定することもできます。60 秒を過ぎても実行中の場合は 202 が返ります。ポーリングの方法はツールを実行するをご覧ください。
リスティングごとの内容
| 項目グループ | 取得できる内容 |
|---|---|
| 価格 | 滞在全体の価格と 1 泊あたりの価格 |
| 品質 | 評価とレビュー数 |
| ホスト | リスティングのホスト |
| 提供内容 | 設備とハウスルール |
| コンテンツ | 写真 |
価格は検索リンクに含まれる日程によって変わります。平日、週末、イベント時の違いを見るには、日程を変えてください。
レシピ
同じエリアを、金曜から日曜の滞在と月曜から水曜の滞在で実行し、1 泊料金の中央値を比べます。
カンファレンスやお祭りがある週と通常の週で同じ都市を実行し、類似物件がどれだけ値上げしているかを確認します。
評価とレビュー数が近いリスティングに絞り、高価格帯の物件にあって自分の物件にない設備を確認します。
物件を管理しているなら、エリアごとに実行をスケジュールし、類似物件の価格帯と推奨料金をオーナーに送ります。
モデルに、結果全体のハウスルールと設備を要約させ、自分の価格帯でゲストが受け入れているルールを把握します。
普段の言葉で頼みたい場合は、MCP サーバーを接続して Claude Code や Cursor に次のように伝えます。「2026-11-09 から 2026-11-14 まで、2 名で、リスボンの Airbnb の物件を 30 件取得してください。1 泊料金の中央値と、評価の高い上位 5 件を設備つきで出してください。max_results は 30 に設定してください。」
ほかの旅行ソースと組み合わせる
Airbnb に出ているのは民泊の料金です。ホテルやレビューを見ると、ゲストが比較している代替案がわかります。
場所と日程で Airbnb の物件を検索：料金、評価、ホスト、設備。
目的地（と日程）で Booking.com のホテルを検索：名前、評価、料金、住所。
指定した地域の Tripadvisor のホテル・レストラン・観光スポット。
ルートと日程を指定して Google フライトの便と運賃を取得：航空会社、時刻、乗継、所要時間、価格。
検索 URL で Zillow の物件を取得：価格、寝室数、浴室数、住所、Zestimate。
booking-hotelsは、目的地と日程でホテルを一覧にするので、ホテル料金と比べられます。tripadvisor-placesは、場所ごとにホテル、レストラン、観光地を一覧にします。google-flightsは、自分の都市への航空券価格を示し、その日程の需要を測る目安になります。zillow-listingsは、物件の購入を検討するときに、米国の不動産情報を加えます。
旅行や不動産のデータについては、旅行・不動産データもご覧ください。
料金
料金はリスティング 1 件ごとにかかります。実行を開始すると最大費用（呼び出し料金 + リスティング単価 × max_results）が仮押さえされ、実際に返った分で精算されて、仮押さえの残りは残高に戻ります。失敗またはタイムアウトした実行は返したリスティングの分だけを支払い、開始時に拒否された実行は無料です。
100 件のリスティングを取得すると、1 つのリンクでも複数のリンクでも 100 件分として課金されます。サブスクリプションや月額の最低利用料はなく、$5 からチャージでき、1 つの残高でツールとモデルの両方を支払えます。現在の価格は上のカードに表示されており、料金ではすべてのツールを一覧できます。
よくある質問
価格は自分の日程に合っていますか？+
価格は検索リンクに含まれる日程から取得されるため、知りたいチェックインとチェックアウトの日付を指定してください。地名だけでも動作しますが、日程入りのリンクなら、その滞在の価格が得られます。
1 泊の価格と滞在全体の価格の両方がわかりますか？+
はい、両方わかります。
最小の実行はどれくらいですか？+
limitPerUrl は 10 から始まるため、1 つのリンクにつき最低 10 件のリスティングが返ります。
1 回の実行で何件のリスティングを返せますか？+
1 回の実行で最大 100 件です。
1 回の実行で複数のエリアを読み取れますか？+
はい。urls に複数の検索リンクを渡してください。limitPerUrl は各リンクから取得する件数を制限します。
サブスクリプションは必要ですか？+
いいえ。プリペイド残高にクレジットを追加し、実行ごとに残高から差し引かれます。失敗した実行は返した結果の分だけを支払い、自動で更新されるものは何もありません。