Wingate SEO MCP

开源、自托管的 Google Search Console + Google Analytics 4 MCP 服务器，适用于 ChatGPT 和其他 MCP 客户端。无需再为另一个 SEO 仪表板付费，即可分析您自己的 SEO 数据。

Wingate SEO MCP 将 MCP 客户端连接到您已控制的 Google 资源。它将 Search Console 效果、GA4 互动、站点地图和 URL 检查证据、周期比较以及确定性 SEO 诊断整合到一个只读服务中。

发布者：Wingnut Innovations
版本：0.5.1
许可证：MIT

为什么使用它？

• 用自然语言询问有关您自己的 GSC 和 GA4 数据的问题。

• 将凭据和资源映射保留在您控制的基础设施上。

• 用可复现的证据和计算取代重复的仪表板工作。

• 检查事件活动、着陆页互动、CTR 机会、排名变化、衰减和关键词蚕食。

• 从一个刻意保持小规模、只读的安全边界开始。

您提供自己的 Google 凭据，并仅授予该身份访问您想要分析的资源的权限。Wingate SEO MCP 不包含托管账户、捆绑的 Google 访问权限、付费门槛、遥测、广告或订阅。

Related MCP server: Google SEO MCP

只读 MCP 工具

公共服务器恰好暴露 11 个工具：

公共服务器中没有 Search Console、Google Indexing、GA4 Admin、站点地图提交或其他写入工具。

GA4 报告质量诊断

GA4 结果包含报告诊断，作为返回数据的证据。Google 可能应用阈值化或抽样，高基数维度可能被分组到 (other) 行中。有界工具响应还会在更多行可用时报告，而资源配额详情仅供参考。这些注意事项并不能证明跟踪是正确的或完整的，Wingate SEO MCP 也无法绕过 Google 的报告行为。

ga4_overview 可以选择性地添加会话级流量获取证据，而无需增加另一个 MCP 工具：

{
  "siteKey": "example-site",
  "days": 28,
  "includeAcquisition": true,
  "acquisitionLimit": 25
}

默认概览不发出获取请求，并返回 acquisition: null。启用后，acquisition 按会话默认渠道组和会话来源/媒介对行进行分组，使用与概览相同的日期范围和 googleOrganicOnly 范围，并限制为 1-100 行。其 reportDiagnostics 暴露截断、阈值化、抽样和配额注意事项；GA4 获取归因不等同于 Search Console 归因。

要求

• Node.js 20、22 或 24

• npm

• 一个启用了所需 API 的 Google Cloud 项目

• 用户提供的 Google 服务账户 JSON 凭据，具有对您的 GSC 和 GA4 资源的访问权限

• 一个可以访问本地 Streamable HTTP 端点的 MCP 客户端

快速开始

git clone https://github.com/aitradesniper-blip/wingate-seo-mcp-public.git wingate-seo-mcp
cd wingate-seo-mcp
npm install

使用 .env.example 作为模板，并在启动命令的 shell 中设置相同的环境变量。项目不会自动加载 .env。将下载的服务账户 JSON 保留在存储库之外。

GOOGLE_SERVICE_ACCOUNT_FILE=/absolute/path/to/google-service-account.json
WINGATE_SITES_FILE=./config/sites.local.json

由 npm start 启动的 MCP 运行时需要显式的服务账户凭据。设置 GOOGLE_SERVICE_ACCOUNT_FILE（首选）、GOOGLE_APPLICATION_CREDENTIALS 或 GOOGLE_SERVICE_ACCOUNT_JSON。它不会回退到附加的 Google Cloud 元数据/工作负载身份。

验证凭据并发现可访问的资源：

npm run doctor
npm run discover:google

使用发现返回的资源生成一个被忽略的本地站点注册表：

npm run setup -- --output config/sites.local.json \
  --gsc sc-domain:example.com \
  --ga4 123456789 \
  --origin https://example.com \
  --key example-site \
  --name "Example Site"

运行有界实时读取，然后启动服务器：

npm run live:smoke -- --site example-site --inspect-origin
npm start

默认端点是：

http://127.0.0.1:3000/healthz
http://127.0.0.1:3000/mcp

有关详细演练，请参阅 Google 设置 和 实时入门。

Google API 设置

在您的 Google Cloud 项目中启用这些 API：

• Google Search Console API

• Search Console URL Inspection API

• Google Analytics Data API

• Google Analytics Admin API

授予服务账户电子邮件对每个 Search Console 资源的访问权限，并至少授予对每个 GA4 资源的查看者访问权限。运行时仅请求：

• https://www.googleapis.com/auth/webmasters.readonly

• https://www.googleapis.com/auth/analytics.readonly

Analytics Admin API 仅用于发现可访问的 GA4 资源和 Web 数据流。MCP 服务器不会修改 GA4 Admin 设置。

站点映射

每个本地注册表条目将一个稳定的 siteKey 映射到一个 Search Console 资源、一个可选的 GA4 资源以及站点的来源。复制 config/sites.example.json 以了解格式，或让 npm run setup 生成并验证 config/sites.local.json。

本地注册表被 Git 忽略。如果存储库读者不应知道您运营哪些站点，切勿提交真实的资源映射。

连接 MCP 客户端

启动服务器，并将支持 Streamable HTTP 的 MCP 客户端指向本地 /mcp 端点。使用客户端支持的本地连接或独立审查的传输边界。此存储库不附带 Internet 隧道或身份验证层。

在发送数据之前，检查工具发现并确认恰好有 11 个工具，并且每个工具都标记为只读。请参阅 MCP 客户端连接。

示例问题

• “本月哪些页面失去了点击次数？”

• “查找排名在 4–20 且 CTR 较弱的查询。”

• “哪些自然着陆页互动最好？”

• “我的潜在客户事件触发了吗？”

• “将最近 28 天与之前 28 天进行比较。”

隐私与安全

Wingate SEO MCP 没有未披露的遥测。它不会向 Wingnut Innovations 或任何第三方发送使用分析。

数据仅在以下情况下离开您的机器或服务器：

• 连接器使用您配置的凭据和资源访问权限调用 Google API；或

• 您配置的 MCP 客户端向此服务器发送请求并接收结果。

服务器默认绑定到 127.0.0.1。除非添加独立审查的身份验证和传输边界，否则不要直接将其暴露到公共互联网。不要将凭据、本地注册表或命令输出放入提示或源代码控制中。请参阅 SECURITY.md。

故障排除

• 凭据文件不可读： 使用绝对路径并将 JSON 保留在存储库之外。

• Google 返回 403： 启用相关 API 并授予服务账户电子邮件对资源的访问权限。

• 未找到 GA4 资源： 至少授予查看者访问权限，然后重新运行 npm run doctor。

• 映射不明确： 显式提供 --ga4；发现过程绝不会静默选择弱匹配。

• 没有事件行： GA4 在该日期/过滤器范围内未观察到匹配行；仅凭缺失并不能诊断埋点。

• MCP 客户端无法连接： 确认 npm start、/healthz、回环绑定以及客户端的本地网络或单独保护的传输配置。

开发与验证

npm run ci

这将运行语法检查、TypeScript 检查、单元/集成测试、生产构建和 MCP 发现。CI 针对 Node.js 20、22 和 24。

Docker 打包有意推迟，直到准备好一个小型、可审查的镜像和非 root 运行时策略；Node/npm 自托管路径是 v0.5.0 基线。

路线图与支持

请参阅 路线图。Wingate SEO MCP 是免费且开源的。如果它为您节省了时间或 SEO 工具订阅费用，您可以选择支持持续开发。v0.5.0 中未配置任何资金提供者。

许可证、来源与独立性

Wingate SEO MCP 根据 MIT 许可证 授权。选定的 Google 客户端和方法映射是从 UPSTREAM.md、UPSTREAM_IMPORT_MANIFEST.json 和 THIRD_PARTY_NOTICES.md 中记录的固定 MIT 许可上游改编并大幅重写的。

Wingate SEO MCP 是由 Wingnut Innovations 发布的独立项目。它与 Google 或 OpenAI 无关联、未获其认可，也未受其赞助。Google Search Console、Google Analytics、GA4、ChatGPT 和 OpenAI 是其各自所有者的商标。