gsc-mcp-full Skill 技能

技能简介

gsc-mcp-full 是 Google Search Console 的完整 MCP 服务器：用自然语言问 Claude、Cursor、Windsurf、VS Code、Codex 等客户端关于搜索表现、收录与站点地图的问题，拿回的是分析结论而不是一张表格。它提供 37 个工具、覆盖 Search Console API 全部 10 个在线方法、6 种搜索类型（网页/图片/视频/新闻/Discover/Google News）、7 个维度（含小时级），支持 contains、精确、排除与正则过滤，并带 24 小时视图与小时粒度、突破 16 个月历史限制的本地同步、多语言拼写变体合并。

核心能力

• 搜索表现分析：performance_overview 一屏总览，compare_periods 对比上期/去年同期/52 周前，queries_for_page 与 pages_for_query 双向定位关键词与落地页。
• SEO 机会发现：striking_distance 找排名 8–20 有真实需求的词，find_cannibalization 识别多页争同一词的内耗，low_ctr_opportunities 挑首页低点击率结果，content_movers 找衰减与上升页面，brand_split 拆品牌与非品牌流量。
• 多语言情报：把被 Search Console 按拼写拆行的关键词合并出真实总量（波斯语、阿拉伯语、中日韩、土耳其语等），keyboard_mistypes 找键盘布局打错的搜索，top_terms 兼容无空格的中日泰分词。
• 无限历史：sync_history 把数据落到本地库，突破 Google 只留 16 个月的限制，history_query/trend/compare 任意跨期对比，history_sql 直接跑只读 SQL。
• 收录与站点地图：inspect_url 单页全量检查（索引状态、最近抓取、canonical、robots），inspect_urls 并行查 50 页，站点地图与属性的增删查齐全。
• 可靠与安全：默认只读（写操作需 GSC_ALLOW_WRITE=1），限流自动重试，表头合计为真实周期总数而非行求和，117 个自动化测试覆盖三平台。

安装配置

1. 申请凭据：在 Google Cloud Console 建项目 → 启用 Search Console API → 创建「桌面应用」OAuth 客户端并下载 JSON；在同意屏幕点「发布应用」，否则 7 天掉线。服务器/团队场景可改用服务账号，无需浏览器登录。
2. 接入客户端：安装 uv 后在 MCP 配置里加 {"mcpServers": {"search-console": {"command": "uvx", "args": ["gsc-mcp-full"], "env": {"GSC_CREDENTIALS_PATH": "/path/client_secret.json"}}}}；Claude Code 一条命令 claude mcp add search-console -e GSC_CREDENTIALS_PATH=... -- uvx gsc-mcp-full。
3. 登录与自检：uvx gsc-mcp-full auth 浏览器完成登录，uvx gsc-mcp-full doctor 列出你的站点属性确认连通。
4. 可选项：GSC_TIMEZONE 按本地时区切日，GSC_LANG 设常用查询语言；偏好 pip 可 pip install gsc-mcp-full。

使用步骤

1. 准备 Google 凭据 JSON，把路径写进 GSC_CREDENTIALS_PATH 并完成一次 auth 登录。
2. 在 Claude Desktop、Cursor、Windsurf、VS Code 或 Codex 中注册该 MCP 服务器，重启客户端。
3. 用自然语言提问，例如「列出我的 Search Console 属性，再给 example.com 的表现总览」，客户端自动挑选工具。
4. 需要长期分析时执行 sync_history 同步历史到本地，之后跨年对比与 SQL 查询均不触网。
5. 每周复盘可让 AI 跑「总览 + 变化 + 三个最佳机会」的组合，直接产出可执行的 SEO 结论。

适用场景

• SEO 周报自动化：总览、异动与机会一键成表，替代手动导出 CSV 再透视。
• 内容迭代决策：用 striking distance 与低点击率报告决定先改哪些标题、先补哪些页面。
• 多语言站点核查：合并被拆行的拼写变体，得到中亚、中东、东亚语言的真实关键词总量与语言占比。
• 收录故障排查：批量并行检查 URL 索引与结构化数据状态，快速圈出问题页与配额余量。
• 跨年趋势对比：本地历史库让「今年 Q3 对比两年前 Q3」在 Google 删数之后仍可执行。

适用人群

负责站点搜索表现的 SEO 从业者与内容营销人员；需要把 Search Console 数据接进 AI 工作流的增长团队；服务多客户、多站点的咨询顾问；管理多语言站点、被拼写变体和 16 个月留存困扰的数据分析人员；希望在本地保留数据、拒绝托管服务的隐私敏感用户。

工作原理

服务器以 stdio/HTTP 方式被 MCP 客户端拉起，用你本机的 OAuth 或服务账号凭据直连 Google Search Console API，登录信息不离开你的机器。37 个工具按 8 组组织，每个工具封装一个或多个 API 端点并做参数校验、限流退避与并行调度：查询类工具在返回前完成拼写变体合并与真实合计计算；sync_history 把每日数据增量写入本地文件库，历史类工具优先读本地、不再触网；URL 检查在时间预算内并行执行最多 50 页。失败一律以「错误 + 原因」形式返回，绝不伪装成空结果。AI 客户端不直接调用这些工具，而是根据你的自然语言问题按工具描述挑选合适的入口并解读返回的短表格。

官方链接

• PyPI 主页：https://pypi.org/project/gsc-mcp-full/
• GitHub 仓库：https://github.com/mamrrez/gsc-mcp-full
• 完整文档：https://mamrrez.github.io/gsc-mcp-full/
• 项目主页：https://hasanpour.com/tools/gsc-mcp-full/