searchconsole-mcp

Servidor MCP que automatiza Google Search Console para tus proyectos: análisis de búsqueda, gestión de sitemaps, propiedades del sitio e inspección de URL.

Herramientas

Related MCP server: Google Search Console + GA4 MCP Server

Configuración única de Google

1. En Google Cloud Console crea un proyecto.

2. Habilita la API de Google Search Console (APIs y servicios > Biblioteca).

3. Crea una cuenta de servicio (IAM y administración > Cuentas de servicio) y descarga una clave JSON.

4. Para cada propiedad de Search Console: Configuración > Usuarios y permisos > Añadir usuario, pega el correo de la cuenta de servicio (...@...iam.gserviceaccount.com) y concede Propietario (se requiere Propietario para la API de inspección de URL).

Configuración

Variables de entorno:

El servidor también carga .env desde su directorio de trabajo al iniciarse.

Registro en un cliente MCP

opencode (~/.config/opencode/opencode.json o .opencode/opencode.json del proyecto):

{
  "mcp": {
    "searchconsole": {
      "type": "local",
      "command": ["node", "/absolute/path/to/searchconsole-mcp/dist/index.js"],
      "environment": {
        "GSC_SERVICE_ACCOUNT_FILE": "/absolute/path/to/service-account.json",
        "GSC_DEFAULT_SITE": "sc-domain:example.com"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "searchconsole": {
      "command": "node",
      "args": ["/absolute/path/to/searchconsole-mcp/dist/index.js"],
      "env": {
        "GSC_SERVICE_ACCOUNT_FILE": "/absolute/path/to/service-account.json",
        "GSC_DEFAULT_SITE": "sc-domain:example.com"
      }
    }
  }
}

Desarrollo

npm install
npm run build     # tsc -> dist/
npm start         # run the server on stdio
npm run smoke     # boots the server and lists tools

Notas

• Los datos de Analytics tienen un retraso de ~2 días; pasa dataState: "all" para incluir datos parciales recientes.

• La API limita las filas de analytics a 25.000 por solicitud; usa startRow para paginar.

• Añadir un sitio mediante la API lo deja sin verificar hasta que se confirme la propiedad; la vía más sencilla es añadir primero el correo de la cuenta de servicio como Propietario en la interfaz.