MCP de GSC para Codex

Google Search Console en OpenAI Codex

Codex ya lee tu código. Dale también tus datos de búsqueda. El servidor MCP de GSC Wizard es un endpoint alojado de Model Context Protocol que entrega a Codex tus datos de Search Console, Bing Webmaster y GA4, de modo que el agente que edita tus plantillas también pueda ver qué páginas pierden clics, para qué consultas posiciona una página y si una URL está indexada.

Un solo comando, sin servidor local ni proyecto de Google Cloud. Funciona en la CLI de Codex, en la extensión del IDE y en la app de escritorio, que leen todas el mismo ~/.codex/config.toml.

codex mcp add gsc-wizard --url https://mcp.gscwizard.com/mcp
codex mcp login gsc-wizard
Endpoint
https://mcp.gscwizard.com/mcp
Transporte
Streamable HTTP
Autenticación
OAuth (codex mcp login) or Bearer key
Herramientas
112 · GSC, Bing, GA4

Prueba gratuita, sin tarjeta de crédito. El acceso al MCP está incluido en todos los planes.

01

Por qué Search Console tiene su sitio en Codex

La mayoría de las correcciones SEO acaban siendo un cambio de código: una plantilla de title, una etiqueta canonical, un mapa de redirecciones, un generador de sitemaps, un bloque de enlaces internos. En un asistente de chat analizas los datos y luego copias la conclusión a tu editor. En Codex, el análisis y el cambio ocurren en la misma sesión y sobre el mismo repositorio.

Los datos junto al diff

Codex puede consultar las consultas por las que una página recibe clics antes de reescribir su title, en lugar de adivinar palabras clave.

El análisis se ejecuta en el servidor

El decaimiento, la canibalización, las curvas de CTR y la puntuación de oportunidades los calcula el servidor. Codex recibe conclusiones y las filas que las respaldan, no una exportación en bruto sobre la que hacer cálculos.

Más historial que la API

La mayoría de las lecturas salen del almacén de datos de GSC Wizard con tus datos guardados, que va más allá de la ventana de 16 meses de Google y evita el muestreo de filas de la API.

02

Configuración en tres pasos

  1. 1

    Conecta tus propiedades

    Crea una cuenta de GSC Wizard, inicia sesión con Google y elige las propiedades de Search Console que Codex debe ver. Codex solo puede leer las propiedades conectadas aquí.

  2. 2

    Añade el servidor a Codex

    Desde cualquier terminal:

    codex mcp add gsc-wizard --url https://mcp.gscwizard.com/mcp

    Esto escribe una tabla [mcp_servers.gsc-wizard] en ~/.codex/config.toml. También puedes escribir el bloque a mano.

  3. 3

    Inicia sesión y comprueba

    Ejecuta el inicio de sesión con OAuth, que abre el navegador en la pantalla de consentimiento de GSC Wizard. Después inicia Codex y escribe /mcp para confirmar que aparecen las herramientas.

    codex mcp login gsc-wizard
    codex
    > /mcp
    > List my Search Console sites and show clicks for the last 28 days.
03

El bloque de config.toml

Si guardas la configuración de Codex en un repositorio de dotfiles o quieres limitar a qué puede acceder el agente, edita ~/.codex/config.toml directamente.

Mínima (OAuth)

[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"

Clave de API desde una variable de entorno

bearer_token_env_var indica el nombre de la variable; Codex envía su valor como Authorization: Bearer. La clave en sí nunca se guarda en el archivo de configuración.

[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"
bearer_token_env_var = "GSCW_API_KEY"
export GSCW_API_KEY="gscw_live_..."

Acotada: solo las herramientas que necesita una tarea

Cada definición de herramienta consume contexto en cada turno. Para un agente de programación que solo necesita comprobar el rendimiento y la indexación, una lista de permitidas mantiene la sesión ligera y reduce lo que podría alcanzar una inyección de prompt en el contenido descargado.

[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"
bearer_token_env_var = "GSCW_API_KEY"
enabled_tools = [
  "list_sites",
  "get_site_summary",
  "query_top_pages",
  "get_page_performance",
  "get_query_performance",
  "find_decaying_content",
  "analyze_cannibalization",
  "inspect_url",
  "list_sitemaps"
]
tool_timeout_sec = 120

Las herramientas de análisis sobre rangos de fechas largos pueden tardar más que una simple consulta, así que un tool_timeout_sec generoso evita que Codex abandone una llamada que el servidor aún está respondiendo. Pon enabled = false para desactivar el servidor sin borrar el bloque.

04

OAuth o clave de API

OAuth con codex mcp login

Lo mejor para trabajar de forma interactiva en tu propia máquina. Codex descubre el servidor de autorización, se registra y abre un inicio de sesión en el navegador. Sin claves que copiar, guardar ni rotar. La concesión cubre las herramientas de lectura y de escritura, y puedes revocarla desde tu cuenta de GSC Wizard.

Clave gscw_live_ con scope

Lo mejor para codex exec, pipelines de CI, tareas en la nube y todo lo que no tenga navegador. Crea una en Cuenta → Claves de API en GSC Wizard; se muestra una sola vez y se almacena únicamente como hash.

Usa una clave con scope de lectura para los agentes. Una clave de lectura no puede llamar a ninguna de las 32 herramientas de mutación, como submit_sitemap, submit_indexnow_urls o add_site. La comprobación se ejecuta en el servidor antes de que se ejecute la herramienta, así que no se puede convencer a un agente para que se la salte. Las credenciales de Google no llegan nunca a Codex: las guarda el servidor y Codex solo tiene una credencial de GSC Wizard.

05

Qué preguntarle a Codex

Los prompts útiles combinan los datos de búsqueda con el repositorio que Codex tiene abierto.

Corrige los title con datos reales de consultas

"Encuentra las páginas de example.com que están en las posiciones 4 a 15 con un CTR por debajo de la curva. Para cada una, localiza en este repositorio la plantilla o el archivo de contenido que define su title y propón un title que incluya su consulta principal."

Revisa una migración antes de publicarla

"Compara las URLs que esta rama elimina o renombra con las 500 páginas con más clics de los últimos 90 días. Lista todas las URLs con tráfico que no tengan redirección en redirects.json."

Encuentra contenido que actualizar

"Haz un análisis de decaimiento de la sección /blog/, abre después en content/ los cinco artículos que más han decaído y redacta un plan de actualización para cada uno, a partir de las consultas que han perdido."

Resuelve la canibalización en el código

"Encuentra consultas en las que compitan dos o más de nuestras páginas. Para cada par, revisa los enlaces internos y las canonicals en las plantillas y sugiere qué página debería ganar."

Verifica la indexación tras un despliegue

"Inspecciona las diez URLs añadidas en el último commit y dime cuáles aún no están indexadas, con el motivo que da Google."

Díselo a Codex una vez, en AGENTS.md

Codex lee AGENTS.md al empezar una sesión. Unas pocas líneas ahí te ahorran repetir la propiedad y las normas de la casa en cada prompt.

## Search data
- Search Console property: sc-domain:example.com (use the gsc-wizard MCP tools).
- Before changing a title, meta description or URL, look up the page's
  current queries with get_page_performance and keep its top query in the title.
- Treat the last 3 days as incomplete; report settledThrough with any numbers.
- Never call submit_sitemap or submit_indexnow_urls without asking first.
06

Herramientas que Codex puede usar

Hay 128 herramientas disponibles para cualquier cuenta. Cada una anuncia anotaciones MCP como readOnlyHint y destructiveHint, de modo que Codex puede distinguir las lecturas de las escrituras al decidir si pide aprobación.

Grupo Herramientas representativas Scope
Analítica de búsquedaquery_search_analytics, query_top_queries, query_top_pages, get_page_performancelectura
Análisisfind_decaying_content, analyze_cannibalization, analyze_ctr_curve, score_opportunitieslectura
Deteccióndetect_anomalies, detect_change_points, get_ranking_changes, forecast_trafficlectura
Indexación y on-pageinspect_url, bulk_inspect_urls, list_sitemaps, audit_onpage_seolectura
Otras fuentesBing Webmaster, GA4 (incluido el tráfico de referencia de LLM), Core Web Vitalslectura
Mutacionessubmit_sitemap, submit_indexnow_urls, create_annotation, create_topic_clusterescritura

Las fechas son opcionales en todas las herramientas: si se omite el rango, se toman por defecto los últimos 28 días completos, así que Codex nunca tiene que conocer la fecha de hoy. Las herramientas con límite de filas devuelven un bloque de paginación que indica si existen más filas, de modo que el agente no pueda confundir una lista recortada con una completa. El catálogo completo con los argumentos está en mcp.gscwizard.com y los detalles del protocolo, en la referencia del servidor.

07

Resolución de problemas

/mcp no muestra gsc-wizard

Ejecuta codex mcp list para confirmar que la entrada existe y comprueba que el bloque de ~/.codex/config.toml sea una entrada url y no una entrada command. Reinicia Codex después de editar el archivo; lee la configuración al arrancar.

Todas las llamadas devuelven 401 unauthorized

Con clave: la variable indicada en bearer_token_env_var debe estar exportada en la shell desde la que se lanzó Codex y contener la clave gscw_live_ completa. Con OAuth: vuelve a ejecutar codex mcp login gsc-wizard. En ambos casos, la cuenta necesita una prueba o suscripción activa y al menos una propiedad de Search Console conectada.

Se rechaza una herramienta de escritura

Es el scope de lectura haciendo su trabajo. Si de verdad quieres que Codex envíe sitemaps o URLs a IndexNow, crea una clave con scope de escritura o usa el inicio de sesión con OAuth, y no uses esa credencial en ejecuciones desatendidas.

Las llamadas agotan el tiempo en propiedades grandes

Sube tool_timeout_sec para el servidor y acota la petición: un filtro por ruta o un rango de fechas más corto responde más rápido que una consulta de todo el sitio durante dieciséis meses.

Las cifras difieren de la interfaz de Search Console

Revisa settledThrough y dataSource en la respuesta. El rango por defecto termina en el último día completo, mientras que la interfaz incluye los últimos días parciales.

08

Preguntas frecuentes

¿Codex admite servidores MCP remotos como GSC Wizard?

Sí. Codex admite servidores MCP Streamable HTTP configurados con una url en ~/.codex/config.toml o añadidos con codex mcp add --url. El servidor de GSC Wizard está en https://mcp.gscwizard.com/mcp, así que no hay nada que instalar ni ejecutar en local.

¿Debo usar OAuth o una clave de API con Codex?

Para uso interactivo, codex mcp login ejecuta el flujo de OAuth en tu navegador y no requiere gestionar claves. Para codex exec, tareas de CI y otras ejecuciones desatendidas, usa una clave de API gscw_live_ con scope de lectura guardada en una variable de entorno y referenciada con bearer_token_env_var, de modo que el secreto nunca acabe en config.toml.

¿La CLI, la extensión del IDE y la app de Codex comparten la configuración del MCP?

Sí. Leen el mismo ~/.codex/config.toml, así que añadir gsc-wizard una vez lo deja disponible en el terminal, en la extensión del IDE y en la app de escritorio.

¿Puede Codex cambiar algo en mi Search Console?

Solo con una credencial con scope de escritura. Una clave de API con scope de lectura no puede llamar a ninguna de las 32 herramientas de mutación (como submit_sitemap o submit_indexnow_urls); la comprobación se ejecuta en el servidor antes de que se ejecute la herramienta. También puedes acotar la lista de herramientas en el cliente con enabled_tools en config.toml.

¿Cuántas herramientas recibe Codex?

Hay 128 herramientas disponibles para cualquier cuenta, que cubren el rendimiento de Search Console, el análisis, la indexación, Bing Webmaster, Yandex Webmaster, GA4 y Google Merchant Center. Enviarlas todas consume contexto en cada turno, así que la mayoría de las configuraciones de Codex listan en enabled_tools solo las herramientas que necesita una tarea.

¿Tiene algún coste?

El acceso al MCP está incluido en los planes de GSC Wizard y en la prueba gratuita, que no requiere tarjeta de crédito. El uso de Codex lo factura OpenAI como de costumbre. Consulta los precios.

Relacionado

Dale a Codex tus datos de búsqueda

Conecta una propiedad, ejecuta un comando y deja que el agente que edita tu sitio vea cómo rinde en las búsquedas.

Consejos de Search Console en tu bandeja de entrada

Flujos de trabajo prácticos con GSC y GA4, novedades del producto y experimentos SEO. Sin spam, date de baja cuando quieras.