ビジネスを見つける
search_google_mapsカテゴリと地域で検索します。利用可能なリスティング、連絡先、評価、レビュー数フィールドを持つ最大20件のビジネスを受け取ります。
q · page · extra
Search 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_photos1つの場所の最大20件の写真・動画メタデータレコードを取得します。返されたメディアURLとページネーションフラグを読み取ります。
fid · page
Photos APIを見るReviewsとphotosは、検索結果のplace.dataIdからMaps feature IDを受け取ります。Searchは1〜10ページを使い、メディアツールはnextを返すので、エージェントが別のページが必要かを判断できます。
MCP接続
クライアントが初期化とツール検出を処理し、各リクエストでAPIキーを送信します。
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つのツールが表示されることを確認してください。ステップバイステップの設定ガイドに従ってください。
最初のワークフロー
テストキーとシミュレートされたデータから始めます。API利用枠を使う準備ができたらライブキーに切り替えてください。
API製品を選択し、scrapes:writeのテストキーを作成します。APIプランがMCPを許可している必要があります。OnlineとExtensionは別の利用枠です。
キーを作成クライアントを接続し、search_google_mapsを確認して1ページを依頼します。新しい処理には新しいリクエストIDを生成し、同じリクエストのリトライではそれを保持します。
クライアント設定を見るstructuredContent.businessesとtotalを読みます。テスト結果はシミュレートとして明記し、欠損値を保持し、リクエストしたページの後で停止します。
フィールドを理解する新しい検索ごとにリクエストIDを置き換えてください。この例はページからリクエストを実行しません。
{
"q": "coffee shops in Seattle",
"page": 1,
"hl": "en",
"extra": false,
"client_request_id": "replace-with-a-fresh-uuid"
}返ってくるもの
結果は直接返されます。ジョブのポーリングは不要です。JSONをテーブルやレポートにする際はソースの観測日を保持してください。
プロンプト例
接続後にこれらのプロンプトを使ってください。必要な場所では実際のfeature IDを指定し、テスト結果はシミュレートとして明記するようエージェントに依頼してください。
“search_google_mapsをシアトルのコーヒーショップ、ページ1、extra falseで1回使用してください。返されたビジネスから名前、Webサイト、電話番号、評価、レビュー数を返してください。欠損フィールドは空欄のままにし、観測日を表示してください。このページの後で停止してください。”
期待される結果
最大20件の返却ビジネスの表(ソースタイムスタンプと欠損値を保持)。
“選択したビジネスについて、そのplace.dataIdをfidとして使用してください。sort_by 2でget_google_maps_reviewsのページ1をリクエストしてください。これらの返されたレビューのみのテーマを要約し、それらの日付を引用してください。追加ページは取得しないでください。”
期待される結果
最大10件のレビューの限定された要約。1ページをすべての顧客体験として扱わない。
“この指定されたfeature IDに対して、get_google_maps_photosをページ1のみで使用してください。返されたphotoUrlと任意のvideoUrlフィールドをリストアップし、nextがtrueかどうかを報告してください。ファイルをダウンロードしたり、次のページを取得したりしないでください。”
期待される結果
最大20件のギャラリーレコードと返されたページネーション状態。独自のアプリケーションで確認可能。
REST + MCP
MCPは無料・有料のAPIプランで利用できます。成功したライブソースページは、空のページを含めて1ページにつき1 APIリクエストユニットを消費します。
テストキーはゼロリクエストユニットでシミュレートされたフィクスチャを返します。実際のビジネス見込み客ではなく、統合を検証するためのものです。
APIキーを管理タスクに必要なページと場所のみを依頼してください。新しい処理には新しいリクエストIDを使い、不確かなリクエストは同じ入力とIDでリトライします。
使用ガイダンスを読むGoogle Maps Data Agent Skillは、同じツールにワークフローガイダンス、オペレーションリファレンス、RESTフォールバックを追加します。
Agent Skillを見るAPIハブを見る → OnlineとExtensionプランには独自の利用枠があります。
接続のヘルプ
接続状態と返されたエラーを使って次のステップを選びます。
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はREST APIの利用枠を共有し、無料・有料のAPIプランで利用できます。成功したライブページは空のページを含めて1リクエストユニットを消費します。テスト用認証情報はゼロユニットでシミュレートされたデータを返します。OnlineとExtensionの利用枠は別です。
MCPサーバーは単体で動作します。オプションのGoogle Maps Data Agent Skillは、設定したMCP接続が利用できない場合の再利用可能な手順、オペレーションリファレンス、RESTフォールバック用ヘルパーを追加します。