Wingate SEO MCP

Servidor MCP de código abierto y autoalojado para Google Search Console + Google Analytics 4, para ChatGPT y otros clientes MCP. Analiza tus propios datos de SEO sin pagar por otro panel de 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, la evidencia de sitemaps y de URL Inspection, comparaciones de períodos y diagnósticos SEO deterministas en un único servicio de solo lectura.

Editor: Wingnut Innovations
Versión: 0.5.1
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 la infraestructura que controlas.

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

• Inspecciona la actividad de eventos, la interacción de páginas de destino, las oportunidades de CTR, los cambios de posicionamiento, la caída y la canibalización.

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

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

Related MCP server: Google SEO MCP

Herramientas MCP de solo lectura

El servidor público expone exactamente 11 herramientas:

No hay herramientas de escritura de Search Console, Google Indexing, GA4 Admin, envío de sitemaps ni otras en el servidor público.

Diagnósticos de calidad de informes de GA4

Los resultados de GA4 incluyen diagnósticos de informes como evidencia sobre los datos devueltos. Google puede aplicar umbrales o muestreo, y las dimensiones de alta cardinalidad pueden agruparse en una fila (other). Las respuestas limitadas de las herramientas también informan cuando hay más filas disponibles, mientras que los detalles de cuota de propiedad son solo informativos. Estas advertencias no demuestran que el seguimiento sea correcto o completo, y Wingate SEO MCP no puede eludir el comportamiento de informes de Google.

ga4_overview puede agregar opcionalmente evidencia de adquisición de tráfico a nivel de sesión sin añadir otra herramienta MCP:

{
  "siteKey": "example-site",
  "days": 28,
  "includeAcquisition": true,
  "acquisitionLimit": 25
}

La vista general predeterminada no realiza ninguna solicitud de adquisición y devuelve acquisition: null. Cuando está habilitada, acquisition agrupa las filas por grupo de canal predeterminado de sesión y fuente/medio de sesión, utiliza el mismo rango de fechas y el ámbito googleOrganicOnly que la vista general, y se limita a 1-100 filas. Sus reportDiagnostics exponen advertencias de truncamiento, umbrales, muestreo y cuota; la atribución de adquisición de GA4 no es equivalente a la atribución de Search Console.

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/aitradesniper-blip/wingate-seo-mcp-public.git wingate-seo-mcp
cd wingate-seo-mcp
npm install

Usa .env.example como plantilla y establece 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 iniciado por npm start requiere credenciales explícitas de cuenta de servicio. Establece GOOGLE_SERVICE_ACCOUNT_FILE (preferido), GOOGLE_APPLICATION_CREDENTIALS o GOOGLE_SERVICE_ACCOUNT_JSON. No recurre a una identidad de metadatos/carga de trabajo de Google Cloud adjunta.

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 limitadas y luego 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 obtener un tutorial detallado.

Configuración de la API de Google

Habilita estas API en tu proyecto de Google Cloud:

• Google Search Console API

• Search Console URL Inspection API

• Google Analytics Data API

• Google Analytics Admin API

Concede al correo electrónico de la cuenta de servicio acceso a cada propiedad de Search Console y al menos acceso de Visor 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 Analytics Admin se usa solo para descubrir propiedades de GA4 y flujos web accesibles. El servidor MCP no modifica la configuración de GA4 Admin.

Mapeo de sitios

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

Los registros locales son ignorados por Git. Nunca confirmes asignaciones de propiedades reales si los lectores del repositorio no deben saber qué sitios operas.

Conectar un cliente MCP

Inicia el servidor y apunta un cliente MCP compatible con HTTP Streamable 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 de cliente MCP.

Preguntas de ejemplo

• “¿Qué páginas perdieron clics este mes?”

• “Encuentra consultas que se posicionan entre 4 y 20 con CTR débil.”

• “¿Qué páginas de destino 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 revelada. No envía análisis de uso a Wingnut Innovations ni a terceros.

Los datos salen de tu máquina o servidor solo 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 agregar un límite de autenticación y transporte revisado de forma independiente. No coloques credenciales, registros locales ni salidas de comandos en prompts o 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 electrónico de la cuenta de servicio acceso a la propiedad.

• No se encontró ninguna propiedad de GA4: concede al menos acceso de Visor y luego vuelve a ejecutar npm run doctor.

• Mapeo ambiguo: proporciona --ga4 explícitamente; el descubrimiento nunca elige silenciosamente una coincidencia débil.

• Sin fila de evento: GA4 no observó ninguna fila coincidente para ese alcance 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 de bucle local y la configuración de transporte de red local o asegurada 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 de Docker se pospone deliberadamente hasta que estén listas una imagen pequeña y revisable y una política de runtime sin root; la ruta de autoalojamiento 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 de SEO, puedes apoyar opcionalmente el desarrollo continuo. No hay ningún proveedor de financiación configurado en v0.5.0.

Licencia, procedencia e independencia

Wingate SEO MCP está licenciado bajo la Licencia MIT. Los mapeos seleccionados de cliente y métodos 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, respaldado ni patrocinado por Google u OpenAI. Google Search Console, Google Analytics, GA4, ChatGPT y OpenAI son marcas comerciales de sus respectivos propietarios.