Orkas Orkas
Inicio Blog Google Search Console MCP
Producto

Google Search Console MCP: tres formas de configurarlo y una primera auditoría

Google no ofrece un servidor MCP para Search Console, así que te toca elegir entre un servidor comunitario, uno alojado o una app con un conector integrado. Aquí te contamos qué requiere cada opción, qué deja afuera la API y una primera auditoría que puedes verificar tú mismo.

Un servidor MCP de Google Search Console le da a un agente de IA, como Claude, Claude Code, Codex o Cursor, acceso a la API de Search Console. El agente puede traer tus clics, impresiones, CTR (porcentaje de clics) y posición media, revisar si una página está indexada y listar tus sitemaps. Tú preguntas con tus propias palabras, por ejemplo “¿qué páginas aparecen en la primera página de resultados pero no reciben clics?”, y el agente ejecuta las consultas y revisa las filas. Esta guía compara las tres formas de configurarlo, explica lo que la API deja afuera y te lleva por una primera auditoría que puedes verificar tú mismo en Search Console.

En pocas palabras: al 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 tienen un conector de Search Console hecho por 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 al que accedes con tu cuenta de Google; o una app con un conector integrado, como Orkas, donde solo haces clic en Conectar. Las tres leen la misma API, y esta no muestra todas las consultas: Google deja afuera las consultas anonimizadas, que representaron 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 abajo con base en la referencia de la API y los límites de uso de Google.

Lo que pidesAPILímites
Clics, impresiones, CTR y posición por consulta, página, país, dispositivo, fecha o aparición en búsquedasSearch Analytics16 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ó GoogleURL InspectionUna URL por llamada; 2,000 llamadas al día por propiedad
Tus sitemaps y sus erroresSitemapsLeerlos requiere acceso de solo lectura; enviarlos o borrarlos, acceso total
Las propiedades que puedes verSitesAgregar o quitar una propiedad requiere acceso total

Algunas funciones de Search Console no tienen API, así que ningún servidor MCP puede acceder a ellas:

  • Datos de la Visión general creada por IA y del Modo IA. Google habilitó el informe de rendimiento de IA generativa para todos los sitios el 31 de agosto de 2026, pero la referencia de la API no incluye ningún tipo de búsqueda ni aparición en búsquedas para ese informe.
  • Las opciones más recientes 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 está en el índice de Google. La documentación de la API lo dice así: “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 aparte y que algunos servidores usan, oficialmente solo es para páginas de ofertas de trabajo y de transmisiones en vivo.

Tres formas de conectar Search Console con Claude, Claude Code o Codex

OpciónConfiguraciónPor dónde pasan tus datosCosto
Servidor comunitario que ejecutas tú, como mcp-gscProyecto de Google Cloud, API, credenciales y una entrada en la configuraciónDe tu computadora a GoogleGratis
Servidor alojado, como mcpsearchconsole.comAcceder con Google y pegar la URL del servidor en tu app de IAPor los servidores del proveedorPlan gratuito y luego suscripción
Conector integrado en OrkasHacer clic en Conectar y acceder con GoogleDe tu computadora a GoogleConector 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 al 9 de noviembre de 2026. Su código trae 21 herramientas, entre ellas comparaciones entre períodos, inspección por lotes de hasta 10 URLs y, si lo permites, el envío de sitemaps. El precio a pagar es la configuración: tienes que crear tus propias credenciales de Google. Un usuario de r/TechSEO dijo que Google Cloud era “la única fricción”.
  • Los servidores alojados son la forma más rápida de usarlo en claude.ai o en ChatGPT desde el navegador. Son servidores remotos, así que se agregan por URL. El centro de ayuda de Claude dice que los conectores personalizados funcionan en todos los planes, pero “los usuarios del plan gratuito están limitados a un conector personalizado”. mcpsearchconsole.com ofrece un plan gratuito con 40 extracciones de datos al mes en tres propiedades y, después, €4.99 al mes más IVA. Tus datos de Search Console pasan por el proveedor, así que antes lee sus condiciones de privacidad.
  • Un conector integrado te evita la configuración de Google Cloud. En Orkas accedes con tu cuenta de Google y el conector se ejecuta en tu computadora. 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 creamos un proyecto de Google Cloud para esta guía, así que revisa el README antes de empezar.

  1. 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 buscas es automatizar, mejor crea una cuenta de servicio y agrega su correo electrónico en Search Console, en la sección Usuarios y permisos de Ajustes, con acceso total.
  2. Instala uv. La opción que recomienda el README ejecuta el servidor con uvx, que se encarga de Python por ti. Sin él, necesitas Python 3.11 o una versión posterior.
  3. Agrega el servidor a tu agente. En Claude Code:
    claude mcp add --env GSC_OAUTH_CLIENT_SECRETS_FILE=/path/to/client_secrets.json --transport stdio gsc -- uvx mcp-search-console
    En Codex:
    codex mcp add gsc --env GSC_OAUTH_CLIENT_SECRETS_FILE=/path/to/client_secrets.json -- uvx mcp-search-console
    Probamos los dos comandos con Claude Code 2.1.311 y Codex CLI 0.163.0. Para Claude Desktop o Cursor, el README trae una configuración JSON con la ruta completa a uvx, porque las apps que se abren desde el Dock o el menú Inicio podrían no encontrarlo de otra forma.
  4. Inicia sesión una vez. La primera vez que lo uses, se abre una ventana del navegador para que accedas con Google. Desde la versión 0.4.2, el servidor pide únicamente acceso de solo lectura, a menos que definas GSC_ALLOW_DESTRUCTIVE=true.

Hay un detalle que las guías de la comunidad no mencionan: si tu pantalla de consentimiento de OAuth está configurada como External y la dejas en Testing, la documentación de OAuth de Google indica que el token de actualización vence 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 la advertencia de “app no verificada”, que Google permite saltar en apps de uso personal con menos de 100 usuarios.

Conectar Search Console en Orkas

Orkas es una app 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.

  1. 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.
  2. Abre Conectores. Haz clic en Conectores en la barra lateral y busca Google Search Console. Puedes encontrarlo con el filtro Datos o con el cuadro de búsqueda.
  3. Haz clic en Conectar y accede con Google. Haz clic en Conectar, usa la cuenta de Google que tiene acceso a tu propiedad y autoriza el acceso de solo lectura. La tarjeta pasa a Conectados.
  4. Pide lo que necesitas. En un chat, escribe @ y elige el conector de Google Search Console, o simplemente describe la tarea. El agente primero lista tus propiedades y después consulta la que le indiques.
  • Es de solo lectura. Orkas solo le pide a Google el permiso webmasters.readonly. Las cuatro herramientas listan tus propiedades, consultan los datos de rendimiento, listan 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 directo a Google. El conector se ejecuta en tu computadora 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 app.
  • 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 apenas conectas Search Console. Si instalaste Claude Code, Codex, OpenCode, Hermes u OpenClaw y lo conectaste en Orkas, llega al conector a través del puente de herramientas de Orkas, sin tener que configurar MCP por su lado.
  • ¿Necesitas acceso de escritura? Usa Agregar servidor MCP en la página Conectores para agregar un servidor comunitario como comando local. Orkas también tiene un conector de Bing Webmaster Tools.

Una primera auditoría que puedes verificar

Una buena primera solicitud pide números que puedas comparar con Search Console en un minuto y obliga al agente a decir qué no cubren los datos. Reemplaza 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é porcentaje de ellos cubren las filas de consultas; 2) páginas entre las posiciones 5 y 15 con al menos 100 impresiones y un CTR menor al 2%, ordenadas por impresiones; 3) el estado de indexación de https://example.com/new-page/ y https://example.com/old-page/. Pon el rango de fechas en cada tabla y no estimes nada que los datos no muestren.

Corrimos esta solicitud con Claude Code en Orkas el 9 de noviembre de 2026, y las cuatro herramientas del conector funcionaron. No publicamos los números de Search Console de nuestro propio sitio, así que los resultados de abajo son un ejemplo sintético: cifras inventadas de una tienda ficticia en example.com, que muestran cómo se ve una respuesta cuidadosa y cómo verificar cada parte.

  • Totales por fecha (datos sintéticos): 3,480 clics y 151,200 impresiones. Estos son los números en los que puedes confiar para todo el sitio. Para verificar los tuyos, 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 por lo general significa que el agente sumó, 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 viene de consultas que Google anonimiza, que no tienen fila ni en el informe ni en la API. Un porcentaje así es normal: Ahrefs encontró que las consultas anonimizadas representaron 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 dice que ese es tu tráfico puede quedarse en la mitad del número 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 menor al 2%. La que tuvo más impresiones, /blog/linen-care/, sumó 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 hay que 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 vieja está indexada y la nueva todavía no. https://example.com/old-page/, publicada en septiembre, aparecía como “Submitted and indexed”, con último rastreo el 3 de octubre. https://example.com/new-page/, publicada dos días antes de la verificación, aparecía como “Discovered - currently not indexed”. Para verificarlo, pega la misma URL en la barra de inspección, arriba en Search Console.

Cinco errores comunes

  • Tomar las filas de consultas como 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 vas a obtener 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 “por lo general están disponibles después de 2-3 días”. La API devuelve datos finales a menos que le pidas 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 diagonal final, como https://example.com/. Deja que el agente liste primero tus propiedades y copia el nombre que te 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 rápido a ese límite. Pide resúmenes, un filtro o un rango de fechas más corto, y deja que el agente procese las filas en vez de pegarlas todas en el chat.

¿Qué opción te conviene?

Tu casoElige
Usas claude.ai o ChatGPT en el navegadorUn servidor alojado, agregado por URL
Quieres todas las herramientas, incluido el envío de sitemaps, y no te molesta Google CloudUn servidor comunitario como mcp-gsc
Quieres que Claude Code, Codex y un agente de SEO lean Search Console sin Google CloudEl conector integrado de Orkas
Tu sitio es demasiado grande para 25,000 filas por solicitudLa exportación masiva de datos de Search Console a BigQuery, fuera de MCP

Preguntas frecuentes

¿Google tiene un servidor MCP oficial para Search Console?

No, al 9 de noviembre de 2026 no lo tiene. Search Console no aparece 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.

¿Un MCP de Search Console es gratis?

La API de Search Console es gratuita, igual que 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 igual tiene su propio costo, como un plan de Claude o los créditos de Orkas.

¿Un servidor MCP puede enviar sitemaps o solicitar la indexación?

Puede enviar o borrar 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é los números del MCP no coinciden con Search Console?

Casi siempre porque el agente sumó filas de consultas, que dejan afuera las consultas anonimizadas, o mezcló 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í. Agrega un servidor comunitario con claude mcp add o codex mcp add, o agrega 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? da el panorama completo: un agente hace el trabajo de SEO con datos en vivo y una persona aprueba lo que se publica.

Claude SEO skill →

Search Console en el chat de tu agente Conecta Search Console una sola vez y deja que Claude Code, Codex o SeoGeoAgent lo consulten. Orkas es gratis en macOS y Windows. Las cuentas nuevas reciben 500 créditos para el modelo integrado de Orkas.
Descarga Orkas gratis