用于 SEO 的 Google Search Console MCP 服务器

这款工具将Google Search Console (GSC) 与 Claude AI 连接起来，让您能够通过自然语言对话分析 SEO 数据。通过此集成，您可以访问属性信息、搜索分析、URL 检查和站点地图管理——所有这些都只需与 Claude 进行简单的聊天即可完成。

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

1. 物业管理
   • 在一个地方查看您所有的 GSC 房产
   • 获取验证详情和基本站点信息
   • 向您的帐户添加新房产
   • 从您的帐户中移除属性
2. 搜索分析和报告
   • 了解哪些搜索查询会将访问者带到您的网站
   • 跟踪展示次数、点击次数和点击率
   • 分析随时间推移的性能趋势
   • 比较不同的时间段来发现变化
   • 使用 Claude 创建的图表和图形来可视化您的数据
3. URL 检查和索引
   • 检查特定页面是否存在索引问题
   • 查看 Google 上次抓取您的网页的时间
   • 一次检查多个 URL 以识别模式
   • 获取有关如何改进索引的可行见解
4. 网站地图管理
   • 查看所有站点地图及其状态
   • 直接通过 Claude 提交新的站点地图
   • 检查站点地图中的错误或警告
   • 监控站点地图处理状态

可用工具

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

要获得所有 19 种可用工具的完整列表及其详细描述，请在设置后要求 Claude“列出工具”。

入门（无需编码经验！）

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

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

身份验证选项

该工具支持两种身份验证方法：

1. OAuth 认证（推荐）

此方法允许您使用自己的 Google 帐户进行身份验证，这通常比使用服务帐户更方便。它将可以访问您通常使用的相同资源。

将GSC_SKIP_OAUTH设置为“true”、“1”或“yes”以跳过 OAuth 身份验证并仅使用服务帐户身份验证

设置说明：

1. 如果您还没有 Google Cloud 帐户，请前往Google Cloud Console并创建一个
2. 创建新项目或选择现有项目
3. 为您的项目启用 Search Console API
4. 将范围https://www.googleapis.com/auth/webmasters添加到您的项目
5. 前往“凭证”页面
6. 点击“创建凭证”并选择“OAuth 客户端 ID”
7. 配置 OAuth 同意屏幕
8. 对于应用程序类型，选择“桌面应用程序”
9. 为您的 OAuth 客户端命名并点击“创建”
10. 下载客户端机密 JSON 文件（它将被命名为client_secrets.json ）
11. 将此文件放在与脚本相同的目录中，或设置GSC_OAUTH_CLIENT_SECRETS_FILE环境变量以指向其位置

首次使用 OAuth 身份验证运行该工具时，它会打开一个浏览器窗口，要求您登录 Google 帐户并授权该应用程序。授权后，该工具将保存令牌以供将来使用。

2. 服务账户认证

此方法使用服务帐户，这对于自动化脚本或您不想使用个人 Google 帐户的情况非常有用。这需要在 Google Search Console 中将服务帐户添加为用户。

设置说明：

1. 如果您还没有 Google Cloud 帐户，请前往Google Cloud Console并创建一个
2. 创建新项目或选择现有项目
3. 为您的项目启用 Search Console API
4. 前往“凭证”页面
5. 点击“创建凭证”并选择“服务帐户”
6. 填写服务帐户详细信息并点击“创建”
7. 点击新创建的服务帐户
8. 转到“密钥”选项卡，然后单击“添加密钥”>“创建新密钥”
9. 选择JSON格式并点击“创建”
10. 下载密钥文件并将其保存为service_account_credentials.json ，放在与脚本相同的目录中，或者设置GSC_CREDENTIALS_PATH环境变量以指向其位置
11. 将您的服务帐户电子邮件地址添加到相应的 Search Console 属性

🎬 在 Youtube 上观看这个适合初学者的教程：

点击上方图片观看分步视频教程

2.安装所需软件

您需要在计算机上安装这些工具：

• Python （3.11 或更新版本）- 用于运行 GSC 和 Claude 之间的连接
• Node.js - 运行 MCP 检查器和某些 MCP 组件所需
• Claude Desktop - 与您聊天的人工智能助手

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

3. 下载 Google Search Console MCP

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

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

或者，如果您熟悉 Git：

4.安装所需组件

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

1. 导航到解压缩文件的文件夹：
   # Example (replace with your actual path): cd ~/Documents/mcp-gsc-main
2. 创建虚拟环境（这可以使项目依赖关系保持隔离）：
   # Using uv (recommended): uv venv .venv # If uv is not installed, install it first: pip install uv # Then create the virtual environment: uv venv .venv # OR using standard Python: python -m venv .venv
   **注意：**如果您在尝试安装 uv 时收到“pip not found”错误，请参阅下面的“如果收到‘pip not found’错误”部分。
3. 激活虚拟环境：
   # On Mac/Linux: source .venv/bin/activate # On Windows: .venv\Scripts\activate
4. 安装所需的依赖项：
   # Using uv: uv pip install -r requirements.txt # OR using standard pip: pip install -r requirements.txt
   如果出现“pip not found”错误：
   # First ensure pip is installed and updated: python3 -m ensurepip --upgrade python3 -m pip install --upgrade pip # Then try installing the requirements again: python3 -m pip install -r requirements.txt # Or to install uv: python3 -m pip install uv

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

5. 将 Claude 连接到 Google Search Console

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

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

OAuth 身份验证（使用您自己的帐户）

服务帐户身份验证

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

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

例子：

• 苹果：
  • Python 路径： /Users/yourname/Documents/mcp-gsc/.venv/bin/python
  • 脚本路径： /Users/yourname/Documents/mcp-gsc/gsc_server.py
• 视窗：
  • 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桌面
7. 当 Claude 打开时，您现在应该在工具部分看到可用的 GSC 工具

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

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

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

你也可以让 Claude 组合多种工具并分析结果。例如：

• “按流量查找我的前 20 个目标网页，检查其索引状态，并创建一份报告，突出显示任何流量高且索引有问题的网页。”
• “分析我网站过去 90 天的性能趋势，找出增长最快的查询，并检查相应的目标网页是否存在任何技术问题。”
• “比较我的桌面搜索和移动搜索性能，用图表直观地展示差异，并根据性能差距推荐需要移动优化的特定页面。”
• “确定我在第 2 页（排名 11-20）排名的查询，这些查询具有较高的展示次数但较低的点击率，然后检查相应的 URL 并提出标题和元描述改进建议。”

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

数据可视化功能

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

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

在分析数据时，只需要求 Claude“可视化”或“创建图表”，它就会生成适当的可视化效果，以帮助您更好地理解信息。

故障排除

未找到 Python 命令

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

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

1. 创建 Python 别名（一次性设置）：
   # For macOS users: sudo ln -s $(which python3) /usr/local/bin/python # If that doesn't work, try finding your Python installation: 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. 人工智能助手通常可以通过针对你的情况提出具体的解决方案来帮助诊断和解决技术问题

请记住，大多数问题以前都已被其他人遇到过，并且通常都有一个简单的解决方案。

贡献

发现了错误或有改进想法？欢迎您提供宝贵意见！在 GitHub 上创建问题或提交拉取请求。

执照

本项目遵循 MIT 许可证。详情请参阅LICENSE文件。