Google Search Console

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

Documentación

Servidor MCP de Google Search Console

Un servidor de Model Context Protocol (MCP) que proporciona acceso integral a los datos de Google Search Console con capacidades mejoradas de análisis.

Características

Análisis de búsqueda mejorado: Recupera hasta 25,000 filas de datos de rendimiento
Filtrado avanzado: Soporte para patrones regex y múltiples operadores de filtro
Detección de victorias rápidas: Identifica automáticamente oportunidades de optimización
Dimensiones enriquecidas: Análisis por consulta, página, país, dispositivo y apariencia de búsqueda
Rangos de fechas flexibles: Períodos de informes personalizables con acceso a datos históricos

Patrocinado por

macuse.app es una aplicación nativa de macOS que potencia tu IA integrando asistentes de IA con aplicaciones de macOS como Calendar, Mail y Notes, además de control universal de interfaz para cualquier aplicación. Compatible con Claude Desktop, Cursor y Raycast con configuración en un clic. Prioriza la privacidad y funciona localmente.

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

npm install mcp-server-gsc

Configuración de autenticación

Para obtener credenciales de la API de Google Search Console:

Visita la Consola de Google Cloud
Crea un nuevo proyecto o selecciona uno existente
Habilita la API:

Ve a "APIs y servicios" > "Biblioteca"
Busca y habilita "API de Search Console"

Crea credenciales:

Navega a "APIs y servicios" > "Credenciales"
Haz clic en "Crear credenciales" > "Cuenta de servicio"
Completa los detalles de la cuenta de servicio
Crea una nueva clave en formato JSON
El archivo de credenciales (.json) se descargará automáticamente

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 completos de rendimiento de búsqueda de Google Search Console con capacidades mejoradas de análisis.

Parámetros requeridos:

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

Parámetros opcionales:

dimensions: Lista separada por comas (query, page, country, device, searchAppearance, date)
type: Tipo de búsqueda (web, image, video, news, discover, googleNews)
aggregationType: Método de agregación (auto, byNewsShowcasePanel, byProperty, byPage)
rowLimit: Número máximo de filas a devolver (predeterminado: 1000, máximo: 25000)
dataState: Frescura de los datos (all o final, predeterminado: final)

Parámetros de filtro:

pageFilter: Filtrar por URL de página (admite regex con prefijo regex:)
queryFilter: Filtrar por consulta de búsqueda (admite regex con prefijo regex:)
countryFilter: Filtrar por código de país ISO 3166-1 alpha-3 (p. ej., USA, CHN)
deviceFilter: Filtrar por tipo de dispositivo (DESKTOP, MOBILE, TABLET)
searchAppearanceFilter: Filtrar por función de búsqueda (p. ej., AMP_BLUE_LINK, AMP_TOP_STORIES)
filterOperator: Operador para filtros (equals, contains, notEquals, notContains, includingRegex, excludingRegex)

Detección de victorias rápidas:

detectQuickWins: Habilita la detección automática de oportunidades de optimización (predeterminado: false)
quickWinsConfig: Configuración para la detección de victorias rápidas:
- positionRange: Rango de posición a considerar (predeterminado: [4, 20])
- minImpressions: Umbral mínimo de impresiones (predeterminado: 100)
- minCtr: Porcentaje mínimo de CTR (predeterminado: 1)

Ejemplo - Consulta básica:

{
  "siteUrl": "https://example.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "query,page",
  "rowLimit": 5000
}

Ejemplo - Filtrado avanzado con regex:

{
  "siteUrl": "https://example.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "page,query",
  "queryFilter": "regex:(AI|machine learning|ML)",
  "filterOperator": "includingRegex",
  "deviceFilter": "MOBILE",
  "rowLimit": 10000
}

Ejemplo - Detección de victorias rápidas:

{
  "siteUrl": "https://example.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "query,page",
  "detectQuickWins": true,
  "quickWinsConfig": {
    "positionRange": [4, 15],
    "minImpressions": 500,
    "minCtr": 2
  }
}

Licencia

MIT

Contribuciones

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