Cómo conectar Google Search Console a Claude Code con MCP

¿Por qué conectar Search Console a un asistente de programación?

Claude Code es útil cuando el trabajo SEO afecta al propio sitio web. En el mismo entorno de desarrollo puedes inspeccionar plantillas, corregir redirecciones, cambiar títulos de página, probar una compilación y revisar un sitemap. Pero tu código fuente no puede decirte qué página perdió 300 clics de Google la semana pasada.

Sin acceso a Search Console, un asistente puede mirar una página y hacer sugerencias razonables. Lo que no puede es distinguir entre un problema de alta prioridad y algo que nadie busca. Esa diferencia importa cuando tienes poco tiempo.

Una conexión MCP añade la fuente de pruebas que faltaba. Puedes pedirle a Claude Code que identifique las URLs afectadas a partir de Search Console, las compare con las plantillas locales de las páginas y prepare cambios de código basados en una investigación real.

Esta guía trata el flujo de trabajo de Claude Code en la terminal, no el conector habitual del sitio web de Claude. Si trabajas sobre todo en un navegador, usa nuestra guía de configuración de Search Console en Claude.

Qué necesitas antes de ejecutar un comando

Necesitas tener Claude Code instalado y funcionando en una terminal, una cuenta de Google con acceso a la propiedad de Search Console que te interesa y un servidor MCP capaz de obtener los datos de esa propiedad. El servidor puede estar autoalojado o ser remoto.

Los pasos siguientes usan el endpoint alojado de GSC Magic. Según la documentación de GSC Magic, acepta el transporte Streamable HTTP y admite inicio de sesión mediante OAuth o un token de acceso. Tu cuenta debe estar dada de alta y el servicio debe ser accesible; escribir una URL válida no significa que la autenticación se haya completado.

Empieza por confirmar que Claude Code funciona por sí solo. Ábrelo en un proyecto normal y comprueba que puedes escribir prompts. No hace falta que clones todo tu sitio web de producción solo para probar una conexión de solo lectura con Search Console.

Antes de conectar, decide si el trabajo es para un sitio web o para varios. Es fácil elegir la propiedad de Search Console equivocada cuando una cuenta de Google tiene acceso a sitios de clientes, dominios de pruebas y propiedades antiguas de prefijo de URL.

Paso 1: añade el endpoint MCP remoto

Abre tu terminal y ejecuta el siguiente comando:

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp

Esto es lo que significa cada parte. claude mcp add registra un servidor en Claude Code. El transporte http indica que se trata de un servicio MCP remoto y no de un ejecutable local. --scope user hace que el conector esté disponible en tu configuración de usuario. El nombre corto gsc-magic es solo el identificador que verás en tu lista de herramientas.

La URL es el endpoint remoto documentado para GSC Magic. No es la URL de tu propiedad de Search Console, ni el sitemap de tu sitio, ni un endpoint de API de Google.

¿Por qué usar el ámbito de usuario? Si haces trabajo SEO en varios proyectos locales, una conexión de ámbito de usuario es cómoda. Para un repositorio compartido o un entorno de cliente sensible, revisa las reglas de ámbito de configuración de Claude Code y la política de tu equipo antes de añadir integraciones externas.

Puedes consultar el comando MCP general y la guía sobre transportes en la documentación de Claude Code de Anthropic. Míralo si una opción de la CLI cambia en una versión más reciente.

Paso 2: autentícate en Claude Code

Inicia Claude Code y escribe:

/mcp

Selecciona el servidor gsc-magic. Si el cliente ofrece una acción Authenticate, síguela y completa el inicio de sesión en el navegador. Usa la cuenta de Google que tenga los permisos correctos sobre la propiedad de Search Console.

No envíes tu contraseña de Google, el código de autorización de OAuth ni un token de acceso como un mensaje normal del chat. La autenticación es un paso aparte que gestionan el cliente y el servidor. Si el navegador se abre pero la autorización nunca se completa, vuelve al menú MCP y revisa el estado de la conexión antes de repetir el intento.

Algunos entornos no pueden completar OAuth en el navegador. En esos casos, GSC Magic documenta tokens de acceso personal en Connect → Access tokens de su panel. Una conexión con token usa una cabecera, por ejemplo:

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp \
  --header "Authorization: Bearer gsm_YOUR_TOKEN"

Esto es una plantilla, no una credencial que funcione. Sustituye el marcador en un flujo de configuración local seguro y no lo subas a Git. Si solo necesitas informes de analítica y de indexación, crea un token de solo lectura. La documentación de la plataforma explica la caducidad, la revocación y los permisos de los tokens.

Paso 3: comprueba que la conexión funciona

No empieces con «audita todo mi sitio y arréglalo todo». Pide una respuesta que puedas verificar.

Lista las propiedades de Google Search Console a las que puede acceder esta conexión. Incluye los identificadores exactos de las propiedades y sus niveles de permiso si están disponibles. No analices ninguna propiedad hasta que yo la seleccione.

Con esto compruebas varias cosas a la vez: que el cliente puede descubrir las herramientas del servidor, que el servidor puede autenticarse en Google y que tu cuenta de Google ve al menos una propiedad.

Selecciona el identificador exacto de la propiedad que necesitas. Una propiedad con el formato sc-domain:example.com puede incluir subdominios. Una propiedad de prefijo de URL como https://www.example.com/ cubre un conjunto de URLs más reducido. Una discrepancia que pase desapercibida puede hacer que una comparación de tráfico parezca errónea aunque la herramienta funcione perfectamente.

Si la lista sale vacía, revisa primero tu cuenta de Google y los permisos sobre la propiedad. No des por hecho que el servidor está roto.

Paso 4: ejecuta una primera comparación SEO útil

Una buena primera tarea es acotada, medible y fácil de repetir:

Para la propiedad de Search Console seleccionada, compara los últimos 28 días completos de datos con los 28 anteriores. Muestra los intervalos de fechas exactos y los clics, las impresiones y el CTR totales, y lista después las diez páginas con mayores pérdidas absolutas de clics. Usa datos de Search Console, no estimaciones. Etiqueta como hipótesis las posibles explicaciones.

Puedes revisar ese informe en la interfaz de Rendimiento de Search Console. Si los totales difieren, verifica las opciones de agregación, las zonas horarias, los tipos de búsqueda y si los datos ya son definitivos. Google cuenta los clics y las impresiones según sus propias definiciones de informe, no según las reglas de sesión de GA4.

A continuación, pide a Claude Code que profundice en una página:

Para la URL con mayor pérdida, compara sus diez consultas principales entre los dos periodos. Agrupa por dispositivo y por país los cambios relevantes. Dime qué observaciones justifican investigar la plantilla de la página y cuáles no.

Aquí es donde un asistente de programación se vuelve útil. Si la página perdió visibilidad en móvil, podrías revisar la navegación móvil, el diseño adaptable y el renderizado. Si perdió impresiones en un grupo reducido de consultas, podrías examinar el contenido de la página y sus enlaces internos. Pero no dejes que el modelo trate una correlación como una prueba.

Paso 5: relaciona los datos con el código real de tu sitio

Supón que Search Console identifica una URL de producto importante con un porcentaje de clics en descenso. Pide a Claude Code que encuentre la ruta o la plantilla responsable del título HTML, la descripción y los encabezados de la página.

Una secuencia razonable es esta:

1. Localiza la página o la plantilla en tu proyecto.
2. Inspecciona el título actual, la URL canónica, la estructura de encabezados y el contenido principal.
3. Lee las consultas que generaron impresiones para la página.
4. Sugiere una mejora limitada que encaje con el contenido real de la página.
5. Muestra un diff antes de hacer cambios.
6. Ejecuta tu compilación y tus pruebas habituales.
7. Anota la fecha de publicación para poder comparar después.

No todas las páginas con CTR bajo necesitan un título nuevo. Una página puede posicionar para consultas informativas amplias con poca intención de clic, o su posición media puede haber cambiado. Usa la guía de análisis de CTR bajo antes de reescribir metadatos a partir de una sola cifra.

No le digas nunca a Claude Code que elimine o redirija páginas solo porque dos URLs comparten una consulta. Eso puede causar más daño que el problema original.

Cómo montar un flujo de trabajo semanal repetible

Puedes guardar el prompt de análisis en tus notas o en el runbook interno de tu proyecto. Claude Code no necesita recordar la conversación anterior si el prompt especifica los parámetros del informe.

Pide siempre las mismas ventanas completas de 7 o de 28 días e incluye la propiedad seleccionada. Haz que el asistente devuelva una tabla con la URL, los clics de cada periodo, el cambio absoluto, el cambio relativo y la consulta que más contribuye al cambio. Mantén la primera versión en solo lectura.

Después del informe, pide un plan de acción limitado a tres elementos. Una buena acción tiene una señal observada, una comprobación propuesta, un responsable y una forma de medir el resultado.

Por ejemplo: «La página de documentación perdió 120 clics, sobre todo en consultas de configuración desde escritorio. Comprueba si la página responde ya a la versión actual de las instrucciones de integración; actualízala solo si el contenido está desfasado». Eso es mucho más accionable que «Mejorar la calidad del contenido».

Si programas scripts o agentes, controla las llamadas repetidas y respeta las cuotas de la API de Search Console. Un informe semanal no debería necesitar cientos de solicitudes duplicadas.

Solución de problemas habituales

Si el asistente informa de un error de una herramienta, lee el error real antes de probar otro prompt. Reformular una consulta no arreglará un token revocado ni un sitio al que tu cuenta no puede acceder.

La referencia de la API de Search Analytics de Google documenta los límites de fechas, las dimensiones, los límites y la agregación. Entender esos límites evita un número sorprendente de diagnósticos SEO erróneos.

Permisos y seguridad cuando se juntan el código y los datos de búsqueda

Conectar datos de Search Console a un asistente de programación es potente porque el asistente también puede tener acceso al sistema de archivos. Justamente por eso conviene separar la investigación de la implementación.

Trata las herramientas de informes como de solo lectura siempre que sea posible. Pide propuestas de diffs de código y revísalas antes de que el asistente escriba o despliegue nada. Usa tu flujo de Git y tus comprobaciones habituales. Si trabajas con propiedades de clientes, evita combinar en un mismo informe los datos de clientes que no tienen relación entre sí.

GSC Magic documenta tokens de solo lectura y controles separados para el modo de escritura. Sus herramientas de Google Search Console incluyen la lectura de analítica y del estado de las URLs indexadas, mientras que las acciones administrativas, como enviar un sitemap, requieren un permiso más fuerte. Esa separación importa más que cuántas herramientas liste el conector.

Recuerda que la API de inspección de URLs de Google no solicita la indexación. Sus resultados sobre la versión indexada son distintos de una prueba de la URL en vivo. La Google Indexing API, que es otra distinta, admite solo ciertos tipos de contenido y no debe usarse como atajo para páginas corrientes.

Preguntas frecuentes

¿Puede Claude Code acceder directamente a Google Search Console, sin MCP?

No por defecto. Necesitarías otra vía autorizada, como un script de API a medida o una exportación importada. MCP es una forma estándar de exponer esas llamadas como herramientas que Claude Code puede usar.

¿Es la misma configuración que Claude en la web?

No. Claude Code usa una configuración MCP gestionada desde la CLI. La aplicación web de Claude tiene su propia interfaz de conectores. La fuente de datos puede ser la misma, pero los pasos de conexión son distintos.

¿Puede Claude Code corregir automáticamente problemas de SEO técnico?

Puede ayudar a editar los archivos a los que tiene permiso de acceso, pero las pruebas de Search Console no demuestran que cada cambio sugerido sea correcto. Revisa los diffs, prueba las compilaciones y exige aprobación humana para el despliegue.

¿Conocerá el agente mis conversiones de Google?

Solo si autorizas una fuente de analítica adecuada. Search Console informa de clics e impresiones de búsqueda; para las sesiones y los eventos clave hace falta GA4.

¿Qué tarea debería probar primero?

Empieza con una comparación de dos periodos completos de 28 días y las diez páginas con mayores pérdidas de clics. Puedes confirmar esas cifras antes de plantear ningún cambio de código.

La conclusión práctica

Claude Code funciona mejor como puente entre el comportamiento de búsqueda medido y el sitio web que realmente puedes mejorar. Usa el conector para identificar un problema, el código base para investigarlo y tu proceso de revisión habitual para hacer los cambios con seguridad.

Si quieres consultar las herramientas, las opciones de token y las opciones de conexión documentadas en este momento, ten abierta la documentación de GSC Magic mientras configuras tu cliente. Para más ideas de análisis, usa nuestros 25 prompts para agentes SEO.