Google搜索控制台连接器

@AminForou/mcp-gsc

0 Stars 413 次浏览 AminForou 更新于 2026-08-23

将Google搜索控制台与Claude AI连接起来，使SEO专业人士能够通过自然语言对话分析其SEO数据，提供对网站属性信息、搜索分析、URL检查和站点地图管理的访问。

搜索工具浏览器自动化

该服务暂未提供标准配置，请参考 README 手动接入

服务介绍

面向 SEO 专业人士的 Google Search Console MCP 服务器

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

该工具有哪些功能适用于 SEO 专业人士？

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

可用工具

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

您可以请求的内容	它的作用	您需要提供的内容
`list_properties`	显示所有您的GSC属性	无需提供任何信息 - 直接询问即可！
`get_site_details`	显示特定站点的详细信息	您的网站URL
`add_site`	将新站点添加到您的GSC属性中	您的网站URL
`delete_site`	从您的GSC属性中移除一个站点	您的网站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

要查看全部19个可用工具及其详细描述的完整列表，在设置完成后请让Claude执行"list tools"命令。

开始使用（无需编程经验！）

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

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

认证选项

该工具支持两种认证方法：

1. OAuth认证（推荐）

这种方法允许您用自己的Google账户进行认证，通常比使用服务账号更为方便。它将能够访问与您平时相同的资源。

将GSC_SKIP_OAUTH设置为 "true", "1", 或 "yes" 以跳过OAuth认证并仅使用服务账号认证

设置指南：

前往 Google Cloud Console，如果您还没有 Google Cloud 账户，请创建一个
创建一个新项目或选择一个现有项目
为您的项目启用 Search Console API
将范围 https://www.googleapis.com/auth/webmasters 添加到您的项目中
转到 "Credentials" 页面
点击 "Create Credentials" 并选择 "OAuth client ID"
配置 OAuth 同意屏幕
对于应用程序类型，选择 "Desktop app"
给您的 OAuth 客户端命名并点击 "Create"
下载客户端密钥 JSON 文件（文件名类似于 client_secrets.json）
将此文件放在与脚本相同的目录中，或者设置 GSC_OAUTH_CLIENT_SECRETS_FILE 环境变量指向其位置

当您第一次使用 OAuth 认证运行工具时，它将打开浏览器窗口要求您登录您的 Google 账户并授权该应用程序。授权后，工具会保存令牌供将来使用。

2. 服务账号认证

这种方法使用服务账号，适用于自动化脚本或不想使用个人 Google 账户的情况。这需要在 Google Search Console 中将服务账号添加为用户。

设置说明：

前往 Google Cloud Console，如果您还没有 Google Cloud 账户，请创建一个
创建一个新项目或选择一个现有项目
为您的项目启用 Search Console API
转到 "Credentials" 页面
点击 "Create Credentials" 并选择 "Service Account"
填写服务账号详细信息并点击 "Create"
点击刚刚创建的服务账号
转到 "Keys" 标签页并点击 "Add Key" > "Create new key"
选择 JSON 格式并点击 "Create"
下载密钥文件，并将其保存为 service_account_credentials.json 放在与脚本相同的目录中，或者设置 GSC_CREDENTIALS_PATH 环境变量指向其位置
将您的服务账号电子邮件地址添加到适当的 Search Console 属性中

🎬 观看这个适合初学者的 YouTube 教程：

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

2. 安装所需软件

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

Python (版本 3.11 或更高) - 用于运行 GSC 和 Claude 之间的连接
Node.js - 用于运行 MCP 检查器和某些 MCP 组件
Claude Desktop - 你将与之聊天的 AI 助手

请确保 Python 和 Node.js 已正确安装并添加到系统路径中，然后再继续。

3. 下载 Google Search Console MCP

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

点击此页面顶部的绿色“Code”按钮
选择“Download ZIP”
将下载的文件解压缩到一个容易找到的位置（例如你的文档文件夹）

或者，如果你熟悉 Git：

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

4. 安装必需组件

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

导航到你解压缩文件的文件夹：

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

创建虚拟环境（这可以将项目依赖项隔离）：
```
# 使用 uv（推荐）:
uv venv .venv

# 如果未安装 uv，请先安装它：
pip install uv
# 然后创建虚拟环境：
uv venv .venv

# 或者使用标准 Python：
python -m venv .venv
```
注意： 如果在尝试安装 uv 时遇到“pip not found”错误，请参阅下面的“如果遇到 'pip not found' 错误”部分。

激活虚拟环境：

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

# 在 Windows 上：
.venv\Scripts\activate

安装所需的依赖项：

# 使用 uv：
uv pip install -r requirements.txt

# 或者使用标准 pip：
pip install -r requirements.txt

如果遇到 "pip not found" 错误：

# 首先确保已安装并更新 pip：
python3 -m ensurepip --upgrade
python3 -m pip install --upgrade pip

# 然后再次尝试安装依赖项：
python3 -m pip install -r requirements.txt

# 或者安装 uv：
python3 -m pip install uv

当你看到命令提示符前有 (.venv) 时，表示虚拟环境已激活，并且依赖项将安装在此环境中，不会影响你的系统 Python 安装。

5. 将 Claude 连接到 Google Search Console

如果尚未下载并安装 Claude Desktop，请先下载并安装
确保你已将 Google 服务帐户凭据文件保存在计算机上的某个位置
打开你的计算机终端（Mac）或命令提示符（Windows），然后输入：

   # For Mac users:
   nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
   
   # For Windows users:
   notepad %APPDATA%\Claude\claude_desktop_config.json

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

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

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

服务帐户身份验证

{
  "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",
        "GSC_SKIP_OAUTH": "true"
      }
    }
  }
}

重要： 请将所有路径替换为你计算机上的实际位置。

第一个路径应指向虚拟环境中的 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

保存文件：
- Mac: 按下 Ctrl+O，然后按 Enter，再按 Ctrl+X 退出
- Windows: 点击文件 > 保存，然后关闭记事本
重启 Claude Desktop
当 Claude 打开时，您现在应该可以在工具部分看到 GSC 工具

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

现在您可以向 Claude 询问关于您的 GSC 数据的问题了！Claude 不仅可以检索数据，还可以对其进行分析、解释趋势，并创建可视化图表来帮助您更好地理解您的 SEO 表现。

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

工具名称	示例提示
`list_properties`	"列出我所有的GSC属性，并告诉我哪些属性索引的页面最多。"
`get_site_details`	"分析mywebsite.com的验证状态，并解释所有权详情的意义。"
`add_site`	"将我的新网站https://mywebsite.com添加到Search Console并验证其状态。"
`delete_site`	"从Search Console中移除旧测试站点https://test.mywebsite.com。"
`get_search_analytics`	"显示mywebsite.com在过去30天内排名前20的搜索查询，突出显示点击率低于2%的任何查询，并建议标题改进。"
`get_performance_overview`	"为mywebsite.com创建过去28天的可视化性能概览，识别任何异常下降或上升，并解释可能的原因。"
`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结合多种工具并分析结果。例如：

您可以请求Claude组合使用多个工具并对结果进行分析。例如：

"找出流量最高的前20个着陆页，检查它们的索引状态，并创建一份报告，突出显示那些既有高流量又有索引问题的页面。"
"分析过去90天内我的网站性能趋势，确定增长最快的查询，并检查相应的着陆页是否有任何技术问题。"
"比较桌面端与移动端的搜索表现，用图表可视化差异，并根据性能差距推荐需要进行移动端优化的具体页面。"
"找出排名在第2页（位置11-20）且展示次数高但点击率低的查询，然后检查相应的URL并建议标题和元描述的改进。"

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

数据可视化能力

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

趋势图：查看指标随时间的变化
对比图：比较不同的时间段或维度
性能分布：了解您的内容在不同位置上的表现
相关性分析：识别不同指标之间的关系
热力图：通过颜色编码表示复杂的数据集

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

故障排除

Python 命令未找到

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

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

创建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

验证别名是否有效：
```
python --version
```

这样做会创建一个符号链接，这样当应用程序调用python时，实际上会使用您的python3安装。

Claude配置问题

如果您连接遇到困难：

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

其他意外问题

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

复制你收到的确切错误消息
使用 ChatGPT 或 Claude 并详细说明你的问题，包括：
- 你尝试做什么
- 确切的错误消息
- 你的操作系统
- 你已经尝试过的任何步骤
AI 助手通常能够通过针对你的情况提出具体的解决方案来帮助诊断和解决技术问题

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

贡献

发现了错误或有改进建议？我们欢迎你的参与！在 GitHub 上打开一个 issue 或提交一个 pull request。

许可证

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

查看源码项目主页