内容
# GSC MCP for Claude Desktop
**直接将 Claude Desktop 连接到 Google Search Console，无需编码。**
由 [Davia-Rae Johnson](https://raeofsunshineconsulting.co) · Rae of Sunshine Consulting 构建和记录
---
## 功能介绍
此设置将 `mcp-search-console` MCP 服务器连接到 Claude Desktop，使 Claude 可以实时访问您的 Google Search Console 数据。连接后，您可以向 Claude 提出以下问题：
- *"显示 mysite.com 在过去 30 天内按点击量排名前 20 的页面。"*
- *"哪些页面当前存在索引错误，错误类型是什么？"*
- *"列出所有排名在 8 至 15 位之间且展示次数超过 50 的页面 — 这些是我的快速提升机会。"*
- *"立即提交 mysite.com/new-page 进行索引。"*
- *"mysite.com 提交了哪些站点地图，是否有返回错误？"*
Claude 直接从 GSC 拉取实时数据，并在您的聊天窗口中回答。无需导出。无需切换选项卡。无需手动报告。
---
## 功能
### 📊 性能和流量分析
- 按页面或查询显示点击量、展示次数、点击率和平均位置
- 按日期范围、设备类型、国家或搜索类型进行筛选
- 并排比较两个时间段
- 确定表现最佳的页面和排名查询
### 🔍 索引和覆盖率审计
- 查找所有具有索引错误的页面，按错误类型分组
- 检查单个 URL 的索引状态和上次爬取日期
- 确定被排除的页面并了解其被排除的原因
### 🗺️ 站点地图管理
- 列出所有提交的站点地图及其状态
- 删除损坏或不正确的站点地图
- 提交新的或更正的站点地图
### ⚡ URL 提交和快速提升机会识别
- 按需提交任何 URL 进行索引
- 查找排名在 8-15 位且展示次数较高的页面（快速提升机会）
- 确定您接近首页的查询
---
## 前置条件
开始前，请确保您具备：
- [ ] 已安装 Claude Desktop（Pro 或 Max 计划）
- [ ] 在您的机器上安装了 Python
- [ ] 已安装 `uv` 包管理器 — [在此获取](https://docs.astral.sh/uv/)
- [ ] 具有至少一个 GSC 属性的 Google 账户
- [ ] Windows 或 Mac
---
## 设置说明
### 步骤 1 — 创建 Google Cloud 项目
1. 访问 [console.cloud.google.com](https://console.cloud.google.com)
2. 点击顶部的项目下拉菜单 → **新建项目**
3. 命名为 `GSC MCP Claude` → 点击 **创建**
4. 确保在继续之前选择了您的新项目
### 步骤 2 — 启用 Search Console API
1. 在左侧边栏中，前往 **API 和服务 → 库**
2. 搜索 **Google Search Console API**
3. 点击它 → 点击 **启用**
### 步骤 3 — 创建 OAuth 2.0 凭证
1. 前往 **API 和服务 → 凭证**
2. 点击 **+ 创建凭证 → OAuth 客户端 ID**
3. 如果需要，请先配置同意屏幕（选择外部，填写应用名称和电子邮件）
4. 返回凭证：**+ 创建凭证 → OAuth 客户端 ID**
5. 应用类型：**桌面应用**
6. 命名为 `Claude Desktop GSC` → 点击 **创建**
### 步骤 4 — 下载 client_secrets.json
1. 在确认弹出窗口中，点击 **下载 JSON**
2. 将其保存在安全的位置 — 例如 `C:\Users\YourName\Documents\MCP\client_secrets.json`
3. **保持此文件私密** — 像对待密码一样
### 步骤 5 — 配置 Claude Desktop
找到您的 Claude Desktop 配置文件：
| 操作系统 | 路径 |
|---|---|
| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
| Mac | `~/Library/Application Support/Claude/claude_desktop_config.json` |
在文本编辑器中打开它并添加以下内容（用实际路径替换）：
```json
{
"mcpServers": {
"gscServer": {
"command": "C:\\Users\\YourName\\AppData\\Local\\uv\\bin\\uvx.exe",
"args": ["mcp-search-console"],
"env": {
"GSC_OAUTH_CLIENT_SECRETS_FILE": "C:\\Users\\YourName\\Documents\\MCP\\client_secrets.json"
}
}
}
}
```
> **查找您的 uvx 路径：** 在 Windows 命令提示符中运行 `where uvx`，或在 Mac 终端中运行 `which uvx`。
### 步骤 6 — 重启 Claude 并认证
1. 完全退出 Claude Desktop（检查系统托盘）
2. 重新打开 Claude Desktop
3. 一个浏览器窗口将打开，要求您使用 Google 登录 — 点击 **允许**
4. 您已连接 ✅
---
## 测试提示
连接后，在新的 Claude Desktop 聊天中尝试以下操作：
```
列出我可以访问的所有 Search Console 属性。
```
```
显示 [yoursite.com] 在过去 30 天内按点击量排名前 10 的页面。
```
```
[yoursite.com] 是否存在索引错误？
```
---
## MCP 服务器
此设置使用 AminForou 的开源 [`mcp-search-console`](https://github.com/AminForou/mcp-gsc) 服务器。
它包含 20 个内置工具：
| 工具 | 功能 |
|---|---|
| `list_sites` | 列出所有 GSC 属性 |
| `query_performance` | 拉取点击量、展示次数、点击率、位置 |
| `get_index_coverage` | 检查索引页面和错误 |
| `inspect_url` | 检查任何 URL 的索引状态 |
| `submit_url` | 提交 URL 进行索引 |
| `get_sitemaps` | 列出提交的站点地图 |
| `submit_sitemap` | 提交新的站点地图 |
| `delete_sitemap` | 删除损坏的站点地图 |
| `top_queries` | 按流量排名的搜索查询 |
| `top_pages` | 按任何指标排名的页面 |
| `compare_periods` | 比较两个日期范围 |
| `position_distribution` | 按位置范围显示页面 |
| `ctr_analysis` | 整个站点的点击率模式 |
| `mobile_usability` | 移动设备可用性问题 |
| `rich_results` | 结构化数据状态 |
| `crawl_errors` | 当前爬取错误 |
| `search_analytics` | 自定义分析查询 |
| `pages_by_query` | 为查询排名的页面 |
| `queries_by_page` | 为页面带来流量的查询 |
| `get_site_info` | 属性详情 |
---
## 故障排除
**Claude 表示无法连接到 GSC**
检查配置中的两个文件路径是否正确。运行 `where uvx` 以确认 uvx 路径。完全退出并重启 Claude Desktop。
**OAuth 浏览器窗口未打开**
确保在重启前 Claude Desktop 已完全退出（检查系统托盘）。
**查询站点时的权限错误**
您认证的 Google 账户必须对该 GSC 属性具有完全或受限权限。
**数据比 GSC 仪表板晚 2-3 天**
这是正常的 — API 默认仅使用最终数据。要求 Claude “包含最新数据”以拉取更近期的结果。
**配置文件中的 JSON 语法错误**
在保存之前，将您的配置文件粘贴到 [jsonlint.com](https://jsonlint.com) 以验证。
---
## 需要完整的逐步指南？
完整的带有截图的电子书可在以下网址获取：
**[raeofsunshineconsulting.co](https://raeofsunshineconsulting.co)**
---
## 关于
由 **Davia-Rae Johnson** 构建，他是 Rae of Sunshine Consulting 的创始人 — 一家数字基础设施调整咨询公司，为加纳、加勒比地区、北美和全球 diaspora 的创始人和企业主提供服务。
📧 info@raeofsunshineconsulting.co
🌐 raeofsunshineconsulting.co
---
*© 2026 Rae of Sunshine Consulting. 此仓库仅用于教育和参考目的。*
