Google Search Console Connector

Pregúntale a Claude sobre tus datos de Google Search Console. Inicio de sesión de Google con un clic (sin claves API), exportación CSV más allá del límite de 1,000 filas, inspección de URL, sitemaps y un panel de SEO local.

GitHub

Documentación

Conector de Google Search Console para Claude Code

Conecta cualquier proyecto web a Google Search Console desde Claude Code, Google Antigravity o cualquier cliente MCP. Inicia sesión con tu cuenta de Google una vez, luego pregúntale a Claude sobre clics, consultas, posiciones e indexación, descarga todos los informes de GSC como CSV con un solo comando, y haz un seguimiento de todo en un panel SEO local.

Es un servidor MCP de Search Console de código abierto, un exportador de informes GSC y un panel de control, y se ejecuta completamente en tu computadora. Sin configuración de Google Cloud, sin claves API: solo inicias sesión con Google.

Si te resulta útil, una ⭐ en GitHub ayuda a que otras personas lo encuentren.

Documentación y novedades: claude-repo.com/google-search-console-connector

Por qué existe esto

Si creas sitios con un agente de codificación de IA, obtener datos de Search Console normalmente implica iniciar sesión en search.google.com, hacer clic en Exportar, descargar los CSV y arrastrarlos al chat. Para cada sitio, cada vez.

Esta herramienta elimina esos pasos:

npx google-search-console-connector report

Ese único comando descarga los mismos informes que el botón Exportar de Search Console (Fechas, Consultas, Páginas, Países, Dispositivos, Apariencia en la búsqueda) además de comparaciones con el período anterior, pares consulta-página, mapas del sitio y un summary.md escrito para que Claude lo lea. Dentro de Claude Code ni siquiera lo escribes. Pide "descarga el informe de Search Console" y Claude ejecuta la herramienta gsc_export_report.

Características

Inicia sesión con Google. Un clic en tu navegador, usando el propio OAuth 2.0 de Google (PKCE). Sin proyecto de Google Cloud, claves API ni contraseñas.
Exportación GSC con un comando. Descarga informes CSV, JSON y Markdown para un sitio o todos tus sitios (--all-sites), para cualquier rango de hasta 16 meses.
Servidor MCP para Claude Code y Antigravity. 18 herramientas: datos de rendimiento, datos por hora, consultas de marca vs. no marca, Inspección de URL, mapas del sitio, agregar propiedades y verificar propiedad.
Panel SEO local. KPIs comparados con el período anterior, gráfico de tendencias (por hora, día, semana, mes), consultas, páginas, países, dispositivos, mapas del sitio e Inspección de URL. Temas claro y oscuro.
Oportunidades. Palabras clave a poca distancia (posiciones 4–20), páginas en la primera página con CTR bajo y consultas que están perdiendo clics.
Marca vs. no marca. Define tus términos de marca una vez; el panel, los informes y Claude pueden dividir el tráfico según ellos.
Notas en el gráfico. Claude puede marcar el gráfico cuando implementa cambios de SEO ("Reescribí los títulos de las páginas de servicios"), para que veas qué movió los números.
Verificación de sitios. Claude puede agregar un nuevo sitio a Search Console, poner la metaetiqueta de verificación en tu código y verificarlo después de que lo despliegues.
Actualizado con Google. Soporta las últimas funciones de la API de Search Console, incluidos datos por hora, Discover y Google News. Una verificación semanal señala nuevos campos de la API y anuncios de Search Central.
Privado por defecto. Los tokens y los datos de Search Console permanecen en tu máquina y solo van a Google. No hay servidor intermedio.

Inicio rápido

Necesitas Node.js 20 o más reciente y una cuenta de Google con acceso a Search Console.

1. Agrégalo a Claude Code (una vez, para todos tus proyectos):

claude mcp add gsc --scope user -- npx -y google-search-console-connector@latest

En Windows, envuelve npx en cmd /c:

claude mcp add gsc --scope user -- cmd /c npx -y google-search-console-connector@latest

Para ejecutar el código más reciente directamente desde GitHub en lugar de npm, usa npx -y github:malaysherasia-ai/google-search-console-connector-for-claude-code en lugar de npx -y google-search-console-connector@latest. El primer inicio tarda unos 20 segundos mientras compila. Las compilaciones de GitHub no incluyen el cliente de inicio de sesión con un clic, por lo que necesitarás tu propio cliente OAuth de Google Cloud (la página de Conexión te guía paso a paso).

2. Conecta un proyecto web. Abre Claude Code en la carpeta del sitio y di:

Conecta este proyecto a Google Search Console

Claude llama a gsc_connect, que abre una página en tu navegador:

una pregunta única sobre métricas de uso anónimas (sí o no, tú decides),
Inicia sesión con Google con la cuenta que tiene acceso a Search Console. En la segunda pantalla de Google, marca la casilla junto a "Ver y administrar datos de Search Console para tus sitios verificados" antes de hacer clic en Continuar; Google la deja sin marcar,
elige qué propiedad de Search Console pertenece a este proyecto.

Lo que Google te muestra (detalles de la cuenta ocultos):

Eso es todo. Google ha verificado la marca de la aplicación y solo solicita permisos no sensibles, por lo que no hay pantalla de "aplicación no verificada" que atravesar. Si continúas sin marcar la casilla, el conector conserva tu inicio de sesión anterior y te pide que lo intentes de nuevo.

3. Pregunta lo que quieras:

¿Cómo le fue al sitio en los últimos 28 días? ¿Para qué consultas estamos en las posiciones 4–20 y qué páginas deberíamos mejorar? Descarga el informe de GSC de los últimos 3 meses. Inspecciona https://example.com/services/ y dime por qué no está indexado. Envía el mapa del sitio y luego agrega una nota al gráfico de que lanzamos las nuevas páginas de ubicación. Abre el panel de Search Console.

También puedes ejecutar todo desde una terminal:

npx google-search-console-connector connect     # browser setup and sign-in
npx google-search-console-connector report      # export reports to .gsc-reports/
npx google-search-console-connector dashboard   # open the local dashboard
npx google-search-console-connector demo        # try the dashboard with sample data

Uso con Google Antigravity, Cursor y otros clientes MCP

Cualquier cliente MCP que pueda iniciar un servidor local (stdio) funciona. Agrégalo a su configuración MCP (en Antigravity, abre la configuración de servidores MCP y edita la configuración sin procesar):

{
  "mcpServers": {
    "google-search-console": {
      "command": "npx",
      "args": ["-y", "google-search-console-connector@latest"]
    }
  }
}

El servidor usa la carpeta en la que se inicia como proyecto. Si tu cliente inicia servidores en otro lugar, establece "env": { "GSC_PROJECT_DIR": "/path/to/your/site" }.

Avanzado: usa tu propio proyecto de Google Cloud

La mayoría de las personas pueden omitir esto. Las agencias y desarrolladores que quieran que el inicio de sesión pase por su propio proyecto de Google Cloud (su propia cuota, su propia pantalla de consentimiento) pueden elegir Usar mi propio proyecto de Google Cloud en la página de inicio de sesión. Los pasos son:

Crea un proyecto de Google Cloud o elige uno existente.
Habilita la API de Google Search Console.
Habilita la API de Site Verification (se usa para verificar sitios nuevos).
Configura la pantalla de consentimiento: elige Externa y agrega tu correo electrónico como usuario de prueba. Luego publica la aplicación como En producción. Las aplicaciones que quedan en "Pruebas" tienen su inicio de sesión caducado cada 7 días. No necesitas la verificación de la aplicación de Google para tu propio uso; Google mostrará un aviso de "aplicación no verificada" y continúas con Avanzado → Ir a (tu aplicación).
Crea un ID de cliente OAuth de tipo Aplicación de escritorio, descarga el JSON y colócalo en la página de Conexión.

Ambas API son gratuitas. Tu propio cliente significa que la cuota y la pantalla de consentimiento son tuyas. Para volver al inicio de sesión integrado, usa el enlace en la parte superior de esa página o Configuración en el panel.

Informes de Search Console con un comando

npx google-search-console-connector report [--days 28] [--type web] [--site URL] [--all-sites] [--out DIR]

Archivo	Contenido
`summary.md`	Totales comparados con el período anterior, desglose de marca, principales consultas y páginas, mayores ganancias y pérdidas, palabras clave a poca distancia y páginas con CTR bajo
`Dates.csv`, `Queries.csv`, `Pages.csv`, `Countries.csv`, `Devices.csv`, `Search appearance.csv`	Las mismas columnas que la exportación de Search Console, más columnas del período anterior
`Query-page pairs.csv`	Qué página se posiciona para qué consulta (la interfaz de Search Console no puede exportar esto)
`Sitemaps.csv`	Mapas del sitio enviados, estado, errores y advertencias
`Filters.csv`, `report.json`	Exactamente lo que se solicitó y todos los datos como JSON

Los informes van a .gsc-reports/<site>/<date>_last-<n>-days/ en tu proyecto, y .gsc-reports/ se agrega a .gitignore para que los datos de búsqueda nunca terminen en un commit o en un sitio desplegado. Las filas se paginan automáticamente más allá del límite de 25,000 filas de Google.

Herramientas MCP

Herramienta	Qué hace
`gsc_connect`	Abre el flujo de Conexión en el navegador y espera a que termine
`gsc_status` / `gsc_disconnect`	Estado de la conexión; revocar acceso
`gsc_list_sites` / `gsc_link_project`	Listar propiedades; establecer la propiedad predeterminada de este proyecto
`gsc_performance_summary`	Totales comparados con el período anterior, más principales consultas y páginas
`gsc_search_analytics`	Cualquier consulta de Search Analytics: dimensiones incluyendo `hour`, filtros (regex), tipo de búsqueda, marca/no marca
`gsc_export_report`	La exportación de informes con un comando, para un sitio o todos los sitios
`gsc_inspect_url`	Inspección de URL: estado de indexación, último rastreo, canónica, resultados enriquecidos
`gsc_list_sitemaps` / `gsc_submit_sitemap` / `gsc_delete_sitemap`	Administrar mapas del sitio
`gsc_add_site` / `gsc_get_verification_token` / `gsc_verify_site`	Agregar una propiedad y verificar propiedad (metaetiqueta, archivo HTML o DNS)
`gsc_set_brand_terms`	Palabras que hacen que una consulta sea "de marca"
`gsc_add_annotation`	Agregar una nota con fecha al gráfico de rendimiento
`gsc_open_dashboard`	Abrir el panel local

El panel

npx google-search-console-connector dashboard, o pídele a Claude que lo abra. Se ejecuta solo en 127.0.0.1 y se abre mediante un enlace de un solo uso.

Resumen: clics, impresiones, CTR y posición comparados con el período anterior, con un gráfico de tendencias de las últimas 24 horas (por hora) hasta 16 meses, agrupado por día, semana o mes
Consultas y Páginas: ordenable, buscable, cambiar columnas, exportación CSV
Oportunidades: a poca distancia, CTR bajo, consultas en declive
Mapas del sitio e inspección: enviar mapas del sitio, verificar su estado, inspeccionar cualquier URL
Configuración: cuenta, propiedad del proyecto, términos de marca, notas del gráfico, elección de métricas de uso

Pruébalo sin una cuenta de Google: npx google-search-console-connector demo.

Lo que la API de Google expone y no expone

Search Console sigue agregando funciones. Algunas llegan a la API y otras permanecen en la interfaz web. Esta tabla refleja la API de Google a octubre de 2026.

Función de Search Console	Compatible aquí	Notas
Rendimiento: clics, impresiones, CTR, posición por fecha, consulta, página, país, dispositivo, apariencia en la búsqueda	Sí
Datos por hora (últimos ~10 días)	Sí	Dimensión `hour`, rango "24h" en el panel
Rendimiento de Discover y Google News	Sí	Google no informa consultas ni posiciones para estos
Consultas de marca vs. no marca	Sí	Construido a partir de tus términos de marca con filtros regex RE2
Vistas semanales y mensuales	Sí	Agrupadas a partir de datos diarios
Anotaciones en el gráfico	Sí, localmente	Almacenadas en `.gsc-connect.json`; las anotaciones propias de Google no están en la API
AI Overviews y AI Mode	Incluidos en los totales web	La API de Google no puede separarlos
Informe de rendimiento de IA generativa, tipo de búsqueda web multimodal, propiedades de plataformas sociales, grupos de consultas	Aún no	Solo interfaz web en Search Console hoy. La verificación de actualizaciones los señala en cuanto Google los agrega a la API

Privacidad y métricas de uso anónimas

Tus datos de Search Console nunca salen de tu computadora, excepto para ir entre tú y Google.
Los tokens se almacenan en ~/.gsc-connect/ con permisos de archivo solo para el propietario. Desconectar revoca los tokens en Google.
La configuración del proyecto (.gsc-connect.json: propiedad, términos de marca, notas del gráfico) no contiene secretos y es segura para commitear.
Las métricas de uso anónimas son opcionales. La primera pantalla pregunta una vez. Si dices que no, nunca se envía nada. Si dices que sí, la aplicación envía nombres de eventos como view_changed o mcp_tool_called con la versión de la aplicación, el sistema operativo y un ID de instalación aleatorio a Google Analytics 4 mediante el Protocolo de medición. Nunca envía URLs de sitios, URLs de páginas, consultas, métricas ni tu cuenta. No se ejecuta ningún script de seguimiento en tu navegador ni se establecen cookies. Configuración → "Lo que se ha enviado" muestra cada evento exactamente como se envió, y puedes cambiar tu respuesta allí en cualquier momento. DO_NOT_TRACK=1 o GSC_CONNECT_TELEMETRY=0 lo desactiva definitivamente. La lista completa de eventos está en src/telemetry.ts.
Verificación de actualizaciones: una vez al día, la aplicación consulta el registro público de npm para obtener el número de la última versión. Establece GSC_CONNECT_UPDATE_CHECK=0 para desactivarlo.

Seguridad

El servidor local escucha únicamente en 127.0.0.1, verifica el encabezado Host y requiere una cookie de sesión que se establece mediante un enlace de inicio de un solo uso.
OAuth utiliza la redirección de bucle local con PKCE (S256) y una verificación de state, como recomienda Google para aplicaciones de escritorio.
Solicitado al iniciar sesión: webmasters (Search Console) y openid email (para mostrar qué cuenta está conectada). siteverification se solicita por separado, solo la primera vez que verificas un sitio nuevo.

Reporta vulnerabilidades de forma privada; consulta SECURITY.md.

Configuración

Variable	Propósito
`GSC_PROJECT_DIR`	Carpeta del proyecto, si tu cliente MCP inicia servidores en otro lugar
`GSC_CLIENT_ID`, `GSC_CLIENT_SECRET`	Usa tu propio cliente OAuth del entorno en lugar del inicio de sesión integrado
`GSC_CONNECT_HOME`	Dónde se almacenan las credenciales (por defecto `~/.gsc-connect`)
`GSC_CONNECT_PORT`	Puerto local preferido (por defecto 4817; usa cualquier puerto libre si no está disponible)
`GSC_CONNECT_TELEMETRY=0`, `DO_NOT_TRACK=1`	Nunca enviar métricas de uso
`GSC_CONNECT_UPDATE_CHECK=0`	No comprobar nuevas versiones en npm

Preguntas frecuentes

¿La API de Google Search Console es gratuita? Sí. Google no cobra nada por la API de Search Console ni por la API de verificación de sitios, y esta herramienta no tiene partes de pago.

¿Necesito una cuenta de Google Cloud? No. Inicias sesión con la cuenta de Google que ya usas para Search Console. Tu propio proyecto de Google Cloud es una configuración avanzada opcional.

¿Quién puede ver mis datos? Solo tú y Google. El inicio de sesión otorga acceso a tu computadora, no a un servidor: los tokens se almacenan en ~/.gsc-connect/ y los informes se guardan en tu carpeta de proyecto. Consulta la política de privacidad.

¿Puedo exportar más de 1,000 filas? Sí. La exportación web de Search Console se detiene en 1,000 filas. La API devuelve hasta 25,000 por solicitud, y esta herramienta continúa paginando, hasta el límite de Google de 50,000 filas por día por tipo de búsqueda.

¿Funciona con propiedades de dominio (sc-domain:)? Sí, tanto las propiedades de dominio como las de prefijo de URL funcionan. Las propiedades de dominio se verifican mediante DNS.

¿Funcionará con más de un sitio web? Sí. Cada carpeta de proyecto se vincula a su propia propiedad, y report --all-sites exporta todas las propiedades a las que puedes acceder.

¿Cómo actualizo? Si instalaste con @latest, reinicia Claude Code. El panel y la CLI te indican cuándo hay una nueva versión disponible.

Desarrollo

git clone https://github.com/malaysherasia-ai/google-search-console-connector-for-claude-code.git
cd google-search-console-connector-for-claude-code
npm install
npm run build
npm run demo                                  # dashboard with sample data
claude mcp add gsc-dev -- node "$PWD/dist/index.js"
npm run check:google                          # what has Google changed since the last release?

Consulta RELEASING.md para saber cómo se planifican los lanzamientos a partir de los cambios de Google y del uso, y CONTRIBUTING.md para saber cómo contribuir.

Licencia

MIT. No está afiliado ni respaldado por Google. Google Search Console es una marca comercial de Google LLC.