将 Search Console 数据带到你的助手中。
mcp-gsc 将 Google Search Console 连接到 Claude、ChatGPT、Cursor 或其他 MCP 客户端。通过 Google OAuth 查询搜索词、页面、表现、网站地图和 URL 检查。
- 推荐模式
- Read-only
- 认证方式
- Google OAuth
- 运行方式
- npm / Worker
- 许可证
- MIT
npm · Google Search Console MCP
使用 npm 在本地安装 GSC MCP
npm 会在你的电脑上启动 Streamable HTTP 服务器。运行前必须配置 Google OAuth 和凭据；这不是一键连接。
1. 准备 Google 访问权限
Node.js ^22.18.0 / >=24.11.0+npm- 使用有权访问目标 Search Console 资源的 Google 账号。
- 在 Google Cloud 创建 OAuth 客户端、启用所需 API，并准确登记本地重定向 URI。
- 按照对应版本的指南设置这三个环境变量。TOKEN_ENCRYPTION_KEY 必须是恰好 32 个随机字节的有效 base64 编码。
GOOGLE_CLIENT_IDGOOGLE_CLIENT_SECRETTOKEN_ENCRYPTION_KEY
必须在 Google Cloud 准确注册此 URI。主机、端口和路径必须完全匹配；localhost 与 127.0.0.1 不同。
http://127.0.0.1:8080/google/callback localhost ≠ 127.0.0.1
2. 启动本地服务器
在终端配置好凭据后运行 npm 包。若只分析数据，请使用与你的 shell 对应的只读设置。
启动器默认使用 readwrite。仅分析时请在 Google 授权前设置 readonly，此时不会注册写入工具。
Bash / zsh 命令
export GSC_ACCESS_MODE=readonly
npx -y @digestseo/mcp-gscPowerShell
$env:GSC_ACCESS_MODE = 'readonly'
npx -y @digestseo/mcp-gsc本地端点 · Streamable HTTP
http://127.0.0.1:8080/mcp 3. 连接 MCP 客户端
保持启动器运行，从同一台电脑上的客户端连接本地 Streamable HTTP 端点；这不是 stdio 服务器。
Claude Code
claude mcp add --transport http gsc http://127.0.0.1:8080/mcp连接 Codex CLI / IDE
codex mcp add gsc --url http://127.0.0.1:8080/mcpCursor
在本地 Cursor 中添加名为 gsc 的 Streamable HTTP MCP 服务器，并填入此 URL。
http://127.0.0.1:8080/mcp ChatGPT / Claude.ai
云端 ChatGPT 和 Claude 无法访问你电脑的 127.0.0.1。请根据账号权限使用自己的 HTTPS Worker 或可用的安全 MCP 隧道。
需要远程访问？需要远程访问？
仍可自行部署 Cloudflare Workers，但需要配置 Cloudflare 和 Google OAuth。下方示例使用 Bash；完整步骤请查看 SETUP.md。
产品介绍
什么是 mcp-gsc？
mcp-gsc 是一个可自行托管的 Model Context Protocol 服务器，可将 AI 客户端直接连接到官方 Google Search Console API。
npm 包可通过本机回环 HTTP 运行，也可以自行部署 Cloudflare Worker 提供远程 HTTPS 端点。两者都使用 Google OAuth。
本地启动器默认在 ~/.mcp-gsc/state 保存加密会话状态；Worker 使用你自己的 Cloudflare 账号存储。这并非 DigestSEO 托管的连接服务。
导入 Web: multimodal 搜索效果数据，查看各页面展示次数、点击次数和点击率。这不是以图搜图或图片压缩工具。 Google Lens 多模态搜索分析工具.
比较你有权限管理的社交账号在 Google 搜索中的表现，而非平台内点赞、粉丝或播放量。 社交内容 Google 搜索表现对比工具.
工具
服务器功能
工具覆盖分析、URL 检查、网站地图、索引、SEO 诊断和每周表现摘要。
工具列表包含可选的写入功能。GSC_ACCESS_MODE=readonly 只开放不修改数据的工具；Google Indexing API 仅支持特定内容类型。
get_capabilities列出可用功能和身份验证状态。
list_sites列出已连接账号可以访问的 Search Console 资源。
query_search_analytics按自定义日期范围查询点击、展示、CTR 和排名。
inspect_url获取实时 URL 检查报告和索引详情。
list_sitemaps列出已提交的网站地图及其抓取状态和警告。
add_site将 Search Console 资源添加到已连接账号。
delete_site从账号中移除 Search Console 资源。
submit_sitemap为 Search Console 资源提交网站地图。
delete_sitemap从资源中移除已提交的网站地图。
get_sitemap获取某个已提交网站地图的详细状态。
identify_quick_wins找到展示较高但排名在 8–20 位的查询。
detect_cannibalization找到多个页面争夺可见性的查询。
detect_content_decay找出搜索点击下降最多的页面。
request_indexing通过 Google 的索引编制 API 请求编入索引。该 API 目前仅限用于包含 JobPosting 结构化数据的页面，或在 VideoObject 中包含 BroadcastEvent 的直播页面，不适用于一般网页提交。
list_indexed_pages列出在 Search Console 中获得展示的页面。
compare_performance比较不同时间段的点击、展示、CTR 和排名。
weekly_digest生成易懂的每周 SEO 报告。
部署
需要远程访问？
仍可自行部署 Cloudflare Workers，但需要配置 Cloudflare 和 Google OAuth。下方示例使用 Bash；完整步骤请查看 SETUP.md。
git clone https://github.com/AKzar1el/mcp-gsc.git
cd mcp-gsc && npm install
npx wrangler login
cp wrangler.example.jsonc wrangler.jsonc
npx wrangler deploy