Cómo conectar Google Search Console
con Claude Code
Hoy veremos cómo conectar Google Search Console con Claude Code para que le preguntes a la IA por tus datos de SEO, sin exportar ni un informe.
- Google Search Console
- Claude Code
En resumen
Para conectar Google Search Console con Claude Code necesitas una cuenta de servicio de Google y un conector MCP:
- Instala Node.js.
- Crea un proyecto en Google Cloud y activa la API de Search Console.
- Crea una cuenta de servicio y descarga su clave JSON.
- Añade la cuenta de servicio como usuario en Search Console.
- Da de alta el conector MCP en Claude Code.
- Pregunta a Claude por tus datos de Search Console.
Lo que necesitas
- Claude Code o Claude Desktop (en el paso 5 explico los dos).
- Node.js 18 o superior.
- Una cuenta de Google para entrar en Google Cloud.
- Acceso a tu propiedad de Search Console con permiso para añadir usuarios.
Abajo explico cada paso con capturas, en Windows y en Mac. Antes, los métodos que hay y cuál conviene a cada uno.
Qué métodos hay para conectar Search Console con Claude
No hay un conector oficial de Google para Search Console. Todas las vías leen los mismos datos; lo que cambia es cómo llegan a Claude.
Exportar a CSV y subir el archivo
- Claude web
- Claude Desktop
- Claude Code
Necesitas Nada.
A favor Cero instalación.
En contra Máximo 1000 filas, y los datos se quedan viejos al momento.
Conector remoto de un tercero
- Claude web
- Claude Desktop
- Claude Code
Necesitas Una cuenta en ese servicio, a menudo de pago.
A favor Se conecta en minutos, sin código.
En contra Tus datos pasan por otra empresa.
El que uso
Conector MCP con cuenta de servicio
- Claude Desktop
- Claude Code
Necesitas Node.js, Google Cloud y una clave JSON.
A favor No caduca; una cuenta por cliente, y cada una solo ve su web.
En contra La clave da acceso a tus datos: hay que guardarla bien.
Conector MCP con tu cuenta de Google (OAuth)
- Claude Desktop
- Claude Code
Necesitas Node.js y un cliente OAuth en Google Cloud.
A favor No hay clave que guardar; ves lo mismo que ves tú.
En contra El acceso caduca a los 7 días si la aplicación de Google Cloud sigue en modo de prueba.
Cuál uso yo y por qué
El conector MCP con cuenta de servicio. Trabajo con webs de clientes y necesito que cada una tenga su propio acceso, separado del resto: con una cuenta de servicio por cliente, cada conector ve una sola web, y cuando termino con un cliente le corto el acceso en un minuto. Además, no caduca a los pocos días, como OAuth en modo de prueba, y los datos no pasan por la empresa de un tercero. A cambio hay que guardar bien la clave; en el paso 3 explico cómo.
Paso 1 · Instala Node.js
El conector es un pequeño programa que necesita Node.js para funcionar.
- Entra en nodejs.org y pulsa Get Node.js®.
- Deja la versión que viene marcada como LTS (la estable) y baja hasta el botón del instalador: Windows Installer (.msi) en Windows o macOS Installer (.pkg) en Mac. La página detecta tu sistema sola. No hace falta que copies los comandos del recuadro negro.
-
Abre el archivo descargado e instálalo con todas las opciones por defecto.
-
Comprueba que está instalado: abre PowerShell (en Mac, Terminal), escribe
node -vy pulsa Enter. Tiene que salir un número de versión,v18o superior.
Paso 2 · Crea un proyecto en Google Cloud y activa la API
-
Entra en console.cloud.google.com y abre el selector de proyectos, arriba a la izquierda.
-
Pulsa Proyecto nuevo.
- Ponle un nombre que reconozcas y pulsa Crear. El mío se llama «Eneko Anton GSC». Fíjate en el ID del proyecto: no se puede cambiar después.
- Con el proyecto ya seleccionado arriba, busca Google Search Console API en el buscador y abre el primer resultado.
- Pulsa Habilitar.
En unos segundos, el estado pasa a Habilitada.
Paso 3 · Crea la cuenta de servicio y su clave
- En el menú, IAM y administración → Cuentas de servicio → Crear cuenta de servicio.
- Nombre:
gsc-y el nombre de la web. Pulsa Crear y cerrar: los pasos de permisos son opcionales y no hacen falta. La cuenta no necesita ningún rol en Google Cloud; el permiso se da en Search Console.
-
Entra en la cuenta que acabas de crear.
-
Pestaña Claves → Agregar clave → Crear clave nueva.
Google avisa aquí de dos cosas que conviene leer: que una clave filtrada es un riesgo, y que desactiva solo las claves que detecta en repositorios públicos.
- Elige JSON y pulsa Crear. Se descarga un archivo con la clave. Google no guarda copia: si lo pierdes, tienes que crear otra.
-
Guarda el archivo en un sitio seguro. Ese archivo funciona como una contraseña: quien lo tenga puede leer los datos de tu web en Search Console. Por eso importa dónde lo dejas.
Lo que te recomiendo:
- Cámbiale el nombre por el de tu web (por ejemplo,
mi-web.json). Google le pone un nombre largo con números, y si un día tienes varias claves, así sabrás cuál es cuál. - Guárdalo dentro de tu carpeta de usuario. Es la carpeta con tu nombre que tiene cada persona en el ordenador. En Windows está en Este equipo → Disco local (C:) → Usuarios → tu nombre. En Mac es la carpeta con el icono de una casa, en la barra lateral del Finder. Lo que guardas ahí solo lo puede abrir tu cuenta. Si lo dejaras, por ejemplo, directamente en
C:, podría abrirlo cualquier otra cuenta de ese ordenador. - No lo guardes en la carpeta de tu web o de tus proyectos. Muchas veces esas carpetas se suben a internet (a GitHub, por ejemplo) o se comparten con otras personas, y la clave se iría con ellas sin que te des cuenta.
- No lo guardes en Google Drive, OneDrive ni Dropbox. Esas carpetas se copian solas en internet y en tus otros dispositivos: la clave acabaría en más sitios de los que controlas.
Yo creo dentro de mi carpeta de usuario una carpeta
MCPy, dentro, otragsc. Así queda la ruta (la dirección del archivo en tu ordenador):- Windows:
C:\Users\tu-usuario\MCP\gsc\mi-web.json - Mac:
/Users/tu-usuario/MCP/gsc/mi-web.json
Es un ejemplo. Las carpetas
MCPygscno existen en tu ordenador: créalas tú o usa los nombres que quieras.tu-usuarioes el nombre de tu carpeta de usuario ymi-web.json, el nombre que le hayas puesto al archivo. Lo importante es que esté dentro de tu carpeta de usuario, no cómo se llamen las carpetas.Apunta la ruta completa de tu archivo: la necesitas en el paso 5.
- Cámbiale el nombre por el de tu web (por ejemplo,
Paso 4 · Da acceso a la cuenta de servicio en Search Console
- Copia el correo de la cuenta de servicio: pestaña Detalles, campo Correo electrónico. Acaba en
iam.gserviceaccount.com.
- En Search Console: Ajustes → Usuarios y permisos → Añadir usuario.
- Pega el correo y elige el permiso. Empieza por Restringido, el más bajo.
- La cuenta de servicio aparece en la lista con su permiso.
Con Restringido basta para analizar. Algunas guías piden Completo o Propietario, pero para leer datos no hace falta. Lo he probado en mi propia web con los dos extremos, el permiso más bajo y el más alto:
| Lo que le pides a Claude | Restringido | Propietario |
|---|---|---|
| Ver tu web en la lista de propiedades | Sí | Sí |
| Leer el rendimiento: consultas, clics, impresiones y posición | Sí | Sí |
| Ver los sitemaps enviados | Sí | Sí |
| Inspeccionar una URL (si está indexada, cuándo pasó Google) | Sí | Sí |
| Enviar un sitemap | No: Google responde con un error de permiso | Sí, sin pedirte confirmación en Google |
| Borrar un sitemap | No: Google responde con un error de permiso | Sí, sin pedirte confirmación en Google |
Es decir: con Restringido, Claude ve lo mismo que necesitas para analizar y no puede cambiar nada. Con Propietario, puede cambiar cosas de tu Search Console con una simple orden.
Y ojo con lo que dice el conector: al pedirle que borrara un sitemap que no existía dentro de mi web, contestó «deleted successfully» (borrado con éxito). Que el conector diga «hecho» no garantiza que haya pasado lo que crees.
Paso 5 · Da de alta el conector en Claude Code
El conector es un pequeño programa que hace de puente: Claude le pregunta, él le pide los datos a Google con tu clave y se los devuelve. Uso gsc-mcp, gratuito y de código abierto (cualquiera puede revisar lo que hace).
Se da de alta con un solo comando, una vez por proyecto.
-
Abre la terminal en la carpeta de tu proyecto (la de tu web o la de un cliente). El conector se guarda solo para esa carpeta: en otros proyectos, Claude no verá estos datos.
- Windows: abre la carpeta en el Explorador, haz clic en la barra de direcciones, escribe
powershelly pulsa Enter. - Mac: abre Terminal, escribe
cdy un espacio, arrastra la carpeta hasta la ventana y pulsa Enter.
- Windows: abre la carpeta en el Explorador, haz clic en la barra de direcciones, escribe
-
Copia el comando de tu sistema y cambia solo la ruta de la clave por la que apuntaste en el paso 3. Lo más cómodo es pegarlo antes en un bloc de notas, cambiar la ruta allí y copiarlo de nuevo.
Windows (PowerShell):
claude mcp add --transport stdio gsc --env GSC_SERVICE_ACCOUNT_KEY_PATH=C:/Users/tu-usuario/MCP/gsc/mi-web.json -- cmd /c npx -y @mikusnuz/[email protected]Mac (Terminal):
claude mcp add --transport stdio gsc --env GSC_SERVICE_ACCOUNT_KEY_PATH=/Users/tu-usuario/MCP/gsc/mi-web.json -- npx -y @mikusnuz/[email protected]Dos detalles que suelen fallar con la ruta:
- En Windows, va con barras
/, no con\. Si la copias del Explorador, cambia cada\por/. - Si tiene espacios (por ejemplo, un usuario
Ana Pérez), ponla entre comillas:"C:/Users/Ana Pérez/MCP/gsc/mi-web.json".
- En Windows, va con barras
-
Pega el comando en la terminal y pulsa Enter (en Windows, Ctrl + V o clic derecho; en Mac, Cmd + V). Claude Code confirma que ha añadido el conector. En Windows, la respuesta empieza así:
Added stdio MCP server gsc with command: cmd /c npx -y @mikusnuz/[email protected] to local config«Local config» quiere decir que el conector queda guardado solo para esta carpeta.
-
Comprueba que funciona: escribe
claude mcp listy pulsa Enter. La primera vez tarda unos segundos, porque descarga el programa. Si aparecen otros conectores, déjalos; el tuyo tiene que salir así:gsc: cmd /c npx -y @mikusnuz/[email protected] - √ ConnectedConnectedes que funciona. Si sale un error, casi siempre es la ruta de la clave: bórralo conclaude mcp remove gscy repite el punto 2 con la ruta corregida.
Qué hace cada parte del comando
claude mcp add: le dice a Claude Code que añada un conector.--transport stdio: el conector funciona dentro de tu ordenador, no en internet.gsc: el nombre del conector, el que verás en la lista. Puedes cambiarlo.GSC_SERVICE_ACCOUNT_KEY_PATH=…: dónde está tu clave.cmd /c(solo Windows): sin esto, Windows no arranca el programa.npx -y @mikusnuz/[email protected]: el programa del conector, en una versión fija. Se descarga solo la primera vez.
Si usas Claude Desktop
Claude Desktop no tiene comando: el conector se escribe en su archivo de configuración. Ábrelo desde Configuración → Desarrollador → Editar configuración y añade esto dentro de mcpServers (si ya hay otros conectores, déjalos y pon este al lado):
{
"mcpServers": {
"gsc-mi-web": {
"command": "npx",
"args": ["-y", "@mikusnuz/[email protected]"],
"env": {
"GSC_SERVICE_ACCOUNT_KEY_PATH": "C:/Users/tu-usuario/MCP/gsc/mi-web.json"
}
}
}
}
En Mac, la ruta es /Users/tu-usuario/MCP/gsc/mi-web.json. En Windows, escríbela con /: una \ sola rompe el archivo.
Después, cierra Claude Desktop del todo y vuelve a abrirlo: en Windows, desde el Administrador de tareas; en Mac, con Cmd + Q. Cerrar la ventana no basta.
Paso 6 · Pregúntale a Claude por tus datos
Con el conector activo, pregúntale a Claude como se lo preguntarías a una persona. Si le pides «una tabla visual», te devuelve el resultado ordenado, sin exportar nada.
Estas son preguntas reales que le hice sobre mi web. Es nueva y todavía tiene pocos datos, así que las cifras son pequeñas.
¿Qué búsquedas me traen clics?
Dame una tabla muy visual para ver qué búsquedas me han traído clics e impresiones en los últimos 28 días.
Claude separó las búsquedas en grupos (marca, SEO local, posicionamiento en IA). De 73 búsquedas, solo una me trae clics: mi nombre. El resto me enseña en Google, pero todavía lejos de la primera página.
¿Están indexadas mis páginas?
¿Están indexadas mis páginas publicadas? Revisa la home, contacto y cada página de servicio. Hazme una tabla visual para verlo.
Inspeccionó las seis URLs una a una: todas indexadas, con la canonical que yo había marcado y la fecha en que Google pasó por cada una. En Search Console, eso son seis inspecciones a mano.
¿Qué cambio para conseguir más clics?
¿Qué consultas tienen muchas impresiones pero un CTR bajo, y qué cambiarías en el title o la description? Dame respuesta en una tabla muy visual.
Lo mejor de la respuesta es el aviso: el CTR es 0 porque salgo en las páginas 8 y 9 de Google, no por el title. Aun así, cruzó las consultas con el title y la description de cada página y me propuso cambios:
¿Tengo páginas que compiten entre sí?
¿Hay canibalización? ¿Alguna consulta reparte impresiones entre varias URLs mías? Dámelo en forma de tabla muy visual.
No hay canibalización: cada grupo de consultas tiene su página. La única búsqueda que reparten varias URLs es mi nombre, y la home se lleva todos los clics, que es lo normal.
¿Quieres aplicar la IA así en otras tareas de tu empresa? Te ayudo como consultor de IA para pymes.
Un conector por cliente
Si llevas varias webs, crea una cuenta de servicio y una clave por cliente, y añade cada correo solo en la propiedad de su cliente. Da de alta cada conector en la carpeta de su proyecto: al trabajar en un cliente, Claude solo ve los datos de ese cliente. Cuando termines con él, borra su clave en Google Cloud o quita su correo en Search Console, y el acceso se corta al momento.
Seguridad: lo que no hay que hacer
- No guardes la clave en el proyecto ni en la nube (paso 3).
- No le des roles de Google Cloud a la cuenta de servicio. Para leer Search Console no los necesita.
- No des más permiso del necesario en Search Console (paso 4). Este conector no solo lee: también puede enviar y borrar sitemaps, quitar la propiedad de la cuenta y avisar a Google de URLs nuevas o borradas (API de indexación).
- No aceptes las acciones a ciegas. Claude Code pide permiso antes de usar cada herramienta del conector: lee qué va a hacer.
- No quites la versión del conector (
@1.3.6). Sin ella, cada vez que arranca se descargaría la última, y un cambio que nadie ha revisado entraría solo en tu ordenador. - No compartas la clave por correo ni por chat. Si se filtra, bórrala en Google Cloud y crea otra.
Problemas típicos y su solución
Claude dice que no tiene permiso
Comprueba que el correo de la cuenta de servicio está en la propiedad correcta. Una propiedad de dominio se escribe sc-domain:tuweb.com; una de prefijo de URL, https://tuweb.com/, con la barra final. Si Claude usa el nombre equivocado, Google responde como si no tuvieras permiso.
Claude dice que tu sitemap tiene 0 páginas indexadas
No te lo creas. Ese dato de la API de sitemaps está obsoleto y sale siempre a 0. Para saber si una página está indexada, pídele a Claude que la inspeccione. En mi web, el sitemap decía 0 y las seis páginas estaban indexadas.
Claude Desktop no ve el conector
Casi siempre es una de estas tres cosas: una coma de más o de menos en el archivo de configuración, una ruta de Windows escrita con \, o no haber cerrado Claude Desktop del todo.
Límites de los datos
- La exportación desde la interfaz de Search Console se queda en 1000 filas.
- La API da hasta 25 000 filas por consulta y 50 000 al día por propiedad y tipo de búsqueda.
- Search Console guarda dieciséis meses de datos. Los definitivos llegan con unos dos días de retraso; si pides también los recientes, la API da hasta el día de hoy, marcados como incompletos.
- Google oculta las búsquedas que hacen muy pocas personas: cuentan en los totales, pero no salen en la lista de consultas.
- Si tu web es muy grande y estos límites se te quedan cortos, Google ofrece la exportación masiva a BigQuery, sin límite de filas. Es otro montaje, más técnico y que puede costar dinero.
Preguntas frecuentes
¿Hay un conector oficial de Google?
No. Los que hay son de la comunidad o de empresas de terceros, y todos llaman a la API pública de Search Console. Revisa quién mantiene el que uses antes de darle acceso a tus datos.
¿Cuenta de servicio o tu cuenta de Google (OAuth)?
La cuenta de servicio no caduca y se aísla por cliente; a cambio, hay que guardar una clave. Con OAuth no hay clave, pero el acceso caduca a los 7 días mientras la aplicación de Google Cloud siga en modo de prueba.
¿Puede Claude cambiar mi Search Console?
Solo si le das permiso para ello. Con el permiso Restringido, Google rechaza cualquier cambio (la tabla del paso 4). La API de indexación, además, no responde si no la activas en Google Cloud, y con este tutorial queda desactivada.
¿Funciona con ChatGPT?
Con el CSV, sí: cualquier asistente lee un archivo. El conector de este tutorial lo he montado y probado solo con Claude.
Fuentes
- Google Search Central: límites y filtrado de los datos de rendimiento.
- Claude Code: documentación de los conectores MCP.
- El conector: gsc-mcp en GitHub.
- Google for Developers: caducidad de los tokens de OAuth 2.0 (apartado «Refresh token expiration»).