Google Search Console MCP

Search Console es el único conjunto de datos de marketing que es gratuito, de primera mano y veraz: lo que Google realmente mostró para tu sitio y lo que la gente realmente hizo clic. También está atrapado detrás de una interfaz que responde una pregunta a la vez. Un servidor MCP cambia eso. Preguntas "qué páginas perdieron clics después de la última actualización, y qué consultas perdieron", y el agente ejecuta la comparación.

Nosotros mismos ejecutamos un servidor Search Console MCP para nuestro propio sitio y para clientes. Esta guía cubre qué existe, cómo configurar uno y qué hacer con él una vez conectado. La configuración para cada cliente está en Claude Code, Cursor y Claude Desktop.

Qué servidores existen

Google no ha publicado un servidor oficial de Search Console. Varios servidores comunitarios envuelven la API; los buenos exponen cuatro o cinco herramientas que se corresponden con la pequeña superficie de la API:

• list_sites: las propiedades que la credencial puede ver.
• search_analytics: clics, impresiones, CTR y posición, filtrados y agrupados por consulta, página, país, dispositivo y fecha.
• compare_periods: la misma consulta para dos rangos de fechas, con deltas.
• inspect_url: estado de indexación, canónica, último rastreo, usabilidad móvil para una URL.
• list_sitemaps: sitemaps enviados y su estado.

Si un servidor ofrece mucho más que eso, pregunta para qué. La API no hace mucho más, y un servidor pequeño es más fácil de revisar.

Debido a que la API es de solo lectura, este es el servidor de marketing de menor riesgo que puedes añadir. El agente no puede cambiar nada en Search Console.

Configurarlo con una cuenta de servicio

La ruta de la cuenta de servicio es la que recomendamos para equipos, porque separa el acceso del agente de cualquier inicio de sesión personal de Google.

1. Crea una cuenta de servicio en Google Cloud (IAM, Cuentas de servicio). No se necesitan roles en el propio proyecto.
2. Habilita la API de Search Console para ese proyecto de Google Cloud.
3. Crea una clave JSON para la cuenta de servicio y guárdala en algún lugar que el servidor pueda leer, fuera del repositorio.
4. Añade el correo electrónico de la cuenta de servicio como usuario en cada propiedad de Search Console, con permiso Completo o Restringido. Restringido es suficiente para análisis; la inspección de URL necesita Completo en algunas configuraciones.
5. Apunta el servidor a la clave, típicamente a través de una variable de entorno, y añádela a tu cliente.

Para Claude Code, eso se ve así:

claude mcp add --transport stdio gsc \
  -e GSC_SERVICE_ACCOUNT_FILE=/path/to/service-account.json \
  -- gsc-mcp

Las propiedades se abordan de la manera en que la API las aborda: sc-domain:example.com para propiedades de dominio, https://example.com/ para propiedades de prefijo de URL. Un buen servidor expone list_sites para que el agente pueda descubrirlas en lugar de adivinarlas.

Qué preguntar una vez conectado

El valor está en preguntas que tomarían una tarde de exportaciones en la interfaz:

• "¿Qué consultas generan más clics a nuestra página de precios, y cuál es nuestra posición promedio para cada una?"
• "Compara los últimos 28 días con los 28 anteriores. ¿Qué páginas perdieron más clics, y qué consultas en esas páginas cayeron?"
• "¿Qué consultas reciben impresiones en la página dos (posiciones 11 a 20) con más de 500 impresiones? Esas son las victorias rápidas."
• "¿Está /guides/mcp indexada, y cuál es la canónica de Google para ella?"
• "Enumera cada consulta que contenga 'mcp' y agrupa por página de destino."

Informa al agente sobre el retraso de datos, y dile que Search Console muestrea y anonimiza las consultas de cola larga, por lo que los totales por consulta no coincidirán con los totales por página.

Combinar con otros servidores

Search Console solo responde "qué mostró Google y qué se hizo clic". Combinado con Google Analytics responde "y qué hicieron esos visitantes", y con Ahrefs responde "y por qué podríamos posicionar que aún no lo hacemos". Esa combinación de tres servidores es el núcleo de un agente SEO, y la razón por la que existen skills: una skill de "revisión SEO mensual" que ejecuta las mismas uniones cada vez.

Ejecutarlo para un equipo

La credencial en el paso 3 es un archivo de clave que otorga acceso de lectura a todos tus datos de búsqueda. En una laptop, está a una máquina perdida de una fuga, y no es atribuible a una persona. En una configuración de equipo, la clave pertenece a una puerta de enlace que la mantiene centralmente, expone el servidor a usuarios aprobados y registra quién preguntó qué.

Así es como ejecutamos el nuestro: el servidor de Search Console está detrás de Walma AI Hub dentro de nuestro propio inquilino de Azure, junto a Google Ads, Ahrefs y el resto, y cada llamada del agente está en un solo registro. Si quieres lo mismo para tu equipo de marketing, reserva una demostración.

Preguntas frecuentes

¿Existe un servidor MCP oficial de Google Search Console?+

No. Google publica servidores MCP oficiales para Google Ads y Google Analytics, pero no para Search Console al momento de escribir esto. Los servidores comunitarios envuelven la API de Search Console y son sencillos porque la API es pequeña y de solo lectura.

¿Qué puede hacer un agente de IA con Search Console a través de MCP?+

Todo lo que permite la API de Search Analytics: clics, impresiones, CTR y posición por consulta, página, país, dispositivo y fecha; comparaciones de períodos; inspección de URL para estado de indexación; y la lista de sitemaps. No puede cambiar nada, lo que lo convierte en el servidor de marketing más seguro para empezar.

¿Cómo se autentica un servidor MCP de Search Console?+

Ya sea con OAuth como usuario, o con una cuenta de servicio de Google Cloud que añades a la propiedad de Search Console como usuario. La ruta de la cuenta de servicio es mejor para equipos: sin inicio de sesión personal, una clave que puedes rotar y acceso de solo lectura que puedes revocar.

¿Los datos de Search Console a través de MCP tienen retraso?+

Sí, igual que en la interfaz: los datos de análisis de búsqueda típicamente están dos o tres días atrasados. Se debe informar al agente para que no reporte ayer como un colapso de tráfico.