Google Search Console MCP Server

• 💰 Integración con Google AdSense: Informes de ingresos, pagos y alertas de cuenta a través de setup --engine=adsense. Activar AdSense requiere que apruebes un alcance de OAuth de adsense.readonly por separado; tu configuración existente de GSC, Bing y GA4 no cambia hasta que decidas activarlo.
• 🔐 Autenticación de AdSense solo con OAuth: La API de gestión de AdSense solo admite OAuth de usuario — la configuración ahora valida el acceso en vivo y rechaza configuraciones de cuentas de servicio no compatibles con orientación práctica. Los usuarios con varias cuentas obtienen una selección explícita de cuenta de editor con paginación completa (>100 cuentas).
• 📊 Mejoras en adsense_report: Los startDate/endDate personalizados ahora anulan los dateRange predefinidos, además de un nuevo parámetro orderBy (-ESTIMATED_EARNINGS) para informes de ingresos ordenados.
• 🧪 Suite de pruebas MCP de extremo a extremo: El binario del servidor compilado ahora se prueba a través de stdio y SSE exactamente como lo haría un host MCP — handshake, esquemas de herramientas, envoltorios de errores y comportamiento de recursos con varias cuentas (11 pruebas e2e integradas en CI).

• 💰 Integración con Google AdSense: Informes de ingresos, pagos y alertas de cuenta a través de setup --engine=adsense. Activar AdSense requiere que apruebes un alcance de OAuth de adsense.readonly por separado; tu configuración existente de GSC, Bing y GA4 no cambia hasta que decidas activarlo.
• 🔐 Autenticación de AdSense solo con OAuth: La API de gestión de AdSense solo admite OAuth de usuario — la configuración ahora valida el acceso en vivo y rechaza configuraciones de cuentas de servicio no compatibles con orientación práctica. Los usuarios con varias cuentas obtienen una selección explícita de cuenta de editor con paginación completa (>100 cuentas).
• 📊 Mejoras en adsense_report: Los startDate/endDate personalizados ahora anulan los dateRange predefinidos, además de un nuevo parámetro orderBy (-ESTIMATED_EARNINGS) para informes de ingresos ordenados.
• 🧪 Suite de pruebas MCP de extremo a extremo: El binario del servidor compilado ahora se prueba a través de stdio y SSE exactamente como lo haría un host MCP — handshake, esquemas de herramientas, envoltorios de errores y comportamiento de recursos con varias cuentas (11 pruebas e2e integradas en CI).

Por qué existe esto

Los datos del sitio viven en cuatro silos diferentes. Responder a una sola pregunta — "¿cayeron mis ingresos publicitarios por una caída de tráfico o por un RPM más bajo?" — normalmente implica iniciar sesión en cuatro paneles, exportar cuatro CSV y hacer VLOOKUPs a mano.

Search Console MCP pone GSC, Bing, GA4 y AdSense detrás de un conjunto de herramientas que tu agente de IA puede llamar directamente, y hace el análisis (canibalización, detección de anomalías, atribución de ingresos) antes de que los datos lleguen a tu ventana de contexto.

⚡ Inicio rápido

npx search-console-mcp setup

Esto abre tu navegador, autoriza tu cuenta de Google y almacena tus credenciales de forma segura (consulta Seguridad). Luego agrégalo a la configuración de tu cliente MCP (Claude Desktop, Cursor, Antigravity, etc.):

{
  "mcpServers": {
    "search-console": {
      "command": "npx",
      "args": ["search-console-mcp"]
    }
  }
}

Reinicia tu cliente — y prueba uno de los avisos a continuación.

💬 Pruébalo

Pega estos directamente en tu agente:

"Mi tráfico cayó esta semana en comparación con la anterior. Encuentra exactamente cuándo comenzó y qué páginas son responsables."

"Encuentra palabras clave para example.com en posiciones 8–15 con más de 1000 impresiones — mis mejores victorias rápidas."

"Comprueba si hay canibalización de palabras clave: ¿dos de mis páginas compiten por la misma consulta?"

"Ejecuta seo_audit en mis páginas principales: ¿cuáles tienen alta visibilidad en la búsqueda pero un CTR bajo?"

🔌 Conecta tus cuentas

Gestiona todo desde la CLI:

npx search-console-mcp accounts list
npx search-console-mcp accounts add-site --account=you@company.com --site=example.com
npx search-console-mcp accounts remove --account=you@company.com

Cuando tu agente consulta un sitio, el servidor resuelve automáticamente qué cuenta lo posee — sin cambio manual. Documentación de varias cuentas →

# 1. On your laptop (after setup --engine=adsense):
npx search-console-mcp adsense-export

# 2. On the server (prints a ready-to-run command on step 1):
npx search-console-mcp adsense-import --token='...' --publisher-id='accounts/pub-...'

🖥️ Ejecuta herramientas desde la CLI

Search Console MCP también expone las herramientas MCP registradas como comandos CLI directos. Usa el subcomando run para listar herramientas, inspeccionar argumentos específicos de cada herramienta e imprimir resultados como JSON, CSV o una tabla ASCII:

# List registered tools
npx search-console-mcp run --help

# Show options for one tool
npx search-console-mcp run analytics_query --help

# Run an SEO audit with JSON output
npx search-console-mcp run seo_audit --siteUrl=https://example.com --type=quick_wins

# Print array results as CSV or a table
npx search-console-mcp run analytics_query --siteUrl=https://example.com --startDate=2026-06-01 --endDate=2026-06-30 --dimensions=date,query --format=csv
npx search-console-mcp run sites_list --engine=all --format=table

🛠 Herramientas (Arquitectura de dominio fluido)

Search Console MCP v2.0 incluye 7 herramientas de dominio fluido que gestionan todas las operaciones de SEO, Analytics, Inspección e Indexación de forma limpia:

Herramientas de Google AdSense

Nota: accountId se refiere al ID de perfil configurado (p. ej., adsense_2, como se muestra con accounts_manage), no a un nombre de recurso de editor como accounts/pub-123.

🔒 Seguridad

• Llavero del sistema operativo primero — los tokens se almacenan en el Llavero de macOS, el Administrador de credenciales de Windows o el Servicio de secretos de Linux
• Respaldo AES-256-GCM — cifrado con una clave derivada del ID de hardware de tu máquina; un archivo robado es inútil en otro dispositivo
• Almacenamiento mínimo — solo se persisten refresh_token y expiry_date, en mode 600
• Renovación silenciosa — los tokens se renuevan automáticamente en segundo plano

Licencia

MIT · Guía de contribución · Guía de compatibilidad hacia atrás