gmapsscraper

gmapsscraper MCP サーバー

gmapsscraper.io 向けの MCP（Model Context Protocol）サーバーです。Claude、Cursor、Windsurf、およびあらゆる MCP クライアントから、通常の会話で Google マップのビジネスデータをスクレイピングできます。取得できるデータは、名称、住所、電話番号、メールアドレス、ウェブサイト、評価、レビュー件数、カテゴリ、座標です。

「シカゴでメールアドレス付きの歯科医を50件見つけて」→ AI チャット上ですぐに完了します。

ツール

ツール	機能
scrape_google_maps	Google マップを検索してビジネスの見込み客情報を返します（完了まで待機、約30～120秒）
start_scrape_job	非同期版です。すぐにジョブ ID を返します
get_scrape_results	以前に開始したジョブの結果を取得します
get_credits	残りのクレジット残高を確認します

スクレイピング1回につき2クレジットを消費します。1回の呼び出しで複数のキーワードを指定しても、消費クレジットは同じです。無料枠：10クレジット（5回の検索、クレジットカード不要）— gmapsscraper.io/dashboardで API キーを取得してください。

セットアップ

Claude Code

claude mcp add gmapsscraper -e GMAPSSCRAPER_API_KEY=your_key -- npx -y @gmapsscraper/mcp

Claude Desktop / Cursor / Windsurf

MCP 設定（claude_desktop_config.json、.cursor/mcp.jsonなど）に追加します。

{
  "mcpServers": {
    "gmapsscraper": {
      "command": "npx",
      "args": ["-y", "@gmapsscraper/mcp"],
      "env": {
        "GMAPSSCRAPER_API_KEY": "your_key"
      }
    }
  }
}

Cursor Directory / Open Plugins

プラグインディレクトリからインストールすると、同梱のmcp.jsonが使用されます。Open Plugins の仕様で展開されるのは${PLUGIN_ROOT}と${PLUGIN_DATA}のみであるため、認証情報のプレースホルダーがそのまま渡され、サーバーの認証に失敗することのないよう、意図的にenvブロックを含めていません。

クライアントを起動する前に、ご自身の環境でキーを設定してください。

# macOS / Linux — add to ~/.zshrc or ~/.bashrc
export GMAPSSCRAPER_API_KEY=your_key

# Windows PowerShell
setx GMAPSSCRAPER_API_KEY "your_key"

その後、クライアントを再起動して、変数が読み込まれるようにしてください。スクレイピングで認証エラーが返された場合は、まずget_creditsを実行してください。すぐに失敗するため、キーが認識されているか確認できます。

Node.js ≥ 18 が必要です。このサーバーはローカルで stdio 経由で動作し、gmapsscraper.io APIと通信します。その他のインフラストラクチャは不要です。

プロンプト例

• 「テキサス州オースティンのメールアドレス付きコーヒーショップをスクレイピングして、表にまとめて」
• 「マイアミの配管工を見つけて、評価の高い上位5件に送る営業メールの下書きを作って」
• 「『コロラド州デンバーのウェディングフォトグラファー』のスクレイピングを開始して。後で確認します」
• 「gmapsscraper のクレジットはあといくつ残っていますか？」

ビジネスごとに返されるデータ

title, address, phone, email, website, rating, reviews_count, category, latitude, longitude, google_maps_url, opening_hours

コンテキストを整理しやすいよう、レスポンスごとの結果は100件までに制限されています。完全な CSV はダッシュボードからいつでも取得できます。

関連項目

• 📦 Node.js SDK — npm install @gmapsscraper/sdk（このサーバーはこれを基盤に構築されています）
• 🐍 Python SDK — pip install gmapsscraper-sdk
• 🤖 Claude エージェントスキル
• 📘 API ドキュメント / llms.txt

ライセンス

MIT © gmapsscraper.io