同じ路線でも運賃は毎日動きます。手作業で確認するなら、毎朝同じ検索を開いて先週の数字を思い出すしかありません。出張手配、お得情報のアラート、自分の旅行計画のいずれであっても、必要なのは一時点の価格ではなく価格の履歴です。Lovely Router が Google フライトの検索を代行します。路線と日付を送るとフライト候補が JSON で返り、料金はプリペイド残高から検索 1 回ごとに差し引かれます。cron ジョブでもノートブックでも AI エージェントでも、1 つの API キーで呼び出せます。
AI エージェントに任せる
このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。
Google フライトのデータで路線の航空券価格を追跡する. 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>仕組み
路線と日付をリストにする
検索ごとに、出発地と到着地の空港コード（IATA）と出発日を書きます。往復の場合は復路の日付も加えます。片道なら復路の日付は省きます。
ツールを実行する
検索を
max_resultsと一緒にPOST /v1/tools/google-flights/runに送ります。実行は最大費用を残高から仮押さえし、フライト候補を JSON で返します。最安値を記録する
路線と日付ごとに最安の候補をタイムスタンプ付きで保存します。過去の実行と比べ、価格が目標を下回ったらアラートを出します。
1 回のリクエストでフライト価格を取得する
Google フライトを検索するツールは、searches に検索のリストを受け取ります。1 件の検索は路線と日付の 1 組で、1 回の実行で最大 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 です。
各検索の返却内容
| フィールド群 | 取得できるもの |
|---|---|
| Airlines | 各フライト候補の航空会社 |
| Times | 出発時刻と到着時刻 |
| Stops | 乗り継ぎの回数 |
| Duration | 合計の所要時間 |
| Price | 指定した通貨での運賃 |
currency に渡した通貨コードが、返される価格に使われます。有効なコードを渡さない場合、価格は USD で返ります。
レシピ
毎朝同じ検索を実行し、最安値をスプレッドシートに書き込みます。3 週間たてば、出発日が近づくにつれて運賃が上がるのか下がるのかが見えてきます。
同じ路線を 1 週間分の出発日にして 1 回の実行で送り、最も安い日を選んで、目標を下回ったら自分に通知します。
maxStops を変えて同じ路線を 2 回実行し、直行便が乗り継ぎ便よりいくら高いかを確認します。
adults を人数に設定し、airlines フィルターでいくつかの航空会社を比べて、出張手配の担当者が見積もり用に 1 つの表を得られるようにします。
同じ日付で cabinClass の値を変えて検索し、チームがよく使う路線でアップグレードにいくらかかるかを上司に示します。
普段の言葉で頼みたい場合は、MCP サーバーを接続して Claude Code や Cursor に次のように伝えます。「11 月の毎週金曜日に LAX から JFK へ出発し、火曜日に戻る便を検索して、週ごとの最安の候補を教えてください。max_results は 5 に設定してください。」
他の旅行データと組み合わせる
航空券の価格は旅行予算の半分にすぎません。残りはホテルと現地の需要が埋めます。
ルートと日程を指定して Google フライトの便と運賃を取得：航空会社、時刻、乗継、所要時間、価格。
目的地（と日程）で Booking.com のホテルを検索：名前、評価、料金、住所。
指定した地域の Tripadvisor のホテル・レストラン・観光スポット。
キーワードの Google トレンド関心度（時系列・地域別）。
場所と日程で Airbnb の物件を検索：料金、評価、ホスト、設備。
booking-hotelsは、目的地の Booking.com のホテルを、宿泊期間の価格とレビュースコアとともに一覧します。tripadvisor-placesは、目的地のホテル、レストラン、観光スポットを探します。google-trendsは、目的地への検索関心の推移を示し、ハイシーズンの目安になります。airbnb-listingsは、ホテルではなく民泊を考えている場合に役立ちます。
旅行データについては、旅行・不動産データもご覧ください。
料金
料金は検索 1 回ごとにかかります。実行を開始すると最大費用（呼び出し料金 + 検索 1 回あたりの単価 × max_results）が仮押さえされ、実際に返った分で精算されて、仮押さえの残りは残高に戻ります。失敗またはタイムアウトした実行は返した検索の分だけを支払い、開始時に拒否された実行は無料です。
10 路線を毎日追跡すると、1 日あたり検索 10 回分として課金されます。サブスクリプションや月額の最低利用料はなく、$5 からチャージでき、1 つの残高でツールとモデルの両方を支払えます。現在の価格は上のカードに表示されており、料金ではすべてのツールを一覧できます。
よくある質問
片道のフライトはどう検索しますか？+
検索から returnDate を省きます。往復の場合は含めてください。
空港と日付はどの形式で指定しますか？+
空港は LAX や JFK のような IATA コードです。日付は YYYY-MM-DD の形式で書きます。
ユーロでの価格を取得できますか？+
currency に EUR のような 3 文字のコードを渡すと、返される価格にその通貨が使われます。形式が正しくない値の場合は USD になります。
1 回の実行で何件の検索を扱えますか？+
1 回の実行で最大 50 件です。ウォッチリストがそれより多い場合は、複数の実行を開始してください。
航空会社や乗り継ぎ回数で絞り込めますか？+
はい。airlines は航空会社の IATA コードまたはアライアンス名を受け取り、maxStops は乗り継ぎ回数の上限を設定します。cabinClass と adults も使えます。
サブスクリプションは必要ですか？+
いいえ。プリペイド残高にクレジットを追加し、実行ごとに残高から差し引かれます。失敗した実行は返した結果の分だけを支払い、自動で更新されるものは何もありません。