GSC-MCP

Servidor MCP remoto que pone los datos de Google Search Console a disposición de Claude, ChatGPT y Cursor — basado en la exportación completa de datos de Google en lugar de la API limitada.

Dominio: gsc2mcp.drossmedia.de · Operación: Servidor root netcup, Núremberg, con Cloudflare al frente

Estado: Implementación iniciada. La lógica central independiente de la red ya está disponible como paquetes probados (core, analytics, db, gsc-client) junto con el esqueleto del servidor MCP (apps/app) y el worker de sincronización (apps/worker). El cableado de red — transporte MCP, proveedor OAuth, conexión con Google — llegará con la Fase 0/1 de la hoja de ruta, una vez que el dominio y el cliente OAuth de GCP estén listos.

De qué se trata

La API de Search Console tiene límites muy estrictos: 16 meses de historial, 25.000 filas por solicitud, alrededor de 50.000 filas por día y tipo de búsqueda. Cada herramienta del mercado utiliza esta API sin excepción — incluso aquellas que luego almacenan los datos. Almacenan una muestra.

La Exportación Masiva de Datos de Google no tiene ninguno de estos límites: datos de búsqueda completos, a diario, sin cuota de API, almacenamiento ilimitado. Lo que le falta es todo lo demás — sin interfaz, sin análisis, sin acceso para agentes.

GSC-MCP cierra exactamente esta brecha y añade un motor de análisis determinista: atribución de cambios, detección de anomalías ajustada estacionalmente, curvas de CTR propias del sitio, series temporales de canibalización. Los números son verificables, no estimados.

La magnitud de la diferencia está medida: en sc-domain:aip.aero, las 100 consultas con más clics representan solo el 8,3 % de los clics — aproximadamente el 92 % de la actividad está fuera del alcance de lo que muestra una herramienta con límite de filas.

Related MCP server: searchconsole-mcp

Documentación

Arquitectura en resumen

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)

Un segundo nombre de host gsc2mcp-direct.drossmedia.de se ejecuta sin Cloudflare directamente en el servidor — para clientes cuya adquisición no permite un procesador de pedidos estadounidense, y como ruta de emergencia en caso de fallo del proxy.

Estructura del proyecto

Monorepo, npm-workspaces, TypeScript strict, Vitest.

La DDL canónica se encuentra en packages/db/migrations/0001_init.sql y se valida contra PostgreSQL real; docs/03 la justifica.

Desarrollo

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

CI (GitHub Actions) verifica adicionalmente la migración contra un PostgreSQL real, los documentos conceptuales (enlaces, coherencia) y la página de resumen en ambos temas. Ver docs/10-repo-struktur.md y CLAUDE.md.

Próximos pasos

La ruta crítica no es el código, sino la verificación OAuth de Google para el ámbito sensible webmasters.readonly — generalmente toma varias semanas y requiere dominio y declaración de privacidad. Detalles en docs/02-auth.md y docs/09-roadmap.md.

Antes de la Fase 2 también hay que decidir a dónde envía la Exportación Masiva de Datos — al proyecto BigQuery del cliente o al nuestro. La ponderación está en docs/12-wettbewerb-usp.md.