Google Search Console

Google Search Console MCP Server

Un servidor de Model Context Protocol (MCP) que proporciona acceso a Google Search Console.

Características

• Recuperación de datos de análisis de búsqueda con soporte de dimensiones
• Análisis de datos enriquecido con períodos de informes personalizables

Requisitos previos

• Node.js 18 o posterior
• Proyecto de Google Cloud con la API de Search Console habilitada
• Credenciales de cuenta de servicio con acceso a Search Console

Instalación

Instalación mediante Smithery

Para instalar Google Search Console para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install mcp-server-gsc --client claude

Instalación manual

npm install mcp-server-gsc

Configuración de autenticación

Para obtener credenciales de la API de Google Search Console:

1. Visita la Google Cloud Console
2. Crea un nuevo proyecto o selecciona uno existente
3. Habilita la API:

• Ve a "APIs & Services" > "Library"
• Busca y habilita "Search Console API"

4. Crea credenciales:

• Navega a "APIs & Services" > "Credentials"
• Haz clic en "Create Credentials" > "Service Account"
• Completa los detalles de la cuenta de servicio
• Crea una nueva clave en formato JSON
• El archivo de credenciales (.json) se descargará automáticamente

5. Otorga acceso:

• Abre Search Console
• Añade el correo electrónico de la cuenta de servicio (formato: name@project.iam.gserviceaccount.com) como administrador de la propiedad

Uso

Configuración de Claude Desktop

{
  "mcpServers": {
    "gsc": {
      "command": "npx",
      "args": ["-y", "mcp-server-gsc"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
      }
    }
  }
}

Herramientas disponibles

search_analytics

Obtén datos de rendimiento de búsqueda de Google Search Console con parámetros personalizables:

Parámetros requeridos:

• siteUrl: URL del sitio (formato: http://www.example.com/ o sc-domain:example.com)
• startDate: Fecha de inicio (YYYY-MM-DD)
• endDate: Fecha de fin (YYYY-MM-DD)

Parámetros opcionales:

• dimensions: Lista separada por comas (query,page,country,device,searchAppearance)
• type: Tipo de búsqueda (web, image, video, news)
• aggregationType: Método de agregación (auto, byNewsShowcasePanel, byProperty, byPage)
• rowLimit: Número máximo de filas a devolver (predeterminado: 1000)

Ejemplo:

{
  "siteUrl": "https://example.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "query,country",
  "type": "web",
  "rowLimit": 500
}

Licencia

MIT

Contribuciones

¡Las contribuciones son bienvenidas! Por favor, lee nuestras pautas de contribución antes de enviar pull requests.