HasData Google Hotels

Google Hotels MCP Server

ホスト型の Model Context Protocol（MCP）サーバーです。Claude、Cursor、Windsurf など、あらゆる MCP クライアントに Google Hotels のツールを 1 つ提供します。目的地と 2 つの日付を指定してホテルやバケーションレンタルを検索し、宿泊施設を開くと、各予約サイトの料金、評価、トピック別のレビュー内訳、アメニティ、写真、座標をすべて構造化 JSON で確認できます。Google アカウントも Places API のクォータも必要ありません。

毎月 1,000 クレジットが無料で、カード登録も不要です。ホテル検索約 100 回分に相当します。

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

• プロンプトとリソース

目次

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

必要なもの

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

クイックスタート

サーバー URL は、どのクライアントでも同じです。Claude Code と Claude Desktop では、実際に接続して動作を確認しています。その他の設定例は、それぞれのクライアントがリモートサーバー用に公開している形式に従っています。

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

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

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

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

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

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

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

プロンプトの例

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

11 月 12 日から 15 日までの宿泊で、バルセロナのホテルを探してください。大人 2 名で、料金が安い順に 5 件、1 泊あたりの料金、評価、クラスを一覧にしてください。

1 回の呼び出し、10 クレジットです。料金、評価、設備がすべてまとめて返されます。

同じ宿泊条件で、4 つ星以上、無料キャンセル可能なホテルのみを評価順に並べてください。

1 回の呼び出し、10 クレジットです。クラス、キャンセル条件、並び順は、1 回のリクエストに指定するフィルターです。

検索結果の最上位のホテルについて、各予約サイトの料金と、お得な価格かどうかを教えてください。

2 回の呼び出し、20 クレジットです。検索結果にはホテルごとに propertyToken が含まれます。それを渡すと、そのホテルについて、Google が比較するすべての提供元、一般的な価格帯、そしてその取引に対する Google 独自の評価が表示されます。

その週にリスボンで、寝室が 2 室以上あり、プール付きのバケーションレンタルを探してください。

1 回の呼び出し、10 クレジットです。vacationRentals を有効にし、bedrooms を 2 に設定し、プールを amenity__ に指定します。

目的地は、声に出して言うときと同じように指定してください。単に Barcelona とだけ入力すると、Google は検索が実行された場所を基準に解釈するため、カリフォルニアのサーバーからはカリフォルニアのホテルが返されます。hotels in Barcelona と入力するか、gl を es に設定すると、都市を正しく指定できます。

ツール

読み取り専用のツールが 1 つあり、サイトの両方の機能をカバーします。propertyToken がない場合は検索し、指定すると 1 つの施設を表示します。

以下のサンプルは、実際の呼び出し結果を抜粋したものです。ホテルの料金は日々変動します。データの構造を把握するための例としてご覧ください。

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

ホテルとバケーションレンタルを検索する

hasdata_google_travel_hotels_getGoogleHotels

目的地と滞在期間に応じた宿泊施設の情報です。料金、評価、設備、画像を取得できます。

結果は properties の下に返され、1ページあたり約20件です。各宿泊施設には、name、type、description、link、gpsCoordinates、ratePerNight、totalRate（それぞれ元の文字列と extracted* の数値を含みます）、extractedHotelClass を含む hotelClass、overallRating、reviews、locationRating、評価の分布を示す ratings、トピックごとの肯定的・否定的な言及を含む reviewsBreakdown、amenities、images、徒歩および交通機関での所要時間を含む nearbyPlaces が含まれます。searchInformation.totalResults はGoogleが取得した件数を示し、pagination には nextPageToken が含まれます。また、brands にはブランドツリーと、brands フィルターで指定するIDの一覧が含まれます。

料金は2通りで表示されます。lowest は税金と手数料を含み、beforeTaxesFees は含みません。宿泊施設によっては、どちらか一方のみが含まれる場合があります。順位付けの前に、同じ条件の料金を比較してください。

{
  "name": "Casa Gràcia",
  "propertyToken": "ChcI0r6-2uyF7rIuGgsvZy8xdmo2bnNxZhAB",
  "type": "hotel",
  "description": "Cozy quarters in a hip lodging with dining & a lively bar, plus a kitchen, a library & free Wi-Fi.",
  "link": "https://room00hostel.com/barcelona/casa-gracia-hostel/",
  "gpsCoordinates": { "latitude": 41.3974523, "longitude": 2.1593339 },
  "ratePerNight": { "beforeTaxesFees": "US$61", "extractedBeforeTaxesFees": 61 },
  "totalRate": { "beforeTaxesFees": "US$182", "extractedBeforeTaxesFees": 182 },
  "hotelClass": "4-star hotel",
  "extractedHotelClass": 4,
  "overallRating": 3.9,
  "reviews": 3811,
  "locationRating": "4.6",
  "amenities": ["Breakfast", "Air conditioning", "Airport shuttle", "Kid-friendly"],
  "nearbyPlaces": [
    { "name": "La Pedrera - Casa Milà", "transportations": [{ "type": "Walking", "duration": "5 min" }] }
  ]
}

1つの宿泊施設の詳細

検索結果の propertyToken を日付を維持したまま同じツールに渡すと、その宿泊施設のみが返されます。検索時のフィールドに加えて、Googleが比較する各ソースの料金である prices、スポンサー付き料金の featuredPrices、滞在中の一般的な料金範囲を示す typicalPriceRange、Googleが料金をお得と判断した場合の deal と dealDescription、address、phone、directions、カテゴリ別にまとめられた amenitiesDetailed、excludedAmenities、Tripadvisorなどからの otherReviews が追加されます。

{
  "prices": [
    {
      "source": "Booking.com",
      "numGuests": 2,
      "ratePerNight": { "lowest": "$61", "beforeTaxesFees": "$39", "extractedLowest": 61 }
    }
  ],
  "typicalPriceRange": { "lowest": "$51", "highest": "$68", "extractedLowest": 51, "extractedHighest": 68 },
  "deal": "34% less than usual",
  "dealDescription": "Great Deal",
  "address": "Pg. de Gràcia, 116Bis, Gràcia, 08008 Barcelona, Spain",
  "phone": "+34 931 74 05 28"
}

プロンプトとリソース

サーバーは7つのリソースを公開しており、それぞれ、受け付ける値が固定リストであるパラメーターに対応しています。拒否された呼び出しから用語を学ぶより、リソースを読むほうが効率的で、クレジットもかかりません。各URIはhasdata://google_travel/<parameter>です。

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

エラーと失敗時の挙動

ツール呼び出しでクライアントがHTTPエラーコードを受け取ることは、ほとんどありません。MCPレイヤーは200で応答し、失敗の内容を結果に含めます。このときisErrorはtrueに設定され、理由がテキストで示されます。エージェントは、ステータス行が表示されると思う箇所でメッセージを読み取ります。

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

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

日付がない場合は、検索として処理される前に拒否されます。 checkOutDateを省略すると、フィールド名を示す422のバリデーションエラーが返されます。

危険なのは、気づきにくい地理的な誤りです。 Googleが場所を特定できない目的地や、別の国にある同名の都市から読み取った都市名だけの指定では、どちらも200が返されますが、まったく別の場所にある施設が1ページ分表示されます。Qwertyvilleを検索したところ、リクエストの発信元であるデータセンター付近の実在するホテルが18軒返されました。リストを信頼する前に、最初の結果のgpsCoordinatesを確認するか、glを渡してください。

意味をなさない日付は拒否されず、ひそかに修正されます。 チェックアウト日がチェックイン日より前の場合や、2020年の宿泊であっても、施設が返され、応答は200になります。Googleがエラーを返す代わりに期間を正規化するためです。日付がモデルから渡される場合は、呼び出し元で検証してください。

データを含む結果には、サポートへの問い合わせ時に提示できるrequestMetadata.idも含まれます。

料金、無料枠、上限

Google Hotels の呼び出しは、成功するごとに 10 クレジットかかります。レスポンスのサイズによって料金は変わらず、施設を 1 件開く場合も検索と同じ料金です。

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

有料プランは、200,000 クレジット（20,000 回の検索に相当）を含む月額 $59からです。つまり、検索 1,000 回あたり $2.95です。最も大きいプランでは単価が1,000 回あたり $0.83まで下がり、年間請求では 12 か月分を 10 か月分の月額料金で利用できます。最新の料金は料金ページをご覧ください。

プランによって同時実行数も決まります。無料枠では一度に 1 件、Startup では 5 件、Basic では 15 件、Growth の各プランでは 50～500 件です。無人で実行する処理では、超過時に備えて防御的に対応してください。

HTTP ステータスが 200 以外で返されたリクエストには課金されません。検索後に施設を開く場合は 2 回目の呼び出しとなるため、その分も予算に含めてください。

ツールの選択

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

?apis=google_travel_hotels           the one tool in this repo
?apis=google_travel                  add Google Flights
?apis=google_travel_hotels,airbnb    hotels plus Airbnb stays
?apis=google_travel_hotels,booking   hotels plus Booking.com

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

比較

Google は、一般公開の Hotels API を提供したことがありません。Hotel Center は施設運営者が料金を登録するためのもので、Places API は写真やレビューを含むビジネス情報を返しますが、指定した期間の料金は返しません。代替手段は個々の予約サイトが提供するアフィリエイト API ですが、それぞれ自社の在庫のみを対象とし、利用には承認が必要です。

このサーバーでできないこと。 予約や支払いには対応していません。指定した日付の料金と空室状況、および Google が提示するリンクを取得し、予約手続きは利用者に委ねます。

よくある質問

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

ありません。Google が提供する Hotel Center は、ホテル運営者が自社の料金を公開するためのもので、Places API はビジネス情報を提供するものです。どちらも宿泊料金は返しません。このサーバーは公開されている検索結果を読み取り、構造化 JSON として返します。

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

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

検索結果に別の国のホテルが表示されるのはなぜですか？

場所の名前だけを指定すると、検索が実行される場所（リクエストの送信元となるデータセンター）に基づく Google 独自の判定で場所が解決されるためです。Barcelona ではなく hotels in Barcelona と入力するか、gl に国コードを設定すると、目的地が正しく認識されます。

各予約サイトの料金を確認するにはどうすればよいですか？

まず検索を実行し、次に、料金を確認したい施設の propertyToken を指定してツールを再度呼び出します。レスポンスには、提供元ごとの項目を含む prices、宿泊期間の typicalPriceRange、料金が通常より大幅に安い場合の Google による deal 判定が含まれます。

バケーションレンタルを検索できますか？

はい。vacationRentals を有効にすると、同じツールでレンタル物件を検索でき、bedrooms と bathrooms が便利なフィルターになります。

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

はい。apis パラメーターにはリストを指定でき、?apis=google_travel を追加すると、ホテルに加えて Google Flights も検索できます。パラメーターを省略すると、すべての項目が対象になります。

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

HasData がアクセスするのは、公開されているデータのみです。プラットフォームの利用規約で自動アクセスが制限されている場合があり、ご自身でコンプライアンスを遵守する責任があります。

HasData のリンク

開発

このリポジトリは、リモートサーバーの設定とドキュメントを管理しています。ビルド手順はなく、コンテナ化も不要です。

test/ のテストでは、コミットなしでも壊れる可能性があるツールの仕様を検証します。?apis=google_travel_hotels がツールを1つだけ返すこと、必須パラメーターが引き続き宣言されていること、名前が変更されていないこと、使用中のキーが実際に受け付けられることを確認します。最後の確認ではツールを実際に呼び出すため、10クレジットかかります。適切な理由で失敗する可能性のあるカナリアテストのコストです。

# 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 を参照してください。