Hay seis formas prácticas de darle a un agente de IA acceso a los datos de Google Search Console: un conector OAuth alojado, un servidor MCP de la comunidad, la API de Search Console directamente, una exportación masiva a BigQuery, un puente con hojas de cálculo o la configuración con IA que ya trae Search Console, sin agente de por medio. Van desde dos minutos hasta casi un día de trabajo, y la buena para ti depende de si necesitas un histórico de más de 16 meses.
Ese último punto es el que marca el camino, así que empecemos por ahí. La API de Search Analytics devuelve como máximo 25.000 filas por solicitud y guarda 16 meses de histórico. Pasados esos 16 meses, los datos desaparecen: no se ocultan, se borran. Si necesitas más histórico, solo uno de los métodos de esta lista te lo da, y tienes que activarlo antes de necesitarlo.
Método 1: un conector OAuth alojado
Configuración: de 2 a 5 minutos. Sin código.
Autorizas un producto de agentes SEO con tu cuenta de Google, eliges la propiedad y la conexión queda guardada en el servidor para reutilizarla en cada consulta. Es lo que debería usar la mayoría de los profesionales del marketing, y no por pereza: es que los fallos típicos ya vienen resueltos. Un conector bien hecho detecta que falta la conexión y te la pide en lugar de adivinar, sabe qué propiedad usar cuando tienes varias y pagina más allá del límite de 25.000 filas sin que tengas que pensar en ello.
En nuestra propia implementación, la herramienta de Search Console está marcada como de solo lectura, comprueba en la primera llamada si hay una conexión activa y, si no la hay, devuelve un aviso interactivo para conectarla con un enlace directo a la pantalla de integraciones. Cuando vuelves, la conversación sigue donde la dejaste.
La contrapartida: te quedas con el catálogo de herramientas que haya creado el proveedor. Si quieres una consulta con una forma que no implementaron, no la vas a tener.
Método 2: un servidor MCP para Search Console
Configuración: de 15 a 45 minutos. Hace falta soltura técnica.
El Model Context Protocol es un estándar abierto cliente/servidor para conectar asistentes de IA con sistemas externos, así que cualquier cliente compatible con MCP (Claude Desktop, Claude Code, Cursor y otros) puede llamar directamente a un servidor de Search Console.
Ojo con un detalle importante: a diferencia de GA4, para el que Google publica su propio servidor MCP, no existe un servidor MCP oficial de Google para Search Console. Lo que hay es un buen puñado de implementaciones de la comunidad, como mcp-server-gsc, que obtiene datos de rendimiento de búsqueda hasta el límite de 25.000 filas, admite filtros con expresiones regulares y es de solo lectura.
La configuración es un bloque JSON en tu cliente MCP que apunta al servidor con tus credenciales:
{
"mcpServers": {
"search-console": {
"command": "npx",
"args": ["-y", "mcp-server-gsc"],
"env": { "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json" }
}
}
}La contrapartida: estás confiando a un paquete de la comunidad las credenciales de tus datos de búsqueda. Lee el código fuente, usa permisos de solo lectura siempre que puedas y fija la versión. Comprueba también que la versión del protocolo que implementa el servidor coincide con la que espera tu cliente.
Método 3: la API de Search Console con una cuenta de servicio
Configuración: de 1 a 3 horas. Vas a escribir código.
Es la opción con más control y también la que más trabajo da. Los pasos:
- Crea un proyecto de Google Cloud o reutiliza uno que ya tengas.
- Activa en él la API de Search Console.
- Crea una cuenta de servicio y descarga la clave JSON.
- Añade el correo de la cuenta de servicio como usuario en la propia propiedad de Search Console, con permiso restringido (solo lectura).
- Autentica a tu agente con la clave y llama a
searchanalytics.query.
El paso 4 es el que todo el mundo olvida. Crear una credencial en Cloud no le da acceso a ninguna propiedad: son dos sistemas de permisos distintos, y si te saltas el segundo obtienes un 403 genérico que parece un problema de activación de la API cuando en realidad es un problema de acceso a la propiedad. Cuenta con perder veinte minutos con esto al menos una vez.
Un cuerpo de consulta mínimo, con paginación, tiene este aspecto:
{
"startDate": "2026-04-01",
"endDate": "2026-06-30",
"dimensions": ["query", "page"],
"rowLimit": 25000,
"startRow": 0
}Suma 25.000 a startRow en cada página y para cuando una respuesta devuelva menos filas de las que pediste. Todo lo demás (gestión de cuotas, reintentos, renovación de tokens) corre ahora de tu cuenta.
La contrapartida: flexibilidad total, pero la gestión de cuotas, la paginación, los reintentos y la renovación de tokens pasan a ser cosa tuya. Elige esta vía cuando el agente necesite una forma de consulta que ningún conector ofrece o cuando los datos tengan que quedarse dentro de tu propia infraestructura.
Método 4: exportación masiva a BigQuery
Configuración: alrededor de una hora, más un máximo de 48 horas hasta que llega la primera exportación.
Es el único método que resuelve el problema de los 16 meses, y conviene configurarlo hoy aunque todavía no lo necesites, porque acumula histórico de aquí en adelante, no hacia atrás.
Según la documentación de Google sobre la exportación masiva de datos, los pasos son:
- Crea o elige un proyecto de Google Cloud con la facturación activada. No es opcional.
- Activa en él la API de BigQuery y la API de BigQuery Storage.
- Concede a la cuenta de servicio de Search Console dos roles en el proyecto: BigQuery Job User y BigQuery Data Editor.
- En Search Console, abre Ajustes y luego Exportación masiva de datos, e indica el ID del proyecto de Cloud y la ubicación del conjunto de datos.
- Espera. La primera exportación llega en un plazo de 48 horas y, a partir de ahí, las exportaciones se hacen a diario.
Dos detalles que conviene saber antes de lanzarte. Las consultas anonimizadas quedan fuera de la exportación por motivos de privacidad, así que los totales de BigQuery no cuadrarán exactamente con los de la interfaz de Search Console. Es lo esperado, no un fallo, pero un agente que compare ambas fuentes te avisará de una discrepancia que no existe si no se lo explicas. Además, la ubicación del conjunto de datos no se puede cambiar después sin empezar de cero, así que elígela con cabeza.
Con los datos ya en BigQuery, tu agente consulta en SQL en lugar de usar la API de Search Console, lo que elimina de un plumazo el límite de filas y la ventana de retención. Los costes caben en el nivel gratuito de BigQuery para sitios pequeños y se vuelven reales en los grandes, así que pídele al agente que filtre por la columna de fecha de partición en lugar de recorrer la tabla entera: un agente que lance un SELECT * sin límites contra tres años de una propiedad grande te dejará una factura para el recuerdo.
La contrapartida: cuesta dinero, es la opción con más infraestructura de todas y el primer día no te da nada. Pero también es la única vía para hacer análisis de varios años.
Método 5: un puente con hojas de cálculo
Configuración: de 10 a 20 minutos. Sin código.
Exporta datos de Search Console a Google Sheets de forma programada con un complemento o con Apps Script y luego apunta a esa hoja un agente que tenga acceso a Sheets. Es la opción práctica cuando tu agente ya lee hojas de cálculo y quieres que tenga los datos delante esta misma tarde.
La contrapartida: los datos solo están tan frescos como la última exportación, todo viene prefiltrado por quien configuró la hoja y el agente no puede lanzar una consulta de seguimiento que nadie había previsto, que es justo para lo que querías un agente. Tómalo como un parche temporal.
Método 6: sin ninguna conexión
Configuración: ninguna.
Search Console ya trae IA integrada. La configuración con IA de Google te permite describir en lenguaje natural el análisis que quieres y lo convierte en filtros, comparaciones y selección de métricas del informe. Algo como «Compara el tráfico de mis páginas que contienen /blog este trimestre con el mismo trimestre del año pasado» se configura solo.
Eso sí, conoce sus límites, que Google deja bien claros: solo funciona en los informes de rendimiento de los resultados de búsqueda, no en Discover ni en Noticias; configura filtros, comparaciones y métricas, pero no puede ordenar tablas ni exportar datos; y Google advierte de que la IA puede malinterpretar una petición, así que revisa los filtros aplicados antes de fiarte del análisis. Además, solo configura: no razona cruzando GA4 y Search Console ni investiga la causa de nada.
Por otro lado, Search Console ahora incluye informes de rendimiento de IA generativa para el tráfico que llega desde las superficies de IA de Google. Si tu pregunta va de visibilidad en esas superficies de IA, esta es la fuente de referencia, y ninguna estimación de terceros la sustituye.
¿Qué método te conviene?
| Método | Configuración | Supera los 16 meses | Ideal para |
|---|---|---|---|
| Conector alojado | 2-5 min | No | Profesionales del marketing que quieren respuestas hoy |
| Servidor MCP | 15-45 min | No | Desarrolladores que ya usan un cliente MCP |
| API directa | 1-3 h | No | Consultas a medida, datos dentro de casa |
| Exportación a BigQuery | 1 h + 48 h | Sí | Análisis de varios años, sitios grandes |
| Puente con hojas de cálculo | 10-20 min | No | Solución temporal |
| Configuración con IA integrada | Ninguna | No | Montar informes más rápido, no investigar |
La combinación con la que acaban la mayoría de los equipos es un conector alojado para las preguntas del día a día y una exportación a BigQuery funcionando en segundo plano, para que dentro de un año tengan un histórico que nadie más tiene. Las dos opciones no compiten entre sí.
¿Es seguro darle a un agente acceso a Search Console?
Razonablemente sí, con tres condiciones. Concede solo lectura. Los permisos de Search Console incluyen la posibilidad de enviar sitemaps y solicitar retiradas de URLs, y un agente no necesita nada de eso. Usa mejor una cuenta de servicio con permisos acotados que una autorización OAuth personal, para que revocar el acceso no dependa de la cuenta de un empleado concreto. Y mantén las herramientas de escritura separadas de las que descargan contenido web: un agente que lee la página de un competidor ha metido texto escrito por terceros en la misma ventana de contexto que tus instrucciones, y si esa página lleva comandos inyectados, un agente ingenuo puede ejecutarlos. Nuestro entorno de ejecución aísla el contenido descargado como no fiable, marca ese turno como contaminado y rechaza cualquier herramienta de escritura durante el resto del turno salvo que una persona lo apruebe. Las consultas a Search Console están marcadas como de lectura, así que son seguras en cualquier caso.
Errores de configuración habituales y qué significan de verdad
| Síntoma | Causa habitual | Solución |
|---|---|---|
| Error 403 en todas las consultas aunque la API está activada | Nunca se añadió la cuenta de servicio como usuario de la propiedad | Añade su correo en los ajustes de la propiedad en Search Console, con permiso restringido |
| Resultado vacío, sin error | La URL de la propiedad no coincide: propiedad de dominio frente a propiedad de prefijo de URL, o falta la barra final | Copia la cadena de la propiedad tal cual la muestra Search Console |
| El agente da totales sospechosamente redondos | Resultado truncado en el límite de 25.000 filas y tratado como completo | Pagina con startRow u obliga al agente a avisar del truncamiento |
| Las cifras no coinciden con la interfaz de Search Console | Consultas anonimizadas excluidas de la exportación a BigQuery, o un límite de fechas distinto | Es lo esperado en BigQuery; si no, revisa la zona horaria y usa fechas absolutas |
| Exportación masiva configurada, pero no aparece ningún conjunto de datos | Aún no han pasado las 48 horas, o la facturación no está activada en el proyecto | Espera y luego comprueba la facturación y los dos roles de IAM |
| El servidor MCP arranca pero no expone ninguna herramienta | Ruta de credenciales incorrecta o versión del protocolo incompatible con el cliente | Comprueba que la ruta del env se resuelve y qué versión de la especificación admite el servidor |
Dos cosas que tienes que hacer bien elijas el método que elijas
Gestiona la paginación con honestidad. Un agente que pide 25.000 filas, recibe exactamente 25.000 y te da un total te está dando un resultado truncado. Pídele que pagine o que diga claramente que el resultado ha tocado el límite.
Usa fechas absolutas. Expresiones relativas como «el mes pasado» se calculan según la zona horaria de la propiedad y el momento en que se lanzó la consulta. Es la causa más habitual de un análisis de Search Console seguro de sí mismo, coherente y equivocado.
Una vez tengas la conexión, en qué puede encontrar de verdad un agente en los datos de Search Console repasamos los análisis que merece la pena hacer, y Autopilot implementa la vía del conector alojado que describimos en el método 1.
Get a free AI ranking consultation
Want your brand to show up when ChatGPT, Gemini and Perplexity answer questions in your market? Tell us about your site and our team will send a personalized strategy.
