mcp-gsc MCP — 使用场景, 安装 & 实时演示

为什么要用

核心特性

20 个工具覆盖资源、分析、URL 检查、站点地图
比较时间段：周环比、按查询/页面/国家分解
URL 检查：索引状态和抓取问题
OAuth 或服务账号 — 适应个人或团队架构

实时演示

实际使用效果

gsc.replay ▶ 就绪

0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "gsc",
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ]
    }
  ]
}

Continue 使用服务器对象数组，而非映射。

~/.config/zed/settings.json

{
  "context_servers": {
    "gsc": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-gsc"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add gsc -- uvx mcp-gsc

一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。

使用场景

实战用法： mcp-gsc

用 mcp-gsc 生成周 SEO 报告

👤 SEO 经理、内容团队 ⏱ ~15 min beginner

何时使用： 周一早晨 — 在晨会前你想看上周的表现总结。

前置条件

访问该资源的 GSC 权限 — search.google.com/search-console
OAuth 凭据或服务账号 — console.cloud.google.com — 启用 Search Console API

步骤

提取热门查询和变化

对于 acme.com，上周 vs 前一周的排名前 20 的查询。显示点击数、CTR、排名变化。✓ 已复制

→ 变化表格
提取热门着陆页变化

点击数变化最大的前 10 个页面（上升或下降）。✓ 已复制

→ 赢家和输家列表
起草总结

为团队会议写一个 5 点摘要，对表现最差的页面提出行动项。✓ 已复制

→ 可直接粘贴的报告

结果： 10 分钟内完成周一报告。

搭配使用： google-sheets

审计整个网站的索引问题

👤 技术 SEO ⏱ ~30 min intermediate

何时使用： 流量下降，你想知道 Google 是否仍在索引应该索引的内容。

步骤

抽样顶部页面

从上月排名前 50 的着陆页中，通过 inspect_url_enhanced 检查每个 URL 的索引状态。✓ 已复制

→ 各 URL 状态：已索引/已抓取但未索引/已排除
聚类问题

按问题类型分组。对于'已抓取但未索引'，常见的模式是什么？✓ 已复制

→ 按集群诊断

结果： 与真实 GSC 结果相关联的优先级修复列表。

验证站点地图健康状态和提交状态

👤 任何发布新页面的人 ⏱ ~10 min beginner

何时使用： 你刚发布了新页面 — 检查 Google 是否获取了站点地图。

步骤

列出站点地图

获取 acme.com 的站点地图。显示最后读取日期和错误计数。✓ 已复制

→ 站点地图健康列表
重新提交过期的站点地图

对于 7 天内未被读取的站点地图，重新提交。✓ 已复制

→ 已提交

结果： 确保 Google 看到了新内容。

从 GSC 中挖掘排名机会

👤 处于增长阶段的 SEO ⏱ ~40 min intermediate

何时使用： 你想找排名在 11-20 位且接近第 1 页的查询。

步骤

找到近似失败的查询

过去 90 天内平均排名在 11-20 位之间且展现次数 > 100 的查询。返回相应的着陆页。✓ 已复制

→ 目标列表
按工作量排列优先级

对于前 20 个，检查着陆页 — 它已经针对查询进行了优化吗？如果没有，建议页面上的更改。✓ 已复制

→ 权重考虑工作量的机会列表

结果： 基于你的真实 GSC 数据的优先级 SEO 待办项。

搭配使用： firecrawl

组合

与其他 MCP 搭配，撬动十倍杠杆

gsc + google-sheets

自动生成的周 SEO 报告直接放入共享工作表

每周一，运行我的周 SEO 报告并追加到'SEO Weekly'工作表。✓ 已复制

gsc + firecrawl

为你的目标查询抓取竞争对手排名页面

对于 GSC 中的每个近似失败查询，找到排名最高的 SERP 页面（通过 firecrawl），并总结为什么它们的排名优于我的。✓ 已复制

工具

此 MCP 暴露的能力

工具	输入参数	何时调用	成本
list_properties		发现你有权访问的资源	1 API call
get_search_analytics	site, start_date, end_date, dimensions[], filters?, row_limit?	主力查询工具	1 API call
inspect_url_enhanced	site, url	单 URL 索引调试	1 API call
get_sitemaps	site	站点地图健康状态	1 API call
submit_sitemap	site, feedpath	促使 Google 重新抓取	1 API call

成本与限制

运行它的成本

API 配额: GSC API：每个项目 1200 QPM，每个网站 6000 QPD
每次调用 Token 数: 分析结果每次调用最多 25k 行 — 在转储前分块
费用: 免费
提示: 使用 row_limit 和过滤器；一次性导出前 10k 查询会破坏 AI 助手的上下文

安全

权限、密钥、影响范围

最小权限： https://www.googleapis.com/auth/webmasters.readonly

凭据存储： 环境变量中的 GSC_OAUTH_CLIENT_SECRETS_FILE 或 GSC_CREDENTIALS_PATH

数据出站： searchconsole.googleapis.com

切勿授予： webmasters (full)

故障排查

常见错误与修复

403 用户没有权限

OAuth 账号或服务账号必须是该资源在 GSC 中的已验证用户。在设置 → 用户下添加

分析响应为空

GSC 有 2-3 天的数据延迟；end_date > today - 3 可能为空。另外：'Web'和'Discover'搜索类型不同

OAuth 流程循环

client_secrets.json 中的重定向 URI 必须完全匹配（包括 http://localhost 端口）

替代方案

mcp-gsc 对比其他方案

替代方案	何时用它替代	权衡
GSC 网页 UI	临时手动工作	没有自动化，没有报告循环
Ahrefs/SEMrush APIs	你想要第三方排名追踪，而不是 Google 的数据	付费；不同的数据集

mcp-gsc