Wingate SEO MCP

Servidor MCP de código abierto y autohospedado para Google Search Console + Google Analytics 4, pensado para ChatGPT y otros clientes MCP. Analiza tus propios datos SEO sin pagar por otro panel de control SEO.

Wingate SEO MCP conecta un cliente MCP con las propiedades de Google que ya controlas. Combina el rendimiento de Search Console, la interacción de GA4, las pruebas de sitemaps e inspección de URLs, las comparaciones entre periodos y los diagnósticos SEO deterministas en un único servicio de solo lectura.

Editor: Wingnut Innovations
Versión: 0.5.0
Licencia: MIT

¿Por qué usarlo?

• Haz preguntas sobre tus propios datos de GSC y GA4 en lenguaje natural.

• Mantén las credenciales y las asignaciones de propiedades en una infraestructura que controlas.

• Sustituye el trabajo recurrente de los paneles por evidencia reproducible y cálculos.

• Inspecciona la actividad de eventos, la interacción de las páginas de aterrizaje, las oportunidades de CTR, los cambios de posiciones, el decaimiento y la canibalización.

• Empieza con un límite de seguridad deliberadamente pequeño y de solo lectura.

Tú aportas tus propias credenciales de Google y concedes a esa identidad acceso únicamente a las propiedades que quieres analizar. Wingate SEO MCP no incluye cuentas alojadas, acceso a Google incluido, barreras de pago, telemetría, publicidad ni suscripciones.

Herramientas MCP de solo lectura

El servidor público expone exactamente 11 herramientas:

En el candidato público no hay herramientas de escritura de Search Console, Indexación de Google, administración de GA4, envío de sitemaps ni de ningún otro tipo.

Requisitos

• Node.js 20, 22 o 24

• npm

• Un proyecto de Google Cloud con las API necesarias habilitadas

• Una credencial JSON de cuenta de servicio de Google, proporcionada por el usuario, con acceso a tus propiedades de GSC y GA4

• Un cliente MCP que pueda alcanzar el endpoint HTTP Streamable local

Inicio rápido

git clone https://github.com/wingnutinnovations-tech/wingate-seo-mcp.git
cd wingate-seo-mcp
npm install

Usa .env.example como plantilla y define las mismas variables de entorno en el shell que inicia los comandos. El proyecto no carga .env automáticamente. Mantén el JSON de la cuenta de servicio descargado fuera del repositorio.

GOOGLE_SERVICE_ACCOUNT_FILE=/absolute/path/to/google-service-account.json
WINGATE_SITES_FILE=./config/sites.local.json

El runtime MCP v0.5.0 iniciado con npm start requiere credenciales de cuenta de servicio explícitas. Define GOOGLE_SERVICE_ACCOUNT_FILE (recomendado), GOOGLE_APPLICATION_CREDENTIALS o GOOGLE_SERVICE_ACCOUNT_JSON. No recurre a una identidad de metadatos o carga de trabajo adjunta de Google Cloud.

Valida las credenciales y descubre las propiedades accesibles:

npm run doctor
npm run discover:google

Genera un registro de sitios local ignorado usando las propiedades devueltas por el descubrimiento:

npm run setup -- --output config/sites.local.json \
  --gsc sc-domain:example.com \
  --ga4 123456789 \
  --origin https://example.com \
  --key example-site \
  --name "Example Site"

Ejecuta lecturas en vivo acotadas y, a continuación, inicia el servidor:

npm run live:smoke -- --site example-site --inspect-origin
npm start

Los endpoints predeterminados son:

http://127.0.0.1:3000/healthz
http://127.0.0.1:3000/mcp

Consulta Configuración de Google y Incorporación en vivo para ver un recorrido detallado.

Configuración de la API de Google

Habilita estas API en tu proyecto de Google Cloud:

• API de Google Search Console

• API de inspección de URLs de Search Console

• API de datos de Google Analytics

• API de administración de Google Analytics

Concede al correo de la cuenta de servicio acceso a cada propiedad de Search Console y al menos acceso de visor (Viewer) a cada propiedad de GA4. El runtime solicita únicamente:

• https://www.googleapis.com/auth/webmasters.readonly

• https://www.googleapis.com/auth/analytics.readonly

La API de administración de Analytics se usa solo para descubrir propiedades GA4 y flujos web accesibles. El servidor MCP no modifica la configuración de administración de GA4.

Asignación de sitios

Cada entrada del registro local asigna un siteKey estable a una propiedad de Search Console, una propiedad GA4 opcional y el origen del sitio. Copia config/sites.example.json para ver la estructura, o deja que npm run setup genere y valide config/sites.local.json.

Los registros locales se ignoran en Git. Nunca confirmes asignaciones de propiedades reales si los lectores del repositorio no deben saber qué sitios operas.

Conecta un cliente MCP

Inicia el servidor y apunta un cliente MCP compatible con Streamable HTTP al endpoint local /mcp. Usa una conexión local compatible con el cliente o un límite de transporte revisado de forma independiente. Este repositorio no incluye un túnel de Internet ni una capa de autenticación.

Antes de enviar datos, inspecciona el descubrimiento de herramientas y confirma que hay exactamente 11 herramientas y que todas están marcadas como de solo lectura. Consulta Conexión del cliente MCP.

Ejemplos de preguntas

• «¿Qué páginas perdieron clics este mes?»

• «Busca consultas en las posiciones 4–20 con CTR débil.»

• «¿Qué páginas de aterrizaje orgánicas tienen la mejor interacción?»

• «¿Se disparó mi evento de cliente potencial?»

• «Compara los últimos 28 días con los 28 días anteriores.»

Privacidad y seguridad

Wingate SEO MCP no tiene telemetría no declarada. No envía análisis de uso a Wingnut Innovations ni a terceros.

Los datos salen de tu máquina o servidor únicamente cuando:

• el conector llama a las API de Google usando las credenciales y el acceso a propiedades que configuraste; o

• tu cliente MCP configurado envía solicitudes a este servidor y recibe resultados de él.

El servidor se vincula a 127.0.0.1 de forma predeterminada. No lo expongas directamente a Internet público sin añadir un límite de autenticación y transporte revisado de forma independiente. No coloques credenciales, registros locales ni salidas de comandos en prompts ni en el control de versiones. Consulta SECURITY.md.

Solución de problemas

• Archivo de credenciales ilegible: usa una ruta absoluta y mantén el JSON fuera del repositorio.

• 403 de Google: habilita la API correspondiente y concede al correo de la cuenta de servicio acceso a la propiedad.

• No se encontró ninguna propiedad de GA4: concede al menos acceso de visor (Viewer) y vuelve a ejecutar npm run doctor.

• Asignación ambigua: proporciona --ga4 explícitamente; el descubrimiento nunca elige una coincidencia débil en silencio.

• Sin fila de evento: GA4 no observó ninguna fila coincidente para ese ámbito de fecha/filtro; la ausencia por sí sola no diagnostica la instrumentación.

• El cliente MCP no puede conectarse: confirma npm start, /healthz, el enlace a loopback y la configuración de red local o de transporte asegurado por separado del cliente.

Desarrollo y validación

npm run ci

Esto ejecuta comprobaciones de sintaxis, comprobaciones de TypeScript, pruebas unitarias/de integración, una compilación de producción y el descubrimiento de MCP. CI se dirige a Node.js 20, 22 y 24.

El empaquetado con Docker se pospone deliberadamente hasta que estén listos una imagen pequeña y revisable y una política de runtime no root; la ruta de autohospedaje con Node/npm es la línea base de v0.5.0.

Hoja de ruta y soporte

Consulta la hoja de ruta. Wingate SEO MCP es gratuito y de código abierto. Si te ahorra tiempo o una suscripción a una herramienta SEO, puedes apoyar opcionalmente el desarrollo continuado. No hay ningún proveedor de financiación configurado en v0.5.0.

Licencia, procedencia e independencia

Wingate SEO MCP se distribuye bajo la Licencia MIT. Determinados mapeos de métodos y clientes de Google se adaptaron y reescribieron sustancialmente a partir del upstream con licencia MIT fijado documentado en UPSTREAM.md, UPSTREAM_IMPORT_MANIFEST.json y THIRD_PARTY_NOTICES.md.

Wingate SEO MCP es un proyecto independiente publicado por Wingnut Innovations. No está afiliado a Google u OpenAI ni cuenta con su respaldo o patrocinio. Google Search Console, Google Analytics, GA4, ChatGPT y OpenAI son marcas comerciales de sus respectivos propietarios.