Google Mapsデータ / MCPサーバー

Google Mapsデータを、AIワークフローの中へ。

Claude Code、Cursor、VS Code、Codexで、ビジネスの検索、公開レビューの閲覧、場所ギャラリーの探索ができます。3つのリモートツール。同じAPIキー。

お使いのMCPクライアントで動作

リモートStreamable HTTP · プライベートAPIキー · 無料・有料APIプラン

3つのツール / 1つの接続

ビジネス発見から場所の詳細まで。

各ツールは結果を直接返します。タスクに必要なオペレーションを選び、リクエストするページを明示的にしてください。

ビジネスを見つける

search_google_maps

カテゴリと地域で検索します。利用可能なリスティング、連絡先、評価、レビュー数フィールドを持つ最大20件のビジネスを受け取ります。

q · page · extra

Search APIを見る

公開レビューを読む

get_google_maps_reviews

場所のfeature IDで最大10件のレビューをリクエストします。関連性、新着、高評価、低評価を選べます。

fid · page · sort_by

Reviews APIを見る

ギャラリーメディアを閲覧

get_google_maps_photos

1つの場所の最大20件の写真・動画メタデータレコードを取得します。返されたメディアURLとページネーションフラグを読み取ります。

fid · page

Photos APIを見る

Reviewsとphotosは、検索結果のplace.dataIdからMaps feature IDを受け取ります。Searchは1〜10ページを使い、メディアツールはnextを返すので、エージェントが別のページが必要かを判断できます。

MCP接続

1つのエンドポイント。あなたのAPIワークスペース。

クライアントが初期化とツール検出を処理し、各リクエストでAPIキーを送信します。

リモートMCP接続
POST https://gmapscrawl.com/api/mcp
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
Accept: application/json, text/event-stream

クライアント設定

作業するクライアントを選んでください。

APIキーを作成し、クライアント用の設定をコピーします。キーは環境変数または保護された入力設定に保管してください。

このサーバーを.mcp.jsonに追加します。Claude Codeを起動する環境でGMSCRAPER_API_KEYを利用できるようにしてください。

{
  "mcpServers": {
    "google-maps-data": {
      "type": "http",
      "url": "https://gmapscrawl.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${GMSCRAPER_API_KEY}"
      }
    }
  }
}

設定を保存したら、再接続して3つのツールが表示されることを確認してください。ステップバイステップの設定ガイドに従ってください。

最初のワークフロー

接続。1ページをテスト。結果を読む。

テストキーとシミュレートされたデータから始めます。API利用枠を使う準備ができたらライブキーに切り替えてください。

01

ワークスペースを準備

API製品を選択し、scrapes:writeのテストキーを作成します。APIプランがMCPを許可している必要があります。OnlineとExtensionは別の利用枠です。

キーを作成
02

ツールを検出して呼び出す

クライアントを接続し、search_google_mapsを確認して1ページを依頼します。新しい処理には新しいリクエストIDを生成し、同じリクエストのリトライではそれを保持します。

クライアント設定を見る
03

返されたビジネスを使う

structuredContent.businessesとtotalを読みます。テスト結果はシミュレートとして明記し、欠損値を保持し、リクエストしたページの後で停止します。

フィールドを理解する
search_google_mapsを呼び出す

新しい検索ごとにリクエストIDを置き換えてください。この例はページからリクエストを実行しません。

{
  "q": "coffee shops in Seattle",
  "page": 1,
  "hl": "en",
  "extra": false,
  "client_request_id": "replace-with-a-fresh-uuid"
}

返ってくるもの

構造化レコード、同じツールレスポンスで。

businesses
最大20件の返却ビジネス。フィールドは欠損する場合があります。
params + total
正規化されたクエリとこのページの件数。
simulated + usage metadata
テストレスポンスはフィクスチャデータを識別し、ライブリクエストユニットをゼロ消費。
isError
ツールが成功したと報告する前にエラーを確認してください。

結果は直接返されます。ジョブのポーリングは不要です。JSONをテーブルやレポートにする際はソースの観測日を保持してください。

プロンプト例

有用な質問。明確な停止点。

接続後にこれらのプロンプトを使ってください。必要な場所では実際のfeature IDを指定し、テスト結果はシミュレートとして明記するようエージェントに依頼してください。

焦点を絞ったビジネスリストを作成

“search_google_mapsをシアトルのコーヒーショップ、ページ1、extra falseで1回使用してください。返されたビジネスから名前、Webサイト、電話番号、評価、レビュー数を返してください。欠損フィールドは空欄のままにし、観測日を表示してください。このページの後で停止してください。”

期待される結果

最大20件の返却ビジネスの表(ソースタイムスタンプと欠損値を保持)。

1つのレビューページを要約

“選択したビジネスについて、そのplace.dataIdをfidとして使用してください。sort_by 2でget_google_maps_reviewsのページ1をリクエストしてください。これらの返されたレビューのみのテーマを要約し、それらの日付を引用してください。追加ページは取得しないでください。”

期待される結果

最大10件のレビューの限定された要約。1ページをすべての顧客体験として扱わない。

1つのギャラリーを確認

“この指定されたfeature IDに対して、get_google_maps_photosをページ1のみで使用してください。返されたphotoUrlと任意のvideoUrlフィールドをリストアップし、nextがtrueかどうかを報告してください。ファイルをダウンロードしたり、次のページを取得したりしないでください。”

期待される結果

最大20件のギャラリーレコードと返されたページネーション状態。独自のアプリケーションで確認可能。

REST + MCP

両方のインターフェースで1つのAPI利用枠。

MCPは無料・有料のAPIプランで利用できます。成功したライブソースページは、空のページを含めて1ページにつき1 APIリクエストユニットを消費します。

01

ライブ使用なしでテスト

テストキーはゼロリクエストユニットでシミュレートされたフィクスチャを返します。実際のビジネス見込み客ではなく、統合を検証するためのものです。

APIキーを管理
02

リクエストを限定する

タスクに必要なページと場所のみを依頼してください。新しい処理には新しいリクエストIDを使い、不確かなリクエストは同じ入力とIDでリトライします。

使用ガイダンスを読む
03

再利用可能な手順を追加

Google Maps Data Agent Skillは、同じツールにワークフローガイダンス、オペレーションリファレンス、RESTフォールバックを追加します。

Agent Skillを見る

APIハブを見る → OnlineとExtensionプランには独自の利用枠があります。

接続のヘルプ

次の成功したリクエストへ。

接続状態と返されたエラーを使って次のステップを選びます。

クライアントは接続するがツールが表示されない
エンドポイントが/api/mcpであること、クライアントがプライベートAuthorizationヘッダー付きのリモートStreamable HTTPをサポートしていることを確認してください。接続を再読み込みし、そのプロセスが設定されたキーを読み取れるか確認してください。
401または403
キーの有効期限、許可IP、アクティブなワークスペースアクセス、scrapes:writeスコープ、MCPを許可するAPIプランを確認してください。ブラウザのログインCookieではエンドポイントを認証できません。
invalid_request
選択したツールスキーマを読んでください。一意の16〜128文字のclient_request_idを指定してください。レビューと写真にはビジネス名や別の場所識別子ではなく、place.dataIdのFIDも必要です。
rate_limitedまたはquota_exceeded
レート制限ではretry_afterを尊重してください。API利用枠が尽きたら停止してAPI使用量を確認してください。別のキーを作成しても利用枠は増えません。
capability_unavailableまたはソース障害
サービスステータスと返されたエラーを確認してください。可用性はサーバーが決定します。欠損または利用不可のデータは結果で明示的にしてください。
タイムアウトまたはisError: true
HTTP接続が成功していてもツールのエラーを確認してください。リトライ可能な失敗では、タスクの期限まで同じ入力とリクエストIDを維持してください。新しい試行を始める前に終了エラーのガイダンスに従ってください。

サービスステータス エラーとリトライのガイダンス

よくある質問

Google Maps MCPサーバーは何ができますか?

search_google_maps、get_google_maps_reviews、get_google_maps_photosを公開します。Searchは最大20件のビジネスを返し、reviewsはページあたり最大10件、photosは最大20件のギャラリーレコードを返します。ツールは構造化データを直接返します。

どのクライアントを接続できますか?

リモートStreamable HTTPとプライベートAuthorizationヘッダーをサポートするClaude Code、Cursor、VS Code、Codex、またはその他のMCPクライアントのバージョンを使用してください。上記の4つのクライアント設定は同じエンドポイントとAPIワークスペースキーを使用します。

認証はどうしますか?

APIワークスペースでscrapes:writeのAPIキーを作成し、Bearerヘッダーとして非公開で設定してください。ブラウザCookieではMCPを認証できません。キーはプロンプト、URL、コミットされたソースコードの外に保管してください。

レビューと写真はどうやって正しい場所を見つけますか?

Maps feature IDをfidとして渡してください。返されたビジネスのplace.dataIdが使えます。レビューはsort_byも受け付けます:関連性は1、新着は2、高評価は3、低評価は4。別のメディアページを検討する前にnextを読んでください。

MCPは別の利用枠がありますか?

MCPはREST APIの利用枠を共有し、無料・有料のAPIプランで利用できます。成功したライブページは空のページを含めて1リクエストユニットを消費します。テスト用認証情報はゼロユニットでシミュレートされたデータを返します。OnlineとExtensionの利用枠は別です。

Agent Skillも必要ですか?

MCPサーバーは単体で動作します。オプションのGoogle Maps Data Agent Skillは、設定したMCP接続が利用できない場合の再利用可能な手順、オペレーションリファレンス、RESTフォールバック用ヘルパーを追加します。

次のステップへ

次の会話にGoogle Mapsデータを取り込みましょう。

APIキーを作成し、お好みのクライアントを接続して、焦点を絞ったビジネス検索を1つテストしてください。