SEO Webmaster MCP server

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 claudedesktopconfig.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 seoauditadvanced:

{
  "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.

Shortened. The full README is on GitHub.