GSC MCP para Google Search Console.
mcp-gsc conecta Google Search Console con Claude, ChatGPT, Cursor u otro cliente MCP. Consulta consultas, páginas, rendimiento, sitemaps e inspecciones de URL con Google OAuth.
- Modo recomendado
- Read-only
- Autenticación
- Google OAuth
- Opciones
- npm / Worker
- Licencia
- MIT
npm · Google Search Console MCP
Instala GSC MCP en local con npm
npm inicia un servidor Streamable HTTP en tu equipo. Antes necesitas configurar Google OAuth y las credenciales; no es una conexión de un solo clic.
1. Prepara el acceso a Google
Node.js ^22.18.0 / >=24.11.0+npm- Usa una cuenta de Google con acceso a la propiedad de Search Console que quieras analizar.
- Crea un cliente OAuth en Google Cloud, habilita las API necesarias y registra la URI de redirección local exacta.
- Configura estas tres variables de entorno siguiendo la guía de esta versión. TOKEN_ENCRYPTION_KEY debe ser base64 válido de exactamente 32 bytes aleatorios.
GOOGLE_CLIENT_IDGOOGLE_CLIENT_SECRETTOKEN_ENCRYPTION_KEY
Registra esta URI exacta en Google Cloud. Deben coincidir host, puerto y ruta; localhost y 127.0.0.1 no son intercambiables.
http://127.0.0.1:8080/google/callback localhost ≠ 127.0.0.1
2. Inicia el servidor local
Con las credenciales configuradas en la terminal, ejecuta el paquete npm. Para análisis, elige el ajuste de solo lectura de tu shell.
El valor predeterminado es readwrite. Para analítica, establece readonly antes de autorizar Google; así no se registran las herramientas de escritura.
Terminal Bash / zsh
export GSC_ACCESS_MODE=readonly
npx -y @digestseo/mcp-gscPowerShell
$env:GSC_ACCESS_MODE = 'readonly'
npx -y @digestseo/mcp-gscEndpoint local · Streamable HTTP
http://127.0.0.1:8080/mcp 3. Conecta tu cliente MCP
Mantén el proceso en ejecución y conecta un cliente del mismo ordenador al endpoint Streamable HTTP; no es un servidor stdio.
Claude Code
claude mcp add --transport http gsc http://127.0.0.1:8080/mcpConectar Codex CLI / IDE
codex mcp add gsc --url http://127.0.0.1:8080/mcpCursor
En Cursor, añade un servidor MCP Streamable HTTP llamado gsc con esta URL (Cursor local).
http://127.0.0.1:8080/mcp ChatGPT / Claude.ai
ChatGPT y Claude en la nube no pueden acceder al 127.0.0.1 de tu equipo. Usa tu Worker HTTPS o un túnel MCP seguro compatible, según los permisos de tu cuenta.
¿Prefieres acceso remoto?¿Prefieres acceso remoto?
Sigue disponible el despliegue propio en Cloudflare Workers, con configuración de Cloudflare y Google OAuth. El ejemplo inferior usa Bash; consulta SETUP.md para todos los pasos.
Información
¿Qué es mcp-gsc?
mcp-gsc es un servidor Model Context Protocol autoalojable que conecta tu cliente de IA directamente con la API oficial de Google Search Console.
Ejecuta el paquete npm localmente mediante HTTP en loopback o despliega tu propio Worker de Cloudflare con un endpoint HTTPS. Ambas opciones usan Google OAuth.
El lanzador local guarda el estado cifrado en ~/.mcp-gsc/state de forma predeterminada; el Worker usa el almacenamiento de tu cuenta de Cloudflare. No es un conector alojado por DigestSEO.
Importa el informe Web: multimodal de Search Console y revisa páginas, impresiones y clics. No es un buscador de imágenes. Analizador SEO de Google Lens y búsqueda multimodal.
Compara la visibilidad de tus cuentas autorizadas en la Búsqueda de Google. No mide me gusta, seguidores ni visualizaciones dentro de las redes. Compara el rendimiento de tus redes sociales en Google.
Herramientas
Capacidades del servidor
Herramientas específicas cubren estadísticas, inspección de URL, sitemaps, indexación, diagnósticos SEO y el resumen semanal.
La lista incluye herramientas de escritura opcionales. GSC_ACCESS_MODE=readonly expone solo herramientas sin modificaciones; la Indexing API de Google se limita a tipos de contenido admitidos.
get_capabilitiesLista las capacidades disponibles y el estado de la autenticación.
list_sitesLista las propiedades de Search Console accesibles para la cuenta conectada.
query_search_analyticsConsulta clics, impresiones, CTR y posiciones para un intervalo de fechas personalizado.
inspect_urlObtiene el informe de inspección de URL en vivo y los detalles de indexación.
list_sitemapsLista los sitemaps enviados con su estado de rastreo y advertencias.
add_siteAñade una propiedad de Search Console a la cuenta conectada.
delete_siteElimina una propiedad de Search Console de la cuenta.
submit_sitemapEnvía un sitemap para una propiedad de Search Console.
delete_sitemapElimina un sitemap enviado de una propiedad.
get_sitemapObtiene el estado detallado de un sitemap enviado.
identify_quick_winsEncuentra consultas con muchas impresiones posicionadas entre los puestos 8 y 20.
detect_cannibalizationEncuentra consultas por las que compiten varias páginas.
detect_content_decayIdentifica las páginas con mayor caída de clics de búsqueda.
request_indexingSolicita la indexación a través de la API de indexación de Google. Actualmente, esta API está restringida a páginas con datos estructurados JobPosting o páginas de transmisión en vivo con BroadcastEvent dentro de VideoObject. No está disponible para el envío general de páginas web.
list_indexed_pagesLista las páginas que han recibido impresiones en Search Console.
compare_performanceCompara clics, impresiones, CTR y posiciones entre dos periodos.
weekly_digestGenera un informe SEO semanal en lenguaje claro.
Despliegue
¿Prefieres acceso remoto?
Sigue disponible el despliegue propio en Cloudflare Workers, con configuración de Cloudflare y Google OAuth. El ejemplo inferior usa Bash; consulta SETUP.md para todos los pasos.
git clone https://github.com/AKzar1el/mcp-gsc.git
cd mcp-gsc && npm install
npx wrangler login
cp wrangler.example.jsonc wrangler.jsonc
npx wrangler deployDale una estrella al repositorio y lleva Search Console a Claude.
Código abierto y autoalojable. Sigue la guía de Google OAuth o despliega tu propio Worker.