面向 SEO 的 Google Search Console MCP 服务器

一个将 Google Search Console (GSC) 与 Claude AI 连接的工具，使您可以通过自然语言对话分析您的 SEO 数据。此集成使您可以通过与 Claude 的简单聊天访问属性信息、搜索分析、URL 检查和站点地图管理。

---

此工具能为 SEO 专业人士做什么？

1. 属性管理

   • 在一个地方查看您的所有 GSC 属性
   • 获取验证详细信息和基本站点信息

2. 搜索分析与报告

   • 发现哪些搜索查询为您的网站带来访问者
   • 跟踪展示次数、点击次数和点击率
   • 分析一段时间内的性能趋势
   • 比较不同的时间段以发现变化
   • 使用 Claude 创建的图表和图形可视化您的数据

3. URL 检查与索引

   • 检查特定页面是否存在索引问题
   • 查看 Google 上次抓取您的页面的时间
   • 一次检查多个 URL 以识别模式
   • 获取有关如何改进索引的可操作见解

4. 站点地图管理

   • 查看您的所有站点地图及其状态
   • 直接通过 Claude 提交新的站点地图
   • 检查站点地图中的错误或警告
   • 监控站点地图处理状态

---

可用工具

以下是设置此集成后您可以要求 Claude 执行的操作：

您可以要求的内容	它做什么	您需要提供的内容
list_properties	显示您的所有 GSC 属性	无需任何操作 - 只需提问！
get_site_details	显示有关特定站点的详细信息	您的网站 URL
get_search_analytics	显示具有指标的热门查询和页面	您的网站 URL 和时间段
get_performance_overview	提供站点性能的摘要	您的网站 URL 和时间段
check_indexing_issues	检查页面是否存在索引问题	您的网站 URL 和要检查的页面列表
inspect_url_enhanced	特定 URL 的详细检查	您的网站 URL 和要检查的页面
get_sitemaps	列出您网站的所有站点地图	您的网站 URL
submit_sitemap	向 Google 提交新的站点地图	您的网站 URL 和站点地图 URL

有关所有 17 个可用工具及其详细说明的完整列表，请在设置后要求 Claude "list tools"。

---

入门（无需编码经验！）

1. 设置 Google Search Console API 访问权限

在使用此工具之前，您需要创建 API 凭据，允许 Claude 访问您的 GSC 数据：

1. 如果您没有 Google Cloud 帐户，请创建一个并访问 Google Cloud Console
2. 设置服务帐户（类似于用于 API 访问的特殊用户）
3. 下载凭据文件（JSON 文件）
4. 授予此服务帐户访问您的 GSC 属性的权限

🎬 在 Youtube 上观看此初学者友好的教程：

<div align="center"> <a href="https://youtu.be/PCWsK5BgSd0"> <img src="https://i.ytimg.com/vi/PCWsK5BgSd0/maxresdefault.jpg" alt="Google Search Console API Setup Tutorial" width="600" style="margin: 20px 0; border-radius: 8px;"> </a> </div>

单击上面的图像观看分步视频教程

2. 安装所需的软件

您需要在您的计算机上安装以下工具：

• Python（3.11 或更高版本）- 这运行 GSC 和 Claude 之间的连接
• Node.js - 运行 MCP 检查器和某些 MCP 组件所必需
• Claude Desktop - 您将与之聊天的 AI 助手

在继续之前，请确保 Python 和 Node.js 都已正确安装并在您的系统路径中可用。

3. 下载 Google Search Console MCP

您需要将此工具下载到您的计算机。最简单的方法是：

1. 单击此页面顶部的绿色“Code”按钮
2. 选择“Download ZIP”
3. 将下载的文件解压缩到您可以轻松找到的位置（例如您的 Documents 文件夹）

或者，如果您熟悉 Git：

git clone https://github.com/AminForou/mcp-gsc.git

4. 安装所需的组件

打开您计算机的终端（Mac）或命令提示符（Windows）：

1. 导航到您解压缩文件的文件夹：

   # 示例（替换为您实际的路径）：
   cd ~/Documents/mcp-gsc-main
   

2. 创建一个虚拟环境（这使项目依赖项隔离）：

   # 使用 uv（推荐）：
   uv venv .venv
   
   # 如果未安装 uv，请先安装它：
   pip install uv
   # 然后创建虚拟环境：
   uv venv .venv
   
   # 或者使用标准 Python：
   python -m venv .venv
   

   注意： 如果您在尝试安装 uv 时收到“pip not found”错误，请参阅下面的“如果您收到 'pip not found' 错误”部分。

3. 激活虚拟环境：

   # 在 Mac/Linux 上：
   source .venv/bin/activate
   
   # 在 Windows 上：
   .venv\Scripts\activate
   

4. 安装所需的依赖项：

   # 使用 uv：
   uv pip install -r requirements.txt
   
   # 或者使用标准 pip：
   pip install -r requirements.txt
   
   # 如果您遇到 MCP 包的任何问题，请单独安装它：
   pip install mcp
   

   如果您收到“pip not found”错误：

   # 首先确保 pip 已安装并更新：
   python3 -m ensurepip --upgrade
   python3 -m pip install --upgrade pip
   
   # 然后再次尝试安装 requirements：
   python3 -m pip install -r requirements.txt
   
   # 或者安装 uv：
   python3 -m pip install uv
   

当您在命令提示符的开头看到 (.venv) 时，表示虚拟环境已激活，并且依赖项将安装在那里，而不会影响您的系统 Python 安装。

5. 将 Claude 连接到 Google Search Console

1. 如果您尚未下载并安装 Claude Desktop
2. 确保您的 Google 服务帐户凭据文件已保存在您计算机上的某个位置
3. 打开您计算机的终端（Mac）或命令提示符（Windows）并键入：

   # 对于 Mac 用户：
   nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
   
   # 对于 Windows 用户：
   notepad %APPDATA%\Claude\claude_desktop_config.json

4. 添加以下文本（这告诉 Claude 如何连接到 GSC）：

   {
     "mcpServers": {
       "gscServer": {
         "command": "/FULL/PATH/TO/-main/.venv/bin/python",
         "args": ["/FULL/PATH/TO/mcp-gsc-main/gsc_server.py"],
         "env": {
           "GSC_CREDENTIALS_PATH": "/FULL/PATH/TO/service_account_credentials.json"
         }
       }
     }
   }
   

   重要提示： 将所有路径替换为您计算机上的实际位置：

   • 第一个路径应指向您的虚拟环境中的 Python 可执行文件
   • 第二个路径应指向您解压缩的文件夹中的 gsc_server.py 文件
   • 第三个路径应指向您的 Google 服务帐户凭据 JSON 文件

   示例：

   • Mac：
     • Python 路径：/Users/yourname/Documents/mcp-gsc/.venv/bin/python
     • 脚本路径：/Users/yourname/Documents/mcp-gsc/gsc_server.py
   • Windows：
     • Python 路径：C:\\Users\\yourname\\Documents\\mcp-gsc\\.venv\\Scripts\\python.exe
     • 脚本路径：C:\\Users\\yourname\\Documents\\mcp-gsc\\gsc_server.py

5. 保存文件：

   • Mac：按 Ctrl+O，然后按 Enter，然后按 Ctrl+X 退出
   • Windows：单击文件 > 保存，然后关闭记事本

6. 重新启动 Claude Desktop

7. 当 Claude 打开时，您现在应该在工具部分看到可用的 GSC 工具

6. 开始分析您的 SEO 数据！

现在您可以向 Claude 询问有关您的 GSC 数据的问题！ Claude 不仅可以检索数据，还可以分析数据、解释趋势并创建可视化效果，以帮助您更好地了解您的 SEO 性能。

以下是一些您可以与每个工具一起使用的强大提示：

工具名称	示例提示
list_properties	"列出我的所有 GSC 属性，并告诉我哪些属性的索引页面最多。"
get_site_details	"分析 mywebsite.com 的验证状态，并解释所有权详细信息意味着什么。"
get_search_analytics	"显示过去 30 天内 mywebsite.com 的前 20 个搜索查询，突出显示点击率低于 2% 的任何查询，并建议标题改进。"
get_performance_overview	"创建过去 28 天内 mywebsite.com 的可视化性能概述，识别任何异常下降或峰值，并解释可能的原因。"
check_indexing_issues	"检查这些重要页面是否存在索引问题，并确定哪些页面需要立即关注：mywebsite.com/product、mywebsite.com/services、mywebsite.com/about"
inspect_url_enhanced	"对 mywebsite.com/landing-page 进行全面检查，并提供可操作的建议以改善其索引状态。"
batch_url_inspection	"检查我的前 5 个产品页面，识别常见的抓取或索引模式，并建议技术 SEO 改进。"
get_sitemaps	"列出 mywebsite.com 的所有站点地图，识别任何包含错误的站点地图，并推荐后续步骤。"
list_sitemaps_enhanced	"分析 mywebsite.com 的所有站点地图，重点关注错误模式，并创建优先级排序的行动计划。"
submit_sitemap	"在 https://mywebsite.com/product-sitemap.xml 提交我的新产品站点地图，并解释 Google 通常需要多长时间来处理它。"
get_sitemap_details	"检查 mywebsite.com/sitemap.xml 上我的主站点地图的状态，并解释警告对我的 SEO 意味着什么。"
get_search_by_page_query	"哪些搜索词正在将流量引导到我的博客文章 mywebsite.com/blog/post-title？ 确定优化相关关键字的机会。"
compare_search_periods	"比较我网站在一月和二月之间的表现。哪些查询改进最多，哪些查询下降，以及可能解释这些变化的原因是什么？"
get_advanced_search_analytics	"分析我的移动搜索性能，针对展示次数高但排名低于 10 的查询，并建议内容改进以帮助它们获得更好的排名。"

您还可以要求 Claude 组合多个工具并分析结果。例如：

• "查找我流量最高的前 20 个着陆页，检查它们的索引状态，并创建一个报告，突出显示同时具有高流量和索引问题的任何页面。"

• "分析我网站在过去 90 天内的性能趋势，识别我增长最快的查询，并检查相应的着陆页是否存在任何技术问题。"

• "比较我的桌面与移动搜索性能，使用图表可视化差异，并根据性能差距推荐需要移动优化的特定页面。"

• "识别我在第 2 页（位置 11-20）上排名的查询，这些查询具有高展示次数但低点击率，然后检查相应的 URL 并建议标题和元描述改进。"

Claude 将使用 GSC 工具来获取数据，以易于理解的格式呈现数据，在有帮助时创建可视化效果，并根据结果提供可操作的见解。

---

数据可视化功能

Claude 可以帮助您以各种方式可视化您的 GSC 数据：

• 趋势图：查看指标如何随时间变化
• 比较图：比较不同的时间段或维度
• 性能分布：了解您的内容在各个位置的表现
• 相关性分析：识别不同指标之间的关系
• 热图：使用颜色编码的表示形式可视化复杂的数据集

只需在分析数据时要求 Claude "visualize" 或 "create a chart"，它将生成适当的可视化效果，以帮助您更好地理解信息。

---

故障排除

Python 命令未找到

在 macOS 上，默认的 Python 命令通常是 python3 而不是 python，这可能会导致某些应用程序（包括 Node.js 集成）出现问题。

如果您遇到与找不到 Python 相关的错误，您可以创建一个别名：

1. 创建一个 Python 别名（一次性设置）：

   # 对于 macOS 用户：
   sudo ln -s $(which python3) /usr/local/bin/python
   
   # 如果这不起作用，请尝试查找您的 Python 安装：
   sudo ln -s /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 /usr/local/bin/python
   

2. 验证别名是否有效：

   python --version
   

这将创建一个符号链接，以便当应用程序调用 python 时，它们实际上将使用您的 python3 安装。

Claude 配置问题

如果您在连接时遇到问题：

1. 确保您的配置中的所有文件路径都正确并使用完整路径
2. 检查您的服务帐户是否有权访问您的 GSC 属性
3. 在进行任何更改后重新启动 Claude Desktop
4. 当您尝试使用工具时，查找 Claude 响应中的错误消息
5. 确保在手动运行服务器时激活了您的虚拟环境

其他意外问题

如果您在安装或使用过程中遇到任何其他意外问题：

1. 复制您收到的确切错误消息
2. 使用 ChatGPT 或 Claude 并详细解释您的问题，包括：
   • 您尝试做什么
   • 确切的错误消息
   • 您的操作系统
   • 您已经尝试过的任何步骤
3. AI 助手通常可以通过为您的具体情况建议特定的解决方案来帮助诊断和解决技术问题

请记住，大多数问题以前都遇到过，并且通常有可用的简单解决方案。

---

贡献

发现错误或有改进的想法？ 我们欢迎您的意见！ 在 GitHub 上打开一个问题或提交一个拉取请求。

---

许可证

本项目根据 MIT 许可证获得许可。 有关详细信息，请参阅 LICENSE 文件。