HasData Google Flights

Google Flights MCP Server

Claude、Cursor、Windsurf、その他あらゆる MCP クライアントに Google Flights ツールを提供する、ホスト型の Model Context Protocol（MCP）サーバーです。Google アカウントも、廃止された旅行 API への対応も不要で、片道、往復、複数都市の旅程を、運賃、フライト区間、二酸化炭素排出量、価格履歴とともに、構造化 JSON として検索できます。

毎月1,000クレジットを無料で利用でき、カード登録も不要です。フライト検索約66回分に相当します。

https://mcp.hasdata.com/mcp?apis=google_travel_flights

• プロンプトとリソース

目次

• 必要なもの
• クイックスタート
• プロンプトの例
• ツール
• エラーと失敗時の処理
• 料金、無料プラン、制限
• ツールの選択
• 比較
• FAQ
• HasData のリンク
• 開発
• コントリビューション
• ライセンス

必要なもの

MCP クライアントと、ダッシュボードで取得できる HasData API キーが必要です。カード登録なしで無料で作成でき、無料プランでは1回15クレジットで月約66回呼び出せます。これはリモートサーバーなので、最も簡単な方法は URL と x-api-key ヘッダーを使うことです。コンテナーを実行する必要はなく、処理のどこでも Google アカウントは不要です。stdio のみを使用するクライアントからは、以下に示す薄いランチャーを介して接続できます。このランチャーは npm では @hasdata/google-flights-mcp、PyPI では hasdata-google-flights-mcp として公開されています。

クイックスタート

サーバー URL はすべてのクライアントで同じです。Claude Code と Claude Desktop で実際に動作を確認しています。その他のブロックは、各クライアントのリモートサーバー向けドキュメントに記載された形式に従っています。

OAuth に対応しているクライアントでは、同じ URL をコネクターとして追加し、設定ファイルにキーを記述せずにサインインできます。

claude mcp add --transport http google-flights "https://mcp.hasdata.com/mcp?apis=google_travel_flights" \
  --header "x-api-key: HASDATA_API_KEY"

{
  "mcpServers": {
    "google-flights": {
      "command": "npx",
      "args": ["-y", "@hasdata/google-flights-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "google-flights": {
      "command": "uvx",
      "args": ["hasdata-google-flights-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "google-flights": {
      "url": "https://mcp.hasdata.com/mcp?apis=google_travel_flights",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "google-flights": {
      "serverUrl": "https://mcp.hasdata.com/mcp?apis=google_travel_flights",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "servers": {
    "google-flights": {
      "type": "http",
      "url": "https://mcp.hasdata.com/mcp?apis=google_travel_flights",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

プロンプトの例

コードではなく、プロンプトです。いずれかを貼り付けると、エージェントが自分でツールを選びます。成功した呼び出しは毎回 15 クレジットを消費するため、各例には必要な呼び出し回数を記載しています。

9 月 15 日の JFK 発ロンドン・ヒースロー行き片道便を、価格の安い順に調べて、最安の 3 便を航空会社と二酸化炭素排出量の推定値とともに教えてください。

1 回の呼び出しで 15 クレジットです。運賃、区間、排出量がまとめて返されます。

同じ路線で、ビジネスクラスの直行便のみを対象にして、排出量が最も少ない便を教えてください。

1 回の呼び出しで 15 クレジットです。客室クラスと経由地の条件は、1 回のリクエストで指定するフィルターです。

価格履歴を踏まえると、現在の JFK から LHR への 295 ドルは妥当な価格ですか？

1 回の呼び出しで 15 クレジットです。レスポンスには、一般的な価格帯と価格水準を示す priceInsights が含まれます。

JFK から LHR への往復便で、9 月 15 日に出発し、9 月 22 日に戻る最安の運賃を教えてください。

2 回の呼び出しで 30 クレジットです。Google はまず往路の候補を返し、選んだ候補をキーにして復路を 2 回目の呼び出しで取得します。

往復便は仕様上、2 回の呼び出しが必要です。最初の呼び出しでは departureToken を持つ往路の旅程が返され、そのトークンを渡すと対応する復路の便を取得できます。片道便の検索と価格の確認は、それぞれ 1 回の呼び出しで完了します。

ツール

読み取り専用のツールが 1 つあります。以下のサンプルは実際の呼び出しから抜粋したもので、運賃は常に変動します。データの形式を示すものとしてご覧ください。ツール名にはエンドポイントリファレンスへのリンクがあり、すべてのパラメーターが記載されています。

サンプルはペイロードであり、レスポンス全体ではありません。tools/call の結果には 1 つのテキストブロックが含まれ、そのテキスト自体は url、status、text、json を持つ JSON で、スクレイピングされたデータは json の下にあります。生の JSON-RPC レスポンスの場合、データのパスは result.content[0].text で、これを解析してから .json を参照します。チャットクライアントはこのデータを展開しますが、エンドポイントに直接アクセスするコードでは自分で展開する必要があります。

Google Flights の検索結果を取得

hasdata_google_travel_flights_getGoogleFlights

指定したルートと日付の旅程情報です。運賃、各区間、排出量、価格履歴を含みます。

リファレンスには、includeConnections、excludeConnections、layoverDuration、outboundTimes、returnTimes、showHidden、lessEmissions、multiCityJson についても記載されています。

検索結果は bestFlights と otherFlights に分かれています。各旅程には、price、type、分単位の totalDuration、各区間を含む flights 配列、carbonEmissions オブジェクト、bookingToken が含まれます。各区間には、departureAirport と arrivalAirport（それぞれ id、name、現地時間の time を含む）、duration、airline、flightNumber、airplane、legroom、travelClass、extensions 配列のほか、Google が該当する区間に付与する oftenDelayedByOver30Min が含まれます。直行便の旅程は区間が 1 つで、乗り継ぎ便の旅程は複数の区間で構成されます。

carbonEmissions の単位はグラムであり、キログラムではありません。thisFlight: 433000 は 433 kg です。differencePercent は typicalForThisRoute と比較した値で、負の数は平均より環境負荷の低い便を示します。

{
  "price": 295,
  "type": "One way",
  "totalDuration": 415,
  "flights": [
    {
      "departureAirport": { "id": "JFK", "name": "John F. Kennedy International Airport", "time": "2026-09-15 8:15" },
      "arrivalAirport": { "id": "LHR", "name": "Heathrow Airport", "time": "2026-09-15 20:10" },
      "duration": 415,
      "airline": "Virgin Atlantic",
      "flightNumber": "VS 26",
      "airplane": "Boeing 787",
      "travelClass": "Economy"
    }
  ],
  "carbonEmissions": { "thisFlight": 367000, "typicalForThisRoute": 419000, "differencePercent": -12 },
  "bookingToken": "W1t7..."
}

旅程と並んで priceInsights があり、lowestPrice、typicalPriceRange、typical などの priceLevel、および [timestamp, price] のデータポイントからなる priceHistory が含まれます。airports には、解決された出発空港と到着空港が都市名および国名とともに返されます。

プロンプトとリソース

サーバーには、クライアントがユーザーにツール呼び出しを組み立ててもらう代わりに提示できる、すぐに使えるワークフローとして、1 つのプロンプトが用意されています。

また、サーバーは 7 つのリソースを公開しており、それぞれ、受け付ける値が固定リストになっているパラメーターに対応しています。拒否された呼び出しから値の種類を学ぶよりも、リソースを読み取るほうが低コストで、クレジットも消費しません。各 URI は hasdata://google_travel_flights/<parameter> です。

どちらのリストも API キーなしで提供されるため、クライアントはユーザーが登録する前に読み取ることができます。

エラーと失敗時の動作

ツール呼び出しから HTTP エラーコードがクライアントに返されることはほとんどありません。MCP レイヤーは 200 を返し、失敗の内容を結果に含め、isError を true に設定して、理由をテキストで示します。ステータス行が表示されると思われる場面で、エージェントにはメッセージが返されます。

キーが間違っていても、接続エラーではなくツールの出力として通知されます。 tools/list は空でないキーなら何でも受け付け、ツールを返すため、クライアントはハンドシェイクを完了し、正常を示す緑色の表示になります。その後、最初のツール呼び出しで isError: true とテキスト HasData API error: 401 Unauthorized が返されます。フローのそれ以前の段階では問題が報告されないため、この文字列に注意してください。

キーがない場合に限り、実際の HTTP エラーが発生します。 認証はどのツールよりも先に実行され、接続自体が 401 で失敗します。CORS ヘッダーが含まれているため、ブラウザーのクライアントは、不透明なネットワークエラーではなくステータスを読み取れます。

ツールのスキーマに適合しない引数は、スクレイピングが実行される前に拒否されます。 サーバーは isError: true とテキスト MCP error -32602: Input validation error を返し、問題のあるフィールドを示します。returnDate を指定しない roundTrip や、includeAirlines と excludeAirlines を同時に指定した場合は、ここで検出されます。

指定日にその経路のフライトがない場合は、エラーではなく、旅程配列が空の正常な結果が返されます。 requestMetadata.status は引き続き ok です。順位付けする前に、フライトがあるか確認してください。

空港コードが不正な場合は 400 が返され、 requestMetadata.status は error に設定されます。都市名ではなく、IATA コードまたは kgmid を使用してください。

データを含む結果には、サポートに問い合わせる際に伝えると役立つ requestMetadata.id も含まれています。

料金、無料枠、上限

Google Flights の呼び出しは、成功するたびに 15 クレジットかかります。レスポンスのサイズによって料金は変わらず、ディープ検索も標準検索と同じ料金です。

無料枠は毎月 1,000 クレジット、カード登録不要で、約 66 回のフライト検索ができます。請求サイクルごとに更新されるため、利用量の少ないエージェントなら無料枠のまま使い続けられます。

有料プランは、200,000 クレジットで月額 $59から利用でき、約 13,000 回検索できます。利用量が増えるほど単価は下がり、エントリープランでは1,000 回の呼び出しあたり $4.42、Basic では**$1.79**、Growth ティアでは**$1.25**です。最新の料金は料金ページをご確認ください。

プランによって同時実行数も決まります。無料枠では一度に 1 件、Startup では 5 件、Basic では 15 件、Growth ティアでは 50～500 件を実行できます。無人で実行するものには、超過時のケースを想定した防御処理を入れてください。

200 以外のステータスコードで返されたリクエストには課金されません。往復検索は 2 回の呼び出しになるため、その分のクレジットを見込んでください。

ツールの選択

apis クエリパラメーターで、エージェントに表示するツールを指定します。ツールを絞ると、ツール定義に使うコンテキストが少なくなり、モデルが誤ったツールを選ぶ可能性も減ります。

?apis=google_travel_flights          the one tool in this repo
?apis=google_travel                   add Google Hotels
?apis=google_travel_flights,airbnb    flights plus Airbnb stays

このパラメーターには、google_travel のようなプロバイダー名と、google_travel_flights のような個別の API 名を指定できます。スペルミスのある名前は無視されます。すべての名前が無効な場合、リクエストは 400 で失敗し、認識されなかった名前と有効な値の一覧が本文に記載されます。パラメーターを省略すると、同じエンドポイントですべての 57 個の HasData ツールが公開されます。

比較

Google は 2018 年に QPX Express フライト API を廃止しましたが、後継の API は提供していません。そのため、公式の Google Flights API は存在しません。残る方法は、公開結果をスクレイピングするか、生の GDS 運賃データのライセンスを取得することですが、どちらも大がかりで高額です。このサーバーは、サイトに表示されるものと同じ検索結果を読み取り、JSON として返します。

このサーバーでできないこと。 予約と支払いには対応していません。運賃、区間、Google が予約に進む際に使うトークンを読み取り、予約の手順はユーザーに引き継ぎます。

よくある質問

公式の Google Flights API はありますか？

いいえ。Google は 2018 年に QPX Express を終了し、後継サービスをリリースしていません。どの選択肢も、ウェブサイトが提供するものと同じ公開検索結果を読み取ります。このサーバーは HasData がメンテナンスしており、結果を構造化 JSON で返します。

Google Flights MCP サーバーとは何ですか？

AI クライアントが呼び出せるツールとして Google Flights を公開するサーバーです。クライアントは Model Context Protocol 経由でツール呼び出しを送信し、サーバーは旅程を取得して構造化 JSON を返し、モデルはその結果を使います。このサーバーは単一のツールを公開し、リモートで実行されます。

往復検索が 2 回の呼び出しになるのはなぜですか？

Google は最初に往路の候補を返し、それぞれに departureToken を含めます。候補を 1 つ選び、そのトークンを渡して、組み合わせられる復路のフライトを取得します。これはサイトの動作を反映しており、そのため往復検索には 30 クレジットかかります。

炭素排出量はキログラム単位ですか？

いいえ、グラム単位です。thisFlight: 433000 は 433 kg を意味し、differencePercent はルート平均との比較を示します。

ディープ検索とは何ですか？

Google Flights がブラウザーに表示する内容をそのまま返す、低速のモードです。速度を優先する場合はオフのままにし、サイトと同じ結果が必要な場合はオンにしてください。

ほかの HasData API と一緒に使えますか？

はい。apis パラメーターにはリストを指定でき、?apis=google_travel とするとフライトに加えて Google Hotels も利用できます。パラメーターを省略すると、すべてのツールを利用できます。

コンプライアンスと個人データ

HasData は一般に公開されているデータのみを取得します。プラットフォームの利用規約によって自動アクセスが制限されている場合があり、ご自身のコンプライアンスにはご自身で責任を負っていただきます。

HasData のリンク

開発

このリポジトリは、リモートサーバーの設定とドキュメントです。ビルド手順はなく、コンテナ化するものもありません。

test/ 内のテストでは、ここでのコミットがなくても変更される可能性のある部分、つまりツールの契約を検証します。?apis=google_travel_flights がツールをちょうど 1 つ返すこと、必須パラメーターが引き続き宣言されていること、名前が変更されていないこと、使用中のキーが実際に受け付けられることを確認します。最後のチェックではツールを実際に呼び出し、15 クレジットを消費します。これは、適切な理由で失敗する可能性があるカナリアテストの料金です。

# macOS and Linux
HASDATA_API_KEY=your_key_here npm test

# Windows PowerShell
$env:HASDATA_API_KEY="your_key_here"; npm test

同じテストスイートは、すべてのプッシュ時と週 1 回のスケジュールで CI でも実行されます。上流のツール一覧は、このリポジトリに変更がなくても変わる可能性があるためです。失敗した場合は、ツール一覧が変更された、キーが使えなくなった、またはエンドポイントに到達できなかったことを意味し、どれに該当するかはアサーションメッセージに示されます。

貢献

パラメーターテーブルとレスポンスのサンプルは特に変更されやすいため、これらの修正が最も役立つ貢献です。実行した呼び出しと、受け取ったレスポンスを記載してください。フォークからのプルリクエストではキーなしでテストスイートが実行され、ライブチェックは失敗扱いにならずスキップされます。

ライセンス

MIT です。LICENSE を参照してください。