mcp-server-gsc
Wraps the Google Search Console API (search analytics, sites, sitemaps, URL inspection — all 9 methods) in 15 tools for SEO analytics: search analytics queries with automatic pagination up to 25,000 rows and regex/page/country/device filters, quick-win detection (impressions/CTR/position with High/Medium/Low grading), period-over-period comparison with deltas, keyword cannibalization detection, single and batched URL index inspection, and site and sitemap management (list, details, add, delete, submit).
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mcp-server-gsc — Servidor MCP para Google Search Console
Servidor de Model Context Protocol (MCP) para Google Search Console, escrito en TypeScript: expone la API de GSC como herramientas que un cliente MCP (Claude Desktop, agentes LLM, MCP Inspector…) puede invocar directamente — analítica de búsqueda con hasta 25 000 filas y filtros regex, detección de quick wins, canibalización de keywords, comparación de periodos e inspección de indexación en lote.
Características
15 herramientas MCP que cubren el 100 % de la API de Search Console (9/9 métodos): search analytics, sites, sitemaps y URL inspection.
Analítica SEO incluida: quick wins (impresiones/CTR/posición con gradación High/Medium/Low), comparación de periodos con deltas, detección de canibalización, inspección de URLs en lote (acotada a la cuota de la API).
Paginación automática:
rowLimithasta 25 000 filas encadenandostartRow.Filtros avanzados: regex sobre la dimensión
query(includingRegex/excludingRegex), filtros por página, país y dispositivo.Tres transportes: stdio (escritorio), HTTP/SSE con Bearer auth obligatorio (Docker/Code Engine) y Cloudflare Workers.
Núcleo neutral de plataforma: los entrypoints solo adaptan transporte; la lógica vive en
src/lib/y no leeprocess.envni bindings.
Related MCP server: gsc-mcp-connector
Herramientas
list_sites · get_site_details · add_site · delete_site · search_analytics · enhanced_search_analytics · detect_quick_wins · compare_periods · detect_cannibalization · index_inspect · batch_index_inspection · list_sitemaps · get_sitemap · submit_sitemap · delete_sitemap
Instalación y uso
pnpm install && pnpm run build # compila a dist/ (Node >= 20)stdio (Claude Desktop, Smithery):
GOOGLE_JSON_KEY='<service-account JSON>' node dist/entrypoints/stdio.jsHTTP/SSE (Docker, Code Engine):
GOOGLE_JSON_KEY='<service-account JSON>' MCP_API_TOKEN='<token>' PORT=8080 node dist/entrypoints/server-http.js
# GET /health (sin auth) · /mcp exige Authorization: Bearer <MCP_API_TOKEN> (sin token responde 503)Cloudflare Workers: wrangler deploy con el binding GOOGLE_CREDENTIALS.
Credenciales (orden de precedencia): GOOGLE_JSON_KEY (cadena JSON) → GOOGLE_APPLICATION_CREDENTIALS (ruta a keyfile) → credentials.json en el directorio de trabajo. Scope completo webmasters: las herramientas de escritura (add_site, delete_site, submit_sitemap, delete_sitemap) operan sobre la propiedad real.
Verificación
pnpm test # batería unitaria de la analítica pura (node:test vía tsx)
pnpm test:types # tsc sobre tests + producto
pnpm exec tsc --noEmit
pnpm run build # solo a petición explícitaSeguridad
Dependencia transitiva
buffer-equal-constant-timesustituida por un fork local (patches/, activo por doble vía npm/pnpm) que usacrypto.timingSafeEqualsin manipularBuffer.prototype.Auditoría SCA del árbol resuelto (235 paquetes) con el escáner CVE de
mcp-cves: 77 CVEs detectados → 31 residuales tras remediación, 0 en el catálogo KEV de CISA y 0 con arma pública; los residuales son transitivos de googleapis/wrangler con riesgo aceptado y documentado.Sin secretos en el repositorio:
.env,.env.*ycredentials.jsonignorados desde el primer commit; hook pre-commit que bloquea workboard inválido,.envy patrones de secretos.
Navegación del proyecto
Este repositorio se navega como un árbol de contratos: empieza por AGENTS.md → docs/ARCHITECTURE.md (mapa central, leyes y tabla de ruteo) y desciende por los contratos de cada nodo. El trabajo se gestiona en docs/workboard/ (claims atómicos, evidencia y cierre); los cambios de comportamiento se sincronizan con su contrato en la misma entrega.
Historial de cambios: CHANGELOG.md.
Licencia
MIT — J. Sebastián G. Sánchez
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only Google Search Console MCP server for AI assistants.
Hosted, read-only Google Search Console MCP: performance, comparisons, URL inspection, sitemaps.
Unified 15-tool SEO, SERP, clean Markdown & GEO (LLM citation Share-of-Voice) MCP server.
Audit, rank-track and analyze SEO for sites via an authenticated MCP server.
Related MCP Servers
- AlicenseAqualityBmaintenanceOAuth-protected Google Search Console MCP for analytics, URL inspection, sitemap management, indexing requests, and SEO diagnostics. Open-source Cloudflare Workers implementation with 17 tools.17112 npm9MIT
- AlicenseNot gradedqualityNot gradedmaintenanceSelf-hosted Google Search Console MCP server deployable to Cloudflare Workers, allowing natural language queries of GSC data via ChatGPT, Claude, or any MCP-capable client.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceSelf-hosted Google Search Console MCP server deployable to Cloudflare Workers in 15 minutes. Enables querying GSC data (sites, search analytics, URL inspection, sitemaps) via natural language through MCP-capable clients like ChatGPT or Claude.MIT
- AlicenseNot gradedqualityCmaintenanceSelf-hosted Google Search Console MCP server deployable to Cloudflare Workers that enables querying GSC data (search analytics, URL inspection, sitemaps) via natural language through ChatGPT, Claude, or any MCP-capable client.1MIT