mcpField
G
gmapsscraper

gmapsscraper

本地服务
gmapsscraper.io商业与营销312 周前更新
代码仓库访问官网

关于 gmapsscraper

gmapsscraper 是面向销售和调研流程的 MCP 服务，用于收集 Google Maps 商家线索。它返回联系方式和商家指标，并支持同步搜索与后台任务。

主要功能

  1. 01搜索 Google Maps 商家
  2. 02返回联系方式和评分等信息
  3. 03以后台任务执行抓取
  4. 04查询任务结果和剩余额度

适用场景

  1. 01按地区和类别建立潜在客户名单
  2. 02查找商家邮箱和网站
  3. 03启动抓取后稍后获取结果

MCP 相关

向 MCP 客户端提供 Google Maps 搜索、后台任务、结果查询和额度检查工具。服务通过 stdio 在本地运行，并调用 gmapsscraper.io API。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "io-gmapsscraper": {
      "command": "npx",
      "args": [
        "-y",
        "@gmapsscraper/mcp"
      ],
      "env": {
        "GMAPSSCRAPER_API_KEY": "<GMAPSSCRAPER_API_KEY>"
      }
    }
  }
}
启动命令npx -y @gmapsscraper/mcp
需要配置的环境变量
GMAPSSCRAPER_API_KEY密钥API key from https://gmapsscraper.io/dashboard (free tier: 10 credits)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@gmapsscraper/mcp0.1.1

工具

4

收录的工具列表 · 更新于 2 周前

参数类型必填说明
langstring否ISO 639-1 结果语言，例如 "en"、"es"、"de"。
depthinteger否1-2；更高的值会在点数费用不变的情况下返回更多结果。
emailboolean否同时抓取商家网站以提取联系邮箱（建议用于潜在客户开发 / 冷启动外联）。
radiusinteger否搜索半径，单位为米（默认值 20000）。
keywordsarray是包含地点的搜索查询，例如 ["dentist in Chicago IL"]。多个相关关键词的费用仍为 2 个点数。
max_wait_secondsinteger否等待抓取完成后再返回用于轮询的任务 ID 的最长时间。

详细介绍

gmapsscraper MCP 服务

npm version license

适用于 gmapsscraper.io 的 MCP（Model Context Protocol）服务——让 Claude、Cursor、Windsurf 以及任何 MCP 客户端都能通过普通对话抓取 Google Maps 商家数据：名称、地址、电话、邮箱、网站、评分、评论数、类别和坐标。

“查找芝加哥 50 位牙医及其邮箱” → 完成，就在你的 AI 聊天中。

工具

工具功能
scrape_google_maps搜索 Google Maps 并返回潜在客户信息（等待完成后返回，约 30–120 秒）
start_scrape_job即发即弃版本——立即返回任务 ID
get_scrape_results获取已启动任务的结果
get_credits查看剩余积分

每次抓取消耗 2 个积分；一次调用中使用多个关键词，费用不变。免费套餐：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。该文件特意不包含 env 块——Open Plugins 规范只会展开 ${PLUGIN_ROOT} 和 ${PLUGIN_DATA}，因此密钥占位符会被原样传递，导致服务无法通过身份验证。

启动客户端前，请在你自己的环境中设置密钥：

# 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 始终可从仪表板获取。

相关资源

许可证

MIT © gmapsscraper.io

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。