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:

  1. Instala Node.js.
  2. Crea un proyecto en Google Cloud y activa la API de Search Console.
  3. Crea una cuenta de servicio y descarga su clave JSON.
  4. Añade la cuenta de servicio como usuario en Search Console.
  5. Da de alta el conector MCP en Claude Code.
  6. 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.

  1. Entra en nodejs.org y pulsa Get Node.js®.
Portada de nodejs.org con el botón «Get Node.js®» marcado
  1. 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.
Página de descarga de Node.js con la versión LTS y el botón «Windows Installer (.msi)» marcados
  1. Abre el archivo descargado e instálalo con todas las opciones por defecto.

  2. Comprueba que está instalado: abre PowerShell (en Mac, Terminal), escribe node -v y pulsa Enter. Tiene que salir un número de versión, v18 o superior.

Paso 2 · Crea un proyecto en Google Cloud y activa la API

  1. Entra en console.cloud.google.com y abre el selector de proyectos, arriba a la izquierda.

  2. Pulsa Proyecto nuevo.

Ventana «Selecciona un recurso» con el botón «Proyecto nuevo» marcado
  1. 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.
Formulario de proyecto nuevo con el nombre «Eneko Anton GSC» y el botón «Crear» marcados
  1. Con el proyecto ya seleccionado arriba, busca Google Search Console API en el buscador y abre el primer resultado.
Buscador de Google Cloud con «Google Search Console API» escrito y el primer resultado marcado
  1. Pulsa Habilitar.
Ficha de Google Search Console API con el botón «Habilitar» marcado

En unos segundos, el estado pasa a Habilitada.

Paso 3 · Crea la cuenta de servicio y su clave

  1. En el menú, IAM y administración → Cuentas de servicio → Crear cuenta de servicio.
Página de cuentas de servicio con la entrada del menú y el botón «Crear cuenta de servicio» marcados
  1. 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.
Formulario de cuenta de servicio con el nombre «gsc-enekoanton» y el botón «Crear y cerrar» marcados; el correo, tapado
  1. Entra en la cuenta que acabas de crear.

  2. 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.

Pestaña «Claves» de la cuenta de servicio, con los avisos de seguridad de Google y el botón «Agregar clave» marcado
  1. Elige JSON y pulsa Crear. Se descarga un archivo con la clave. Google no guarda copia: si lo pierdes, tienes que crear otra.
Ventana «Crear clave privada» con el tipo JSON y el botón «Crear» marcados
  1. 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 MCP y, dentro, otra gsc. 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 MCP y gsc no existen en tu ordenador: créalas tú o usa los nombres que quieras. tu-usuario es el nombre de tu carpeta de usuario y mi-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.

Paso 4 · Da acceso a la cuenta de servicio en Search Console

  1. Copia el correo de la cuenta de servicio: pestaña Detalles, campo Correo electrónico. Acaba en iam.gserviceaccount.com.
Pestaña «Detalles» de la cuenta de servicio con el campo «Correo electrónico» marcado y tapado
  1. En Search Console: Ajustes → Usuarios y permisos → Añadir usuario.
Página «Usuarios y permisos» de Search Console con el botón «Añadir usuario» marcado; los usuarios, tapados
  1. Pega el correo y elige el permiso. Empieza por Restringido, el más bajo.
Ventana «Añadir usuario» con el desplegable de permisos abierto y «Restringido» marcado
  1. La cuenta de servicio aparece en la lista con su permiso.
Lista de usuarios de Search Console con la cuenta de servicio nueva y el permiso «Restringido» marcados

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.

  1. 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 powershell y pulsa Enter.
    • Mac: abre Terminal, escribe cd y un espacio, arrastra la carpeta hasta la ventana y pulsa Enter.
  2. 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".
  3. 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.

  4. Comprueba que funciona: escribe claude mcp list y 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] - √ Connected
    

    Connected es que funciona. Si sale un error, casi siempre es la ruta de la clave: bórralo con claude mcp remove gsc y 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.

Tabla de Claude con las búsquedas de los últimos 28 días: 8 clics, 1212 impresiones y 73 búsquedas distintas; los 8 clics vienen de «eneko anton»

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.

Tabla de Claude con seis páginas revisadas: las seis indexadas, con la canonical correcta y la fecha del último rastreo de cada una

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.

Tabla de Claude con las consultas con muchas impresiones y ningún clic, su posición media y qué falla en cada una, con el aviso de que el CTR es 0 porque la web sale en las páginas 8 y 9 de Google

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:

Propuesta de Claude para dos páginas: el title y la description actuales tachados, los nuevos en verde con su número de caracteres y el porqué de cada cambio

¿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.

Tabla de Claude sobre canibalización: 73 consultas analizadas, 72 con una sola URL y 0 casos reales; la única consulta repartida es la marca y la home se lleva los clics

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

Elige qué cookies quieres permitir. Las necesarias no se pueden desactivar.