io.github.JvnnDev/seo-webmaster-mcp

SEO Webmaster MCP

MCP local y de solo lectura para auditar SEO con Google Search Console, Bing Webmaster Tools y un rastreo acotado de la web. Incluye un plan de acción con evidencia y señales de preparación para funciones generativas de búsqueda. Requiere Node.js 22 o posterior.

Inicio rápido

No necesitas clonar ni compilar el repositorio. Configura cada proveedor que quieras usar:

npx -y seo-webmaster-mcp setup bing
npx -y seo-webmaster-mcp setup google --client /ruta/al/cliente-oauth.json
npx -y seo-webmaster-mcp status
npx -y seo-webmaster-mcp doctor

Bing: crea tu clave en Bing Webmaster Tools. El asistente la solicita sin mostrarla y comprueba que funciona.

Google: en Google Cloud Console habilita la Search Console API, configura la pantalla OAuth y descarga un cliente OAuth de tipo Desktop app. Si la aplicación está en modo *Testing*, agrega tu cuenta como usuario de prueba. Pasa el archivo JSON al comando setup google; el navegador solicitará acceso de solo lectura y completará la conexión mediante un callback local. Cada usuario crea su propio cliente OAuth; no compartas el JSON ni el token de renovación. Guía oficial de autorización.

La configuración se guarda fuera del repositorio, en el perfil del usuario. status muestra la ruta y el estado sin revelar secretos; doctor prueba el acceso real a ambos proveedores. Para desconectar: npx -y seo-webmaster-mcp disconnect google o disconnect bing. En macOS/Linux el archivo tiene permisos 0600; en Windows se guarda en AppData del usuario. Protege tu sesión de sistema porque el token de renovación se conserva localmente.

Conectar tu cliente MCP

npx -y seo-webmaster-mcp inicia el servidor por stdio. Ejecuta npx -y seo-webmaster-mcp config codex|claude|cursor para copiar la configuración correspondiente; no incluyas claves en ella.

Codex:

codex mcp add seo-webmaster -- npx -y seo-webmaster-mcp
codex mcp list

Claude Desktop: agrega lo siguiente a claude_desktop_config.json y reinicia la aplicación. Cursor: agrega el mismo objeto a tu mcp.json.

{
  "mcpServers": {
    "seo-webmaster": {
      "command": "npx",
      "args": ["-y", "seo-webmaster-mcp"]
    }
  }
}

Consulta la configuración MCP de Codex, la ayuda de Claude Desktop o la documentación MCP de Cursor si tu cliente requiere una ruta distinta. En Windows, si el cliente no encuentra npx, usa la ruta absoluta del ejecutable npx.cmd.

Auditoría avanzada

Pide a tu cliente MCP que llame seo_audit_advanced:

{
  "gscSiteUrl": "sc-domain:example.com",
  "bingSiteUrl": "https://example.com/",
  "baseUrl": "https://www.example.com/",
  "maxPages": 100
}

Se puede indicar solo una de las dos propiedades. Si omites las fechas, usa los últimos 90 días finalizados hasta tres días antes de la ejecución. El rastreo comienza en la portada, sigue los sitemaps y enlaces internos, respeta las exclusiones generales de robots.txt y se limita a URL públicas del mismo host (incluida la variante www). Cada petición tiene un límite de tiempo y el rastreo termina al llegar a maxPages (máximo 500). El informe incluye datos oficiales, problemas técnicos, oportunidades por consulta y página, señales GEO y acciones priorizadas con pasos de verificación. Una falla parcial conserva el resto del informe.

La herramienta seo_audit_site original sigue disponible. Las nuevas herramientas oficiales son gsc_query_advanced, gsc_sitemap_details, bing_feed_details, bing_page_queries y bing_query_pages. Las herramientas existentes no cambian de nombre.

Importar impresiones de funciones generativas de Google

Search Console permite exportar el informe de rendimiento generativo. Su vista no está disponible como recurso independiente en la API pública. Exporta una tabla CSV por páginas o fechas y ejecuta:

npx -y seo-webmaster-mcp geo-import reporte.csv sc-domain:example.com 2026-07-01 2026-09-24 page

Usa date en vez de page para una tabla por fechas. Se aceptan encabezados Page/Página, Date/Fecha e Impressions/Impresiones. El CSV debe contener una tabla con esas columnas y máximo 10 000 filas. La importación queda en el perfil local, separada por propiedad. geo_report_summary y seo_audit_advanced muestran los datos importados por separado. Son impresiones de funciones generativas de Google, no mediciones de citas en ChatGPT, Claude u otros sistemas.

Desarrollar

npm install
npm test
npm pack --dry-run

El paquete contiene solo dist, README y licencia. No publiques credenciales ni el cliente OAuth. Los datos oficiales pueden estar incompletos o retrasados; el MCP distingue ausencia de datos de cero tráfico y evita presentar heurísticas como errores confirmados.

English quick start

Install Node.js 22+, then connect one or both providers:

npx -y seo-webmaster-mcp setup bing
npx -y seo-webmaster-mcp setup google --client /path/to/desktop-oauth-client.json
codex mcp add seo-webmaster -- npx -y seo-webmaster-mcp

For Claude Desktop or Cursor, use the mcpServers JSON above. Run npx -y seo-webmaster-mcp config claude or config cursor to print it. Call seo_audit_advanced with a verified Search Console or Bing property and baseUrl. The audit is read only; its action plan identifies confirmed issues and inferred opportunities separately. Google generative search impressions can be imported from a Search Console CSV export with geo-import.