GSC-MCP

远程MCP服务器，基于谷歌的完整数据导出（而非受限API），在Claude、ChatGPT和Cursor中提供Google Search Console数据。

域名： gsc2mcp.drossmedia.de · 运行环境： netcup Root Server，纽伦堡，前端使用Cloudflare

状态： 实施已开始。网络无关的核心逻辑已作为经过测试的包（core、analytics、db、gsc-client）以及MCP服务器（apps/app）和同步工作器（apps/worker）的框架就绪。网络层面的连接——MCP传输、OAuth提供者、谷歌集成——将在域名和GCP OAuth客户端就绪后，随路线图的第0/1阶段进行。

关于什么

Search Console API 限制严格：16个月历史记录，每次请求25,000行，每天每种搜索类型约50,000行。市场上每个工具都使用此API——包括那些随后存储数据的工具。它们存储的只是一个样本。

谷歌的批量数据导出没有这些限制：完整的搜索数据，每日更新，无API配额，可无限期保留。它所缺少的是其他一切——没有界面，没有分析，没有代理访问。

GSC-MCP正好填补了这一空白，并补充了一个确定性分析引擎：变化归因、季节性调整的异常检测、站点自身的点击率曲线、关键词自相蚕食的时间序列。这些数字是可验证的，而非估算的。

差异有多大是经过测量的：对于sc-domain:aip.aero，点击量最高的100个搜索查询占8.3%的点击量——约92%的情况超出了行数限制工具所能显示的范围。

Related MCP server: searchconsole-mcp

文档

架构概览

Claude / ChatGPT / Cursor
        │  Streamable HTTP + OAuth 2.1
        ▼
   Cloudflare (TLS, DDoS, WAF, Rate Limiting)
        │
        ▼
   netcup Root Server · Nürnberg
     Caddy → app (MCP + OAuth AS) · web · worker
     PostgreSQL 17 (Warehouse, pg-boss, Rate-Budget)
        │
        ├──▶ Search Console API      (einmaliger 16-Monats-Backfill)
        └──▶ BigQuery Bulk Export    (laufend, vollständig, ohne API-Quote)

第二个主机名 gsc2mcp-direct.drossmedia.de 在没有Cloudflare的情况下直接运行在服务器上——适用于那些采购不允许使用美国数据处理商的客户，以及在代理故障时的备用路径。

项目结构

Monorepo，npm工作区，TypeScript严格模式，Vitest。

规范DDL位于 packages/db/migrations/0001_init.sql，并针对真实PostgreSQL进行验证；docs/03 对其进行了说明。

开发

npm install
npm run typecheck   # tsc --build über alle Packages
npm test            # Vitest über packages/*/test und apps/*/test

CI（GitHub Actions）还针对真实PostgreSQL检查迁移、概念文档（链接、一致性）以及两种主题下的概览页面。参见 docs/10-repo-struktur.md 和 CLAUDE.md。

下一步

关键路径不是代码，而是针对敏感范围 webmasters.readonly 的谷歌OAuth验证——这通常需要数周时间，并且需要域名和隐私政策。详情见 docs/02-auth.md 和 docs/09-roadmap.md。

在第2阶段之前，还需要决定批量数据导出发送到哪里——是发送到客户的BigQuery项目还是我们的项目。权衡见 docs/12-wettbewerb-usp.md。