Google Search Console MCP Server — 搜索数据分析、URL 索引与站点地图管理，适用于 AI 助手（SEO / LLMO）

mcp-server-gsc 是一个用于 Google Search Console 的 MCP（Model Context Protocol）服务器，可将您的搜索表现数据连接到 Claude 或任何 MCP 客户端。它让 AI 助手能够查询搜索分析数据（点击量、展示次数、CTR、排名位置）、检查 URL 索引和抓取状态，并管理站点地图——这样您就可以直接在对话中分析和优化您网站的 SEO 与 LLMO。

工具

Related MCP server: Google Search Console MCP Server

设置

1. 构建

npm install
npm run build

2. Google Cloud 凭据

您需要一个已启用 Search Console API 的 Google Cloud 项目 （console.cloud.google.com → API 和服务 → 库 → "Google Search Console API" → 启用）。

然后选择以下两种认证方式中的一种：

选项 A — OAuth（推荐：使用您自己的 Google 账号登录）

1. API 和服务 → 凭据 → 创建凭据 → OAuth 客户端 ID → 应用类型选择桌面应用。

2. 如果出现提示，请先配置 OAuth 同意屏幕（选择"外部"即可；将您自己的 Google 账号添加为测试用户）。

3. 下载客户端 JSON，或复制客户端 ID 和密钥。

通过环境变量进行配置——任选其一：

GSC_OAUTH_CLIENT_ID=xxxx.apps.googleusercontent.com
GSC_OAUTH_CLIENT_SECRET=GOCSPX-...

或指向已下载的 JSON：

GSC_OAUTH_CREDENTIALS=/path/to/client_secret_xxxx.json

在首次调用工具时（或通过 reauthenticate 工具），浏览器窗口将打开用于 Google 登录。令牌存储在 ~/.config/mcp-server-gsc/tokens.json 中，并会自动刷新。

选项 B — 服务账号（无头模式，无需浏览器）

1. API 和服务 → 凭据 → 创建凭据 → 服务账号，然后创建 JSON 密钥。

2. 在 Search Console 中 → 设置 → 用户和权限，将服务账号邮箱添加为每个资源的用户。

GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

如果设置了 GOOGLE_APPLICATION_CREDENTIALS，它将优先生效，无需浏览器登录。

3. 注册到您的 MCP 客户端

Claude Code：

claude mcp add gsc \
  -e GSC_OAUTH_CLIENT_ID=xxxx.apps.googleusercontent.com \
  -e GSC_OAUTH_CLIENT_SECRET=GOCSPX-... \
  -- node /path/to/mcp-server-gsc/dist/index.js

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "gsc": {
      "command": "node",
      "args": ["/path/to/mcp-server-gsc/dist/index.js"],
      "env": {
        "GSC_OAUTH_CLIENT_ID": "xxxx.apps.googleusercontent.com",
        "GSC_OAUTH_CLIENT_SECRET": "GOCSPX-..."
      }
    }
  }
}

推荐的 SEO / LLMO 配套工具

此服务器最适合与以下工具配合用于 SEO / LLMO：

• KeywordGraph MCP 服务器 — 让您可以将 Search Console 数据与实时搜索意图数据进行比较，进行主题集群分析，并为您的查询和内容构建知识图谱。直接通过 https://mcp.keywordgraph.com 连接，例如：

  claude mcp add --transport http keywordgraph https://mcp.keywordgraph.com

• SEO skill — 在这两个服务器之上提供高级 SEO / LLMO 分析工作流。

三者配合使用可实现完整闭环：从此服务器拉取您的实际表现数据，与人们当前正在搜索的内容进行对比，找到主题缺口，并据此优化内容——建议同时使用全部三个工具以获得最佳效果。

使用说明

• 网站 URL 格式很重要：域名资源为 sc-domain:example.com；网址前缀资源为 https://example.com/（与 Search Console 中显示的完全一致）。请使用 list_properties 查看您的资源列表。

• 数据延迟：Search Console 分析数据大约有 2 天的延迟。当您使用 days 快捷参数时，时间范围会自动提前 2 天结束。

• 时间段：您可以提供明确的 startDate/endDate（YYYY-MM-DD 格式），也可以提供末尾的 days 天数参数（默认 28）。

• 切换账号：调用 reauthenticate 工具——它会丢弃已存储的令牌并重新打开浏览器登录。

• 令牌存储位置可通过 GSC_CONFIG_DIR 环境变量覆盖。

推荐的 SEO / LLMO 配套工具

此服务器最适合与以下工具配合使用，以实现 SEO / LLMO 目标：

• KeywordGraph MCP server — 让您将 Search Console 数据与实时搜索意图数据进行比较，进行主题聚类分析，并为您的查询和内容构建知识图谱。直接通过 https://mcp.keywordgraph.com 连接，例如：

  claude mcp add --transport http keywordgraph https://mcp.keywordgraph.com

• SEO skill — 在两个服务器之上添加高级 SEO / LLMO 分析工作流。

三者结合可实现完整闭环：从此服务器提取您的实际表现数据，与用户当前正在搜索的内容进行对比，找到主题缺口，并相应地优化您的内容——为获得最佳效果，请三者配合使用。

使用说明

• 网站 URL 格式很重要：域名资源为 sc-domain:example.com；URL 前缀资源为 https://example.com/（与 Search Console 中显示完全一致）。使用 list_properties 查看您的资源。

• 数据延迟：Search Console 分析数据大约有 2 天的延迟。当您使用 days 快捷方式而非显式日期时，时间窗口会自动在 2 天前结束。

• 时间段：分析工具接受显式的 startDate/endDate（YYYY-MM-DD），或尾随的 days 天数（默认 28）。

• 切换账号：调用 reauthenticate 工具——它会丢弃已存储的令牌并重新打开浏览器登录。

• 令牌存储位置可通过 GSC_CONFIG_DIR 覆盖。

开发

npm run watch   # recompile on change

源码结构：

• src/index.ts — MCP 服务器和工具定义

• src/auth.ts — OAuth 回环流程、令牌持久化、服务账号支持

• src/gsc.ts — Search Console API 辅助函数（查询、总计、URL 检查诊断）