Skip to main content
Glama
rachel-growthlever

gsc-mcp

gsc-mcp

一个免费、开源的 Model Context Protocol 服务器,让 Claude(或任何其他 MCP 客户端——ChatGPT、Codex、Cursor)直接、只读地访问你的 Google Search Console 数据:搜索分析(点击/展示/CTR/位置)、站点地图状态和 URL 检查。

由 GrowthLever 构建,因为作为一名营销人员,我不喜欢 Google 产品的界面——包括 Search Console、GA4 和 Ads。这让我可以在原始数据之上构建自己的转换层,直接向 Claude 询问洞察,而不是在 Google 的界面中翻找。它是免费的,因为工具本身不是产品——我在其上运行的工作流才是(见本页底部)。

自带 Google 凭据

这完全在你的机器上运行,使用你在自己的 Google Cloud 账户中创建的 Google OAuth 客户端。你的刷新令牌永远不会离开你的磁盘,也没有任何 Search Console 数据会经过 GrowthLever 运营的服务器。无需与我们创建账户,无需注册任何东西,也无需信任我们。完整细节请参阅 SECURITY.md 和 PRIVACY.md。

Related MCP server: google-search-console-mcp-server

它提供什么

四个只读工具:

Tool

What it does

list_sites

列出授权账户可以访问的 GSC 属性

search_analytics

点击/展示/CTR/位置,可按查询、页面、国家、设备、日期筛选

list_sitemaps

已提交的站点地图及其状态/错误

inspect_url

单个 URL 的索引覆盖、规范 URL 和抓取详情

这里没有任何操作可以更改 Search Console 设置或提交/删除任何内容——每次调用都是 GET 或只读的 query/inspect 请求。

开始使用

QUICKSTART.md —— 10 分钟设置,大部分时间在等待 Google 的控制台。简短版:

npx -y @growthlever/gsc-mcp auth --credentials ~/Downloads/client_secret.json
npx -y @growthlever/gsc-mcp doctor

然后将你的 Claude 配置指向 npx -y @growthlever/gsc-mcp(示例见 examples/claude-desktop-config.json),并向它提问——参见 PROMPTS.md 获取入门提示包,分为从零开始的创始人和优化有效内容的规模化企业。

有问题?先运行 gsc-mcp doctor,然后查看 TROUBLESHOOTING.md。

本地开发

npm install
node bin/gsc-mcp.js auth --credentials <path to client_secret.json>
node bin/gsc-mcp.js doctor
node bin/gsc-mcp.js            # runs the MCP server over stdio
node test/smoke.js             # spawns the server and verifies tool registration

文档

  • QUICKSTART.md —— 从开始到完成的设置

  • PROMPTS.md —— 入门提示包

  • SECURITY.md —— 它涉及什么、不能做什么、如何撤销访问权限

  • PRIVACY.md —— 收集了什么(没有)以及谁看到你的数据

  • TROUBLESHOOTING.md —— 常见 Google/OAuth 错误的通俗修复方法

  • examples/ —— Claude Desktop 和 Codex CLI 的配置,以及每周回顾提示模板

为什么这是免费的

我是一名兼职增长负责人——我接触的大多数创始人和运营者都是从零开始,他们进入商业领域并不是为了学习营销。早期最好的举措几乎总是打好有机基础,同时让推荐和口碑完成其余部分,因为还没有付费预算。规模化企业面临不同的问题:弄清楚哪些页面和内容真正有效,以便加倍投入而不是猜测。

无论哪种情况,障碍通常不是数据访问——Search Console 是免费的——而是将数据转化为“下一步该做什么”。这正是这个工具加上一个像样的提示所做的事情。我把工具免费送出去,因为工具本身并不难构建;对输出结果做出判断才是真正的价值所在,这也是我为订阅者撰写和深入探讨的内容。

如果你想要应用层——按用例划分的提示包、每周回顾和客户报告模板,以及围绕此构建的创始人/规模化工作流——那在 Substack 上(订阅者内容)。

许可证

MIT。分叉它、自托管它、在此基础上构建。

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    Read-only MCP server for Google Search Console data, enabling search analytics, URL inspection, indexing diagnostics, and sitemap management through MCP clients.
    11 npm
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Enables MCP clients to query Google Search Console search performance, inspect indexing, analyze sitemaps, and run SEO analyses such as cannibalisation detection, query clustering, and wins/losses, all with read-only access.
    20
    68 npm
    Apache 2.0
  • A
    license
    A
    quality
    B
    maintenance
    Enables read-only access to Google Search Console data, including property discovery, search analytics queries, and URL inspection, through a security-focused interface.
    3
    30 PyPI
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Enables read-only access to Google Search Console data, including properties, Search Analytics with filters and auto-pagination, sitemaps, and URL inspection with batch support and throttling.
    5
    47 PyPI
    MIT