内容
# gmapsscraper MCP 服务器
[](https://www.npmjs.com/package/@gmapsscraper/mcp)
[](./LICENSE)
用于 [gmapsscraper.io](https://gmapsscraper.io) 的 MCP（模型上下文协议）服务器 - 让 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](https://gmapsscraper.io/dashboard) 获取 API 密钥。
## 设置
### Claude 代码
```bash
claude mcp add gmapsscraper -e GMAPSSCRAPER_API_KEY=your_key -- npx -y @gmapsscraper/mcp
```
### Claude 桌面版 / Cursor / Windsurf
添加到您的 MCP 配置（`claude_desktop_config.json`、`.cursor/mcp.json`等）：
```json
{
"mcpServers": {
"gmapsscraper": {
"command": "npx",
"args": ["-y", "@gmapsscraper/mcp"],
"env": {
"GMAPSSCRAPER_API_KEY": "your_key"
}
}
}
}
```
需要 Node.js ≥ 18。服务器在本地运行，通过 stdio 与 [gmapsscraper.io API](https://gmapsscraper.io/llms.txt) 通信 - 无需其他基础设施。
## 示例提示
- *"抓取奥斯汀 TX 的咖啡店及其电子邮件，并给我一个表格"*
- *"找到迈阿密的管道工，然后为评分前 5 名的管道工起草一封冷邮件"*
- *"开始抓取 '丹佛 CO 的婚礼摄影师'，我稍后会回来查看"*
- *"我还剩多少 gmapsscraper 信用点？"*
## 每家企业返回的数据
`title, address, phone, email, website, rating, reviews_count, category, latitude, longitude, google_maps_url, opening_hours`
每次响应限制 100 家企业，以保持您的上下文整洁；完整的 CSV 文件始终可在 [dashboard](https://gmapsscraper.io/dashboard) 上获取。
## 相关
- 📦 [Node.js SDK](https://github.com/gmapsscraper/gmapsscraper-js) — `npm install @gmapsscraper/sdk` （本服务器基于此构建）
- 🐍 [Python SDK](https://github.com/gmapsscraper/gmapsscraper-python) — `pip install gmapsscraper-sdk`
- 🤖 [Claude 代理技能](https://github.com/gmapsscraper/google-maps-agent-skills)
- 📘 [API 文档 / llms.txt](https://gmapsscraper.io/llms.txt)
## 许可证
[MIT](./LICENSE) © [gmapsscraper.io](https://gmapsscraper.io)
