GSC-MCP

Remote-MCP-Server, который делает данные Google Search Console доступными в Claude, ChatGPT и Cursor — на основе полного экспорта данных Google вместо ограниченного API.

Домен: gsc2mcp.drossmedia.de · Хостинг: netcup Root Server, Нюрнберг, с Cloudflare перед ним

Статус: Разработка начата. Сете-независимая базовая логика реализована в виде протестированных пакетов (core, analytics, db, gsc-client) вместе с каркасом для MCP-сервера (apps/app) и sync-воркера (apps/worker). Сетевая связка — MCP-транспорт, OAuth-провайдер, интеграция с Google — будет реализована в Phase 0/1 дорожной карты, как только появятся домен и GCP OAuth-клиент.

О чём речь

API Search Console сильно ограничено: 16 месяцев истории, 25 000 строк на запрос, около 50 000 строк в день на тип поиска. Абсолютно каждый инструмент на рынке использует этот API — даже те, которые затем сохраняют данные. Они сохраняют выборку.

Bulk Data Export от Google не имеет этих ограничений: полные данные о поиске, ежедневно, без квоты API, неограниченное хранение. Чего ему не хватает — это всего остального: нет интерфейса, нет анализа, нет доступа для агентов.

GSC-MCP закрывает именно этот пробел и дополняется детерминированной аналитической системой: атрибуция изменений, обнаружение аномалий с учётом сезонности, собственные кривые CTR для сайта, временные ряды каннибализации. Цифры воспроизводимы, а не оценочны.

Насколько велика разница, было измерено: для 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 напрямую на сервере — для клиентов, чьи закупки не допускают использование американского обработчика данных, и как запасной путь при сбое прокси.

Структура проекта

Монорепозиторий, npm Workspaces, TypeScript strict, 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.

Следующие шаги

Критический путь — это не код, а верификация OAuth Google для чувствительной области webmasters.readonly — она обычно занимает несколько недель и требует наличия домена и политики конфиденциальности. Подробности в docs/02-auth.md и docs/09-roadmap.md.

До фазы 2 также необходимо решить, куда будет доставляться Bulk Data Export — в проект BigQuery клиента или в наш. Анализ представлен в docs/12-wettbewerb-usp.md.