Inicio › SEO e IA › Cómo conectar Google Search Console a Claude: guía paso a paso

Analiza tus búsquedas, tus clics y tus posiciones en lenguaje natural, directamente en Claude. Sin exportar, sin tablas cruzadas, sin programar.

Conectar tu Google Search Console a Claude se hace en cuatro pasos: crear un proyecto de Google Cloud, activar la API de Search Console, generar un identificador OAuth y, por último, conectar el servidor a Claude. Te llevará 15 minutos. Solo tienes que hacerlo una vez y es gratis.

4 pasos

por orden

15 minutos

una sola vez

0 €

En Google todo es gratis

Solo lectura

Claude está leyendo, no toca nada

Los datos de Search Console, en formato de conversación

Al conectarla con Claude, tu Search Console se lee en lenguaje natural. Solo tienes que hacer una pregunta y Claude te muestra tus consultas, clics y posiciones ya ordenados, sin necesidad de exportar ni de tablas cruzadas.

Antes había que abrir Search Console, ajustar el intervalo de fechas, filtrar por página, exportar a CSV y luego lidiar con una tabla cruzada para sacar tres cifras. Ya sabes, esa tarea pesada de los viernes por la noche… ¡pero se acabó!

Ahí escribes una frase: «Muéstrame mis 10 consultas que han recibido más clics este mes». La respuesta aparece en Claude, ya procesada. Sigues con: «¿Cuáles se han quedado en la página 2?», «Compáralas con las del año pasado», «¿Qué páginas están perdiendo posiciones?».

Son tus datos de Search Console, en modo análisis. Los utilizo antes de cada auditoría y ya no voy a dejar de hacerlo. Poder consultar rápidamente las cifras reales es lo que te mantiene lúcido cuando la SERP cambia, el tema central del estado de las búsquedas en 2026.

Para que la magia surta efecto, Claude solo tiene que consultar tu Search Console. Eso es todo lo que explica esta guía. Y todo queda en modo de solo lectura: él revisa tus cifras, pero no publica nada, no borra nada ni modifica ningún ajuste.

¿Por qué hay que vincular tu propia cuenta de Google a Claude?

En lugar de una «cuenta de servicio» (un bot que invitas a tus herramientas), se accede directamente a través de tu cuenta de Google. Es la forma que recomienda Google para este tipo de acceso, y la más sencilla de mantener a largo plazo. Claude ve lo mismo que tú en Search Console, ni más ni menos.

Search Console es el panel de control gratuito de Google sobre tu visibilidad: consultas, clics, posiciones. Al estar conectado a Claude, puedes consultarlo en francés, sin necesidad de exportar datos.

Lo que hay que instalar antes de empezar

Dos herramientas gratuitas que hay que instalar una sola vez para conectar Claude y Search Console: Node y la CLI de gcloud.

La guía paso a paso que aparece a continuación utiliza Claude Code en Mac, la versión de Claude que se ejecuta en el Terminal. En Windows o en Claude Desktop, toda la parte relacionada con Google es idéntica: dirígete a la sección «¿Cómo conectar Claude a Search Console sin el Terminal o en Windows?» para realizar la conexión.

En Mac, hay dos pequeñas herramientas que debes instalar si aún no las tienes. Abre la aplicación «Terminal» y pega estas líneas una por una:

# Homebrew, le gestionnaire d'installation du Mac (saute si tu l'as déjà)
# instructions sur https://brew.sh

brew install node                # pour faire tourner le serveur Search Console
brew install --cask gcloud-cli   # l'outil de connexion Google

Eso es todo en cuanto a la interfaz gráfica. El resto se hace en el navegador y en el Terminal, pantalla a pantalla.

Paso 1: preparar el proyecto de Google Cloud

Crea un proyecto gratuito de Google Cloud y, a continuación, activa la API de Search Console. Ese es el espacio y la puerta por los que Claude accederá a tus datos. No cuesta nada ni supone ningún riesgo. Te lo explico:

Crea el proyecto de Google Cloud

Entra en console.cloud.google.com e inicia sesión con la cuenta de Google que tiene acceso a tu Search Console. Este es el punto más importante de la guía: esa cuenta, y ninguna otra.

Si Google te propone crear un proyecto, acéptalo. El nombre no tiene ninguna importancia. Si ya tienes un proyecto, puedes volver a utilizarlo. No pierdas de vista elID del proyecto que aparece en la página de inicio, algo así como mon-projet-123, lo necesitaremos al final.

Activa la API de Search Console

Una API es una puerta a través de la cual dos programas se comunican entre sí. Por defecto, está cerrada. En la barra de búsqueda situada en la parte superior de la consola, busca «Google Search Console API» y haz clic en el botón azul «Activar». Solo hay que activar una API para esta guía.

Paso 2: crear la clave de conexión (OAuth)

Genera un identificador OAuth: el credencial que autoriza a Claude a acceder a tu Search Console en tu nombre. El proceso consta de dos pasos y hay que descargar un archivo.

Configura la pantalla de autorización de OAuth

En el menú de la izquierda, ve a «Google Auth Platform» (o busca «OAuth» en la barra superior). Configúralo así:

Tipo de usuario: Externo.
Deja el estado en «Prueba», es perfecto para uso personal.
En «Usuarios de prueba», haz clic en «Añadir usuarios» e introduce tu propia dirección de Gmail, la del paso 1.

¿Para qué sirve registrarse como usuario de prueba?

Mientras tu aplicación esté en modo de prueba, solo las direcciones que aparecen aquí tienen permiso para utilizarla. Al añadirte, te autorizas a ti mismo. Esto también te permitirá pasar sin problemas la pantalla «aplicación no validada» en el paso 3.

Crea el cliente OAuth y recupera la clave

Sin salir de Google Auth Platform, ve a «Clientes» y, a continuación, a «Crear un cliente »:

Tipo de aplicación: Aplicación de escritorio.
Ponle un nombre que signifique algo, por ejemplo Claude Search Console.
Haz clic en «Crear» y, a continuación, en «Descargar en formato JSON».

Este pequeño archivo .json, esa es tu clave. Guárdala en una carpeta discreta y fácil de encontrar. Te propongo esta ruta, que volveremos a utilizar tal cual:

# crée le dossier puis dépose ton fichier dedans, renommé proprement
mkdir -p ~/.config/google-mcp
mv ~/Downloads/client_secret_*.json ~/.config/google-mcp/oauth-client.json

Este archivo es una contraseña

Nunca lo envíes por correo electrónico, no lo publiques en Discord ni lo guardes en una carpeta compartida. Da acceso a tus datos: guárdalo en tu ordenador y ya está.

Paso 3: conectar Claude a Search Console

Dos comandos en el Terminal: uno para iniciar sesión en Google y otro para conectar el servidor a Claude. Copias, pegas y confirmas. ¡No tiene ningún misterio!

Inicia sesión con la cuenta de Google correcta

Pega este comando en el Terminal. Ocupa varias líneas, así que copia todo el bloque de una vez:

gcloud auth application-default login \
  --client-id-file=$HOME/.config/google-mcp/oauth-client.json \
  --scopes=openid,\
https://www.googleapis.com/auth/cloud-platform,\
https://www.googleapis.com/auth/webmasters.readonly

Se abre una ventana del navegador. Sigue estos pasos:

Elige tu cuenta de Google, la del paso 1.
Aparece un mensaje que dice «Google no ha validado esta aplicación»: es normal, la aplicación la has creado tú. Haz clic en «Configuración avanzada» y, a continuación, en «Acceder a Claude Search Console (no seguro)».
Autoriza el acceso de lectura.

De vuelta en la Terminal, deberías ver Credentials saved to file. Ya está, tu conexión queda registrada.

Conecta el servidor de Search Console

Sin salir del Terminal, pega este comando. Este comando conecta Search Console con Claude:

claude mcp add --scope user google-search-console \
  -e GOOGLE_APPLICATION_CREDENTIALS=$HOME/.config/gcloud/application_default_credentials.json \
  -- npx -y mcp-server-gsc

A continuación, cierra y vuelve a abrir Claude Code. La nueva herramienta solo aparece al reiniciar, y eso es lo que confunde a todo el mundo.

¿Cómo se conecta Claude a Search Console sin Terminal o en Windows?

Para conectar Search Console a Claude sin Terminal, la configuración por parte de Google (proyecto en la nube, API, identificador de OAuth) es la misma en todos los sistemas. Lo único que cambia es la forma de conectar el servidor. El inicio de sesión en tu cuenta, el comando gcloud auth del paso 3, pasa de todos modos una vez por el Terminal en Mac o por PowerShell en Windows.

En Claude Desktop (Mac o Windows), no escribas claude mcp add. Añade el servidor en la configuración: en la aplicación, Ajustes → Desarrollador → Editar configuración, luego pega este bloque y guarda:

{
  "mcpServers": {
    "google-search-console": {
      "command": "npx",
      "args": ["-y", "mcp-server-gsc"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "chemin/vers/application_default_credentials.json"
      }
    }
  }
}

Cierra y vuelve a abrir Claude Desktop. En Windows, instala Node y la CLI de gcloud desde sus páginas web oficiales en lugar de hacerlo a través de Homebrew, y la ruta del archivo de conexión pasa a ser %APPDATA%\gcloud\application_default_credentials.json.

Si el Terminal te echa para atrás

Hay servicios de terceros (Supermetrics, Porter, Windsor.ai) que conectan Search Console con Claude con un solo clic, sin necesidad de usar la línea de comandos. La desventaja es que son de pago y que tus datos pasan por sus servidores antes de llegar a Claude. Para un uso personal y gratuito, el método anterior sigue siendo el más limpio.

Paso 4: comprobar la conexión con Claude y consultar Search Console

Comprueba que el servidor muestre «Connected» y, a continuación, formula tus preguntas en lenguaje natural. Lo más difícil ya está hecho.

Comprueba la conexión de Claude y Search Console

En el Terminal, escribe claude mcp list : tu servidor google-search-console debe mostrar ✓ Connected. A continuación, en Claude, ponte manos a la obra:

«Lista de mis propiedades en Search Console».
«Las 10 búsquedas más populares por número de clics en los últimos 28 días en mi-sitio.com.»
«¿Qué consultas se encuentran estancadas en las posiciones 11 a 20 y merecen un empujoncito?»
«¿Qué páginas han registrado una mayor caída en el número de clics en los últimos tres meses?»

Si las cifras suben, ¡está de moda!

Preguntas frecuentes sobre la conexión entre Search Console y Claude

Hay dos errores recurrentes: «ninguna propiedad» cuando Claude está conectado a una cuenta de Google incorrecta, y «invalid_grant» cuando la sesión ha caducado. Ambos se solucionan volviendo a ejecutar el comando de conexión del paso 3.

Claude no ve ninguna propiedad en Search Console, ¿qué puede hacer?

En la mayoría de los casos, el inicio de sesión se ha realizado con una cuenta de Google incorrecta. Vuelve a intentar el proceso de inicio de sesión del paso 3 y elige la cuenta que realmente tenga acceso a tu Search Console.

¿Por qué caduca la sesión de Search Console al cabo de unos días en Claude?

En el modo de prueba, el token de acceso caduca al cabo de aproximadamente una semana y Claude muestra el mensaje «invalid_grant». Vuelve a ejecutar el comando de conexión del paso 3. Para no tener que volver a preocuparte por ello, cambia tu aplicación al modo «Producción» en Google Auth Platform.

Conectar Google Analytics a Claude

La integración de GA4 sigue la misma lógica: el mismo proyecto de Google Cloud, pero con una API y un ámbito diferentes. Te he preparado la guía complementaria: Cómo conectar Google Analytics 4 a Claude. Para conectarlos los dos a la vez, añade el osciloscopio analytics.readonly en el comando de conexión del paso 3.

El acompañamientoEl SEO que ya no se viene abajo con cada actualizaciónEl método de SEO replicable para crear estrategias adaptadas a la ubicación geográfica, sin tener que preocuparte por tus recomendaciones aunque cambien los algoritmos.Descubre el método →

Cómo conectar Google Search Console a Claude: guía paso a paso