内容
<p align="center">
<a href="https://gmapsextractor.com">
<img src="logo.png" alt="谷歌地图提取器" width="400">
</a>
</p>
# 谷歌地图爬虫MCP服务器
通过一个安全的[模型上下文协议](https://modelcontextprotocol.io/)连接，为您的AI代理提供实时的谷歌地图商业搜索、评论和照片数据。
本仓库是托管的谷歌地图提取器MCP服务器的公开列表和清单。服务器远程运行，因此无需安装任何软件包，也无需在本地托管。
- 网站：[gmapsextractor.com](https://gmapsextractor.com)
- 产品页面：[谷歌地图爬虫MCP](https://gmapsextractor.com/google-maps-scraper-mcp)
- 获取API密钥：[cloud.gmapsextractor.com](https://gmapsextractor.com/google-maps-scraper-mcp)
- MCP端点：`https://cloud.gmapsextractor.com/api/mcp`
- 传输：可流式HTTP
- 认证：`Authorization: Bearer YOUR_API_KEY`
## 您可以使用
- 按关键词和位置搜索企业，包括名称、地址、电话号码、网站、评分、评论和照片等列表详情。
- 检索公共的谷歌地图评论，用于声誉研究和客户反馈分析。
- 检索公共的企业照片和图片网址，用于列表丰富和视觉审计。
常见的业务流程包括市场调研、本地市场分析、竞争对手比较、CRM丰富、声誉分析和列表审计。
## 连接
在[谷歌地图提取器仪表盘](https://cloud.gmapsextractor.com)中创建API密钥，将其保存在安全的环境变量或密钥存储中，并使用MCP客户端注册远程端点。
### Claude 代码
```bash
claude mcp add --transport http google-maps-scraper-mcp \
https://cloud.gmapsextractor.com/api/mcp \
--header "Authorization: Bearer YOUR_API_KEY"
```
### Cursor
将以下内容添加到项目中的 `.cursor/mcp.json` 中：
```json
{
"mcpServers": {
"google-maps-scraper-mcp": {
"url": "https://cloud.gmapsextractor.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
```
### VS Code
将以下内容添加到项目中的 `.vscode/mcp.json` 中：
```json
{
"servers": {
"google-maps-scraper-mcp": {
"type": "http",
"url": "https://cloud.gmapsextractor.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
```
### Codex
将以下内容添加到 `~/.codex/config.toml` 中：
```toml
[mcp_servers.google-maps-scraper-mcp]
type = "http"
url = "https://cloud.gmapsextractor.com/api/mcp"
[mcp_servers.google-maps-scraper-mcp.headers]
Authorization = "Bearer YOUR_API_KEY"
```
### Cline
将以下内容添加到您的MCP设置中：
```json
{
"mcpServers": {
"google-maps-scraper-mcp": {
"type": "streamableHttp",
"url": "https://cloud.gmapsextractor.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
```
## 工具
### `search_google_maps`
实时在谷歌地图上搜索企业和地点。
| 参数 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `q` | 字符串 | 是 | 搜索查询，例如 `纽约的咖啡店` |
| `ll` | 字符串 | 否 | 坐标和缩放级别，例如 `@40.7128,-74.0060,11z` |
| `hl` | 字符串 | 否 | 语言代码；默认为 `zh-CN` |
| `gl` | 字符串 | 否 | 国家代码；默认为 `cn` |
| `page` | 数字 | 否 | 页码；默认为 `1` |
| `extra` | 布尔值 | 否 | 包括电子邮件、社交资料和扩展详情 |
### `get_place_reviews`
使用 `search_google_maps` 返回的 `fid` 检索某个地点的公开评论。
| 参数 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `fid` | 字符串 | 是 | 搜索返回的谷歌地图特征ID |
| `page` | 数字 | 否 | 页码；默认为 `1` |
| `max_page` | 数字 | 否 | 要检索的最大页数 |
| `sort_by` | 数字 | 否 | `1` 相关性，`2` 最新，`3` 最高评分，`4` 最低评分 |
### `get_place_photos`
使用 `search_google_maps` 返回的 `fid` 检索某个地点的公开照片。
| 参数 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `fid` | 字符串 | 是 | 搜索返回的谷歌地图特征ID |
| `page` | 数字 | 否 | 页码；默认为 `1` |
| `max_page` | 数字 | 否 | 要检索的最大页数 |
## 示例提示
- “查找波特兰评分最高的咖啡店，并返回它们的网站、电话号码、评分和评论数。”
- “获取该地点的最新谷歌地图评论，并总结重复出现的客户投诉。”
- “检索这些餐厅FIDs的公开照片，并识别视觉内容有限的位置。”
- “比较奥斯汀牙医的可见列表信号，并按评分对结果进行分组。”
## 认证和使用
每个请求都必须包含您的谷歌地图提取器API密钥：
```http
Authorization: Bearer YOUR_API_KEY
```
请勿将实际的API密钥提交到此仓库或任何客户端配置中。新账户可以从可用的免费每月请求开始；更高容量的使用将遵循与密钥绑定的计划。
## 关于此仓库
这是一个公开的发现、配置和文档仓库。它包含：
- `server.json` 用于MCP注册表兼容的服务器元数据
- `.mcp.json` 作为可自定义的客户端配置
- `llms-install.md` 包含AI代理的简明安装说明
- 产品图标和品牌
托管的MCP实现仍位于 `https://cloud.gmapsextractor.com/api/mcp`。
## 许可证
[MIT](LICENSE)
