Saltar al contenido
Raúl Veneri
Contacto

Google Search Console en Claude Code

Guía paso a paso para conectar Google Search Console a Claude Code por MCP con una service account. Reutiliza la misma credencial que ya usas para Google Analytics, así que si vienes de esa guía casi lo tienes. Al terminar, le preguntas a Claude por el rendimiento orgánico de tu sitio en lenguaje natural: queries, páginas, clics, impresiones, CTR y posición media.

github.com/AminForou/mcp-gsc

Qué vas a montar

El servidor MCP de Search Console se ejecuta en local y hace de puente entre Claude Code y la Search Console API. Piezas necesarias:

  • uv / uvx: lanza el paquete mcp-search-console sin instalar nada de forma permanente.
  • Claude Code: el cliente MCP donde registras el servidor.
  • Proyecto de Google Cloud: con la Search Console API habilitada.
  • Service account con clave JSON: la identidad que accede a tus datos de GSC en modo lectura.
Si ya conectaste Google Analytics con la guía de GA4 en Claude Code vía MCP, reutiliza esa misma service account y su clave: no necesitas crear una nueva.

Reutiliza la cuenta de Google Analytics

La misma service account sirve para GA4 y para Search Console. La recomendación es usar una sola cuenta para tus propias herramientas, con un nombre que las englobe (por ejemplo mcp-google-data), y una cuenta por cliente solo si gestionas datos de terceros. El porqué está detallado en la guía de GA4.

  • Si ya tienes la cuenta de GA4: salta la creación de la service account y la clave. Solo te falta habilitar la API de Search Console (paso 1) y darle acceso en GSC (paso 2).
  • Si empiezas de cero: crea la cuenta mcp-google-data y descarga su clave JSON como se explica en la guía de GA4, y sigue aquí.

1. Habilitar la Search Console API

En la consola de Google Cloud, en el mismo proyecto que usas para GA4: APIs y servicios, Biblioteca, busca Google Search Console API y pulsa Habilitar.

2. Dar acceso a tu propiedad en Search Console

Copia el email de la service account (tiene la forma mcp-google-data@TU_PROJECT_ID.iam.gserviceaccount.com). En Search Console:

  • Elige la propiedad.
  • Entra en Configuración (Settings) y luego Usuarios y permisos (Users and permissions).
  • Pulsa Añadir usuario, pega el email de la cuenta.
  • Asigna el permiso Completo (Full) y pulsa Añadir.
Da igual que la propiedad sea de tipo Dominio o de Prefijo de URL: en las dos se añade el usuario desde Configuración, Usuarios y permisos. Eso sí, necesitas ser propietario de la propiedad para poder añadir usuarios.

3. Guardar la clave de forma segura

Si ya la guardaste al conectar GA4, ya está en su sitio y puedes saltar este paso. Si es la primera vez, colócala fuera de cualquier repositorio Git, con permisos restringidos.

En Linux o macOS:

mkdir -p ~/.config/gcloud-mcp && chmod 700 ~/.config/gcloud-mcp
mv ~/Descargas/TU_CLAVE.json ~/.config/gcloud-mcp/sa-key.json
chmod 600 ~/.config/gcloud-mcp/sa-key.json

En Windows, una ruta equivalente es %APPDATA%\gcloud-mcp\sa-key.json.

Apunta la ruta absoluta del archivo: la necesitas en el siguiente paso y las variables de entorno no expanden ~.

4. Registrar el servidor en Claude Code

Comprueba primero que uvx puede lanzar el paquete (la primera vez lo descarga, tarda un poco):

uvx mcp-search-console --help

Añade el servidor con scope user (disponible en todos tus proyectos; quítalo para dejarlo solo en el proyecto actual). Usa la ruta absoluta de la clave:

claude mcp add gsc --scope user \
  -e GSC_CREDENTIALS_PATH=/ruta/absoluta/sa-key.json \
  -e GSC_SKIP_OAUTH=true \
  -- uvx mcp-search-console
La variable GSC_SKIP_OAUTH=true fuerza el modo service account, sin login de navegador.

5. Verificar

  • Ejecuta claude mcp list: gsc debe aparecer como Connected.
  • Reinicia Claude Code (los servidores MCP se cargan al arrancar la sesión).
  • Prueba en lenguaje natural: "mejores queries de Search Console del último mes", "páginas con más clics", "CTR y posición media de las últimas 4 semanas".
Si sale Connected pero las consultas no devuelven datos, casi siempre falta añadir la service account en Search Console (paso 2) o se añadió en otra propiedad. Connected solo confirma que el servidor arranca.

Herramientas que expone el servidor

  • Listar las propiedades a las que tiene acceso la cuenta.
  • Consultar el rendimiento de búsqueda (clics, impresiones, CTR, posición) por query, página, país o dispositivo.
  • Comparar periodos y filtrar por dimensiones.
  • Revisar el estado de indexación y los sitemaps de la propiedad.

Seguridad

  • No commitees la clave JSON. Vive fuera del repo, con permisos restringidos.
  • El acceso es de solo lectura: consulta datos de rendimiento, no modifica tu configuración de Search Console.
  • Para revocar el acceso: quita la cuenta en Configuración, Usuarios y permisos, o borra la clave en la consola de Google Cloud.
  • Para rotar la clave: crea una nueva, reemplaza el archivo y borra la vieja. Si mantienes la misma ruta, no hace falta volver a registrar el servidor.