Un servidor MCP de Google Search Console da a un agente de IA, como Claude, Claude Code, Codex o Cursor, acceso a la API de Search Console. El agente puede obtener tus clics, impresiones, CTR (porcentaje de clics) y posición media, comprobar si una página está indexada y listar tus sitemaps. Tú preguntas con tus propias palabras, por ejemplo «¿qué páginas salen en la primera página de resultados pero no reciben clics?», y el agente lanza las consultas y analiza las filas. Esta guía compara las tres formas de configurarlo, explica lo que la API deja fuera y recorre una primera auditoría que puedes contrastar tú mismo con Search Console.
En resumen: a 9 de noviembre de 2026, Google no tiene un servidor MCP oficial para Search Console. Google publica uno para Google Analytics, y ni el directorio de Claude ni el de ChatGPT incluyen un conector de Search Console de Google, Anthropic u OpenAI. Tus opciones son un servidor comunitario gratuito que ejecutas tú mismo y que necesita un proyecto de Google Cloud; un servidor alojado en el que inicias sesión con Google; o una aplicación con un conector integrado, como Orkas, en la que basta con hacer clic en Conectar. Las tres leen la misma API, y esta no muestra todas las consultas: Google deja fuera las consultas anonimizadas, que supusieron el 46,77 % del tráfico en un estudio de Ahrefs sobre 887.534 propiedades de Search Console.
Qué puede y qué no puede hacer un MCP de Search Console
Todos los servidores MCP de Search Console, comunitarios o comerciales, llaman a la misma API gratuita de Search Console. Lo que pueden hacer depende de esa API, que resumimos a continuación a partir de la referencia de la API y los límites de uso de Google.
| Lo que pides | API | Límites |
|---|---|---|
| Clics, impresiones, CTR y posición por consulta, página, país, dispositivo, fecha o aparición en búsquedas | Search Analytics | 16 meses de historial, con unos 2–3 días de retraso; hasta 25.000 filas por solicitud y 50.000 filas al día por tipo de búsqueda |
| Si una URL está indexada, su último rastreo y la canónica que eligió Google | URL Inspection | Una URL por llamada; 2.000 llamadas al día por propiedad |
| Tus sitemaps y sus errores | Sitemaps | Leerlos requiere acceso de solo lectura; enviarlos o eliminarlos, acceso total |
| Las propiedades a las que tienes acceso | Sites | Añadir o quitar una propiedad requiere acceso total |
Algunas cosas de Search Console no tienen API, así que ningún servidor MCP puede obtenerlas:
- Datos de las Vistas creadas con IA y del Modo IA. Google extendió el informe de rendimiento de la IA generativa a todos los sitios el 31 de agosto de 2026, pero la referencia de la API no recoge ningún tipo de búsqueda ni aparición en búsquedas para ese informe.
- Las opciones más nuevas de los informes. El tipo de búsqueda multimodal y el filtro de consultas de marca tampoco aparecen en la referencia de la API.
- Probar una página publicada. La inspección de URLs informa sobre la versión que hay en el índice de Google. La documentación de la API lo dice claramente: «no se puede probar la indexabilidad de una URL publicada».
- El botón «Request indexing» (Solicitar indexación). Solo existe en Search Console. La API de indexación de Google, que es independiente y a la que llaman algunos servidores, oficialmente solo sirve para páginas de ofertas de empleo y de emisiones en directo.
Tres formas de conectar Search Console a Claude, Claude Code o Codex
| Opción | Configuración | Por dónde pasan tus datos | Coste |
|---|---|---|---|
| Servidor comunitario que ejecutas tú, como mcp-gsc | Proyecto de Google Cloud, API, credenciales y una entrada en la configuración | De tu ordenador a Google | Gratis |
| Servidor alojado, como mcpsearchconsole.com | Iniciar sesión con Google y pegar la URL del servidor en tu app de IA | Por los servidores del proveedor | Plan gratuito y después suscripción |
| Conector integrado en Orkas | Hacer clic en Conectar e iniciar sesión con Google | De tu ordenador a Google | Conector gratuito |
- Los servidores comunitarios son gratuitos y los más completos. El más popular, AminForou/mcp-gsc, tenía 2.151 estrellas en GitHub el 9 de noviembre de 2026. Su código incluye 21 herramientas, entre ellas comparaciones entre periodos, inspección por lotes de hasta 10 URLs y, si lo permites, el envío de sitemaps. Lo que cuesta es la configuración: tienes que crear tus propias credenciales de Google. Un usuario de r/TechSEO describió Google Cloud como «el único punto de fricción».
- Los servidores alojados son la vía más rápida para usarlo en claude.ai o en ChatGPT desde el navegador. Son servidores remotos, así que se añaden por URL. El centro de ayuda de Claude indica que los conectores personalizados funcionan en todos los planes, pero «los usuarios del plan gratuito están limitados a un conector personalizado». mcpsearchconsole.com anuncia un plan gratuito con 40 extracciones de datos al mes en tres propiedades y, a partir de ahí, 4,99 € al mes sin IVA. Tus datos de Search Console pasan por el proveedor, así que lee antes sus condiciones de privacidad.
- Un conector integrado te ahorra la configuración de Google Cloud. En Orkas inicias sesión con Google y el conector se ejecuta en tu ordenador. Es de solo lectura y tiene cuatro herramientas, menos que los servidores comunitarios.
Usar tu propio servidor comunitario
Estos pasos siguen el README de mcp-gsc en su versión 0.4.2 (6 de noviembre de 2026). No hemos creado un proyecto de Google Cloud para esta guía, así que consulta el README antes de empezar.
- Crea las credenciales de Google. En la consola de Google Cloud, crea un proyecto, habilita la API de Search Console y crea un ID de cliente de OAuth de tipo Desktop app. Descarga su archivo JSON. Si lo que quieres es automatizar, crea en su lugar una cuenta de servicio y añade su dirección de correo en Search Console, en la sección Usuarios y permisos de Ajustes, con acceso total.
- Instala uv. La vía que recomienda el README ejecuta el servidor con
uvx, que se encarga de Python por ti. Sin él, necesitas Python 3.11 o posterior. - Añade el servidor a tu agente. En Claude Code:
En Codex:claude mcp add --env GSC_OAUTH_CLIENT_SECRETS_FILE=/path/to/client_secrets.json --transport stdio gsc -- uvx mcp-search-console
Hemos comprobado los dos comandos con Claude Code 2.1.311 y Codex CLI 0.163.0. Para Claude Desktop o Cursor, el README da una configuración JSON con la ruta completa acodex mcp add gsc --env GSC_OAUTH_CLIENT_SECRETS_FILE=/path/to/client_secrets.json -- uvx mcp-search-consoleuvx, porque las apps que se abren desde el Dock o el menú Inicio pueden no encontrarlo si no se indica. - Inicia sesión una vez. La primera vez que lo uses, se abrirá una ventana del navegador para iniciar sesión con Google. Desde la versión 0.4.2, el servidor pide únicamente acceso de solo lectura, salvo que definas
GSC_ALLOW_DESTRUCTIVE=true.
Hay un detalle que las guías de la comunidad no mencionan: si la pantalla de consentimiento de OAuth está configurada como External y se queda en Testing, la documentación de OAuth de Google indica que el token de actualización caduca a los 7 días. Tendrías que volver a iniciar sesión cada semana. Para evitarlo, publica la app en producción o usa una cuenta de servicio. Una app publicada puede mostrar el aviso de «app no verificada», que Google permite saltarse en las apps de uso personal con menos de 100 usuarios.
Conectar Search Console en Orkas
Orkas es una aplicación de escritorio para macOS y Windows en la que varios agentes de IA trabajan en un mismo chat. Su conector de Google Search Console viene integrado, así que no necesitas un proyecto de Google Cloud.
- Instala Orkas e inicia sesión. Descárgalo para macOS o Windows. Las cuentas nuevas reciben 500 créditos gratis para los modelos integrados de Orkas, así que no necesitas una clave de API para empezar.
- Abre Conectores. Haz clic en Conectores en la barra lateral y busca Google Search Console. Puedes llegar con el filtro Datos o con el cuadro de búsqueda.
- Haz clic en Conectar e inicia sesión con Google. Haz clic en Conectar, usa la cuenta de Google que tiene acceso a tu propiedad y concede acceso de solo lectura. La tarjeta pasa a Conectados.
- Pide lo que necesites. En un chat, escribe @ y elige el conector de Google Search Console, o simplemente describe la tarea. El agente primero enumera tus propiedades y luego consulta la que le indiques.
- Es de solo lectura. Orkas solo pide a Google el permiso
webmasters.readonly. Las cuatro herramientas enumeran tus propiedades, consultan los datos de rendimiento, enumeran los sitemaps e inspeccionan una URL. Como solo leen, Orkas las ejecuta sin pedirte que apruebes cada llamada. No pueden enviar sitemaps ni solicitar la indexación, y cada consulta devuelve como máximo 25.000 filas. - Las consultas van directamente a Google. El conector se ejecuta en tu ordenador y llama directamente a la API de Search Console. Solo el inicio de sesión con Google y la renovación del token pasan por el servidor de Orkas, que guarda las credenciales de Google de la aplicación.
- SeoGeoAgent y tus agentes de programación pueden usarlo. SeoGeoAgent, el agente de SEO integrado en Orkas, usa tus clics, impresiones y posiciones reales en sus auditorías en cuanto Search Console está conectado. Si has instalado Claude Code, Codex, OpenCode, Hermes u OpenClaw y lo has conectado en Orkas, accede al conector a través del puente de herramientas de Orkas, sin tener que configurar MCP por su cuenta.
- ¿Necesitas acceso de escritura? Usa Añadir servidor MCP en la página Conectores para añadir un servidor comunitario como comando local. Orkas también tiene un conector de Bing Webmaster Tools.
Una primera auditoría que puedes comprobar
Una buena primera petición pide cifras que puedas comparar con Search Console en un minuto y obliga al agente a decir qué no cubren los datos. Sustituye la propiedad y las dos URLs por las tuyas:
Usa el conector de Google Search Console para sc-domain:example.com. Con los últimos 28 días de datos completos: 1) clics e impresiones totales por fecha, y qué parte de ellos cubren las filas de consultas; 2) páginas entre las posiciones 5 y 15 con al menos 100 impresiones y un CTR inferior al 2%, ordenadas por impresiones; 3) el estado de indexación de https://example.com/new-page/ y https://example.com/old-page/. Indica el intervalo de fechas en cada tabla y no estimes nada que los datos no muestren.
Ejecutamos esta petición con Claude Code en Orkas el 9 de noviembre de 2026, y las cuatro herramientas del conector funcionaron. No publicamos las cifras de Search Console de nuestro propio sitio, así que los resultados que siguen son un ejemplo sintético: cifras inventadas de una tienda ficticia en example.com, que muestran cómo es una respuesta cuidadosa y cómo comprobar cada parte.
- Totales por fecha (datos sintéticos): 3.480 clics y 151.200 impresiones. Son las cifras en las que confiar para el conjunto del sitio. Para comprobar las tuyas, abre el informe de Rendimiento, elige las mismas fechas personalizadas y el mismo tipo de búsqueda, y compara los totales. Deberían salir muy parecidos. Una diferencia grande suele indicar que el agente ha sumado, en su lugar, filas de consultas o de páginas.
- Filas de consultas (datos sintéticos): 642 filas que cubren 1.670 clics, el 48 % del total. El resto procede de consultas que Google anonimiza, que no tienen fila ni en el informe ni en la API. Una proporción así es normal: Ahrefs comprobó que las consultas anonimizadas supusieron el 46,77 % del tráfico en abril de 2025, y más en muchos sitios. Un agente que suma las filas de consultas y lo presenta como tu tráfico puede quedarse en la mitad de la cifra real.
- Páginas con CTR bajo (datos sintéticos): 9 páginas entre las posiciones 5 y 15 con al menos 100 impresiones y un CTR inferior al 2 %. La de más impresiones,
/blog/linen-care/, tuvo 2.140 con una posición media de 6,8 y 21 clics, un CTR del 1,0 %. Esos son los primeros títulos y descripciones que conviene revisar. Si tu sitio publica cada idioma en direcciones que terminan en?lang=, cada versión tiene su propia fila de página, así que pide que las agrupe. - Inspección de URLs (datos sintéticos): la página antigua está indexada y la nueva todavía no.
https://example.com/old-page/, publicada en septiembre, aparecía como «Submitted and indexed», con el último rastreo el 3 de octubre.https://example.com/new-page/, publicada dos días antes de la comprobación, aparecía como «Discovered - currently not indexed». Para comprobarlo, pega la misma URL en la barra de inspección de la parte superior de Search Console.
Cinco errores habituales
- Tomar las filas de consultas por el tráfico total. La guía de Google sobre los datos de rendimiento explica que las consultas anonimizadas no tienen fila: «si sumas los clics de todas las filas, no obtendrás el mismo número de clics que en los totales del gráfico». Para los totales, pide los datos por fecha sin filtro de consulta.
- Comparar los totales por página con los del sitio. Al agrupar por página, cada URL que aparece en un resultado se cuenta por separado. Al agrupar por propiedad, un resultado cuenta una sola vez para todo el sitio. Por eso, las filas de páginas pueden sumar más impresiones que el total del sitio.
- Olvidar el retraso. Los datos «suelen estar disponibles al cabo de 2-3 días». La API devuelve datos definitivos salvo que se le pidan datos recientes, así que «los últimos 7 días» terminan unos días antes de hoy.
- Escribir mal el nombre de la propiedad. Una propiedad de dominio se escribe
sc-domain:example.com. Una propiedad de prefijo de URL es la dirección completa con la barra final, comohttps://example.com/. Deja que el agente enumere primero tus propiedades y copia el nombre que devuelva. - Pedir demasiado de una vez. Cada solicitud devuelve como máximo 25.000 filas, y un desglose por consulta y página de 16 meses llega enseguida a ese límite. Pide resúmenes, un filtro o un intervalo de fechas más corto, y deja que el agente procese las filas en lugar de pegarlas todas en el chat.
¿Qué opción te conviene?
| Tu caso | Elige |
|---|---|
| Usas claude.ai o ChatGPT en el navegador | Un servidor alojado, añadido por URL |
| Quieres todas las herramientas, incluido el envío de sitemaps, y no te importa Google Cloud | Un servidor comunitario como mcp-gsc |
| Quieres que Claude Code, Codex y un agente de SEO lean Search Console sin Google Cloud | El conector integrado de Orkas |
| Tu sitio es demasiado grande para 25.000 filas por solicitud | La exportación masiva de datos de Search Console a BigQuery, fuera de MCP |
Preguntas frecuentes
¿Tiene Google un servidor MCP oficial para Search Console?
No, a 9 de noviembre de 2026 no lo tiene. Search Console no figura en la lista de servidores MCP oficiales de Google ni en la lista de MCP de Google Cloud. Google publica un servidor MCP para Google Analytics, que no incluye datos de Search Console.
¿Es gratis un MCP de Search Console?
La API de Search Console es gratuita, y también lo son los servidores comunitarios como mcp-gsc y el conector de Orkas. Los servidores alojados suelen tener un plan gratuito con un límite mensual y un plan de pago. El agente de IA que conectes tiene, aun así, su propio coste, como un plan de Claude o los créditos de Orkas.
¿Puede un servidor MCP enviar sitemaps o solicitar la indexación?
Puede enviar o eliminar sitemaps si tiene acceso total a Search Console, algo que ofrecen algunos servidores comunitarios. La API de Search Console no tiene la función Request indexing, así que ningún servidor puede hacerlo con páginas normales. El conector de Orkas es de solo lectura y no hace ninguna de las dos cosas.
¿Por qué las cifras del MCP no coinciden con Search Console?
Normalmente porque el agente ha sumado filas de consultas, que dejan fuera las consultas anonimizadas, o ha mezclado totales por página con totales por propiedad. Pide totales por fecha sin filtro de consulta, con las mismas fechas y el mismo tipo de búsqueda que el informe. Así, los totales deberían salir muy parecidos.
¿Funciona con Claude Code y Codex?
Sí. Añade un servidor comunitario con claude mcp add o codex mcp add, o añade un servidor alojado por URL. En Orkas, Claude Code y Codex usan el conector integrado de Search Console a través del puente de herramientas de Orkas, sin configurar nada en ninguna de las dos herramientas.
¿Qué es el Agentic SEO? ofrece una visión más amplia: un agente se encarga del trabajo de SEO con datos actualizados y una persona aprueba lo que se publica.