Conecta Search Console a cualquier cliente MCP

El endpoint

El servidor está en /mcp dentro del dominio de la aplicación y utiliza Streamable HTTP en la versión de protocolo 2025-06-18. Los clientes envían JSON-RPC mediante POST, hacen una solicitud initialize y luego tools/list. No hay nada que instalar ni ningún proxy local de por medio.

• Authorization: Bearer con una clave con el formato apk_live_ más 32 caracteres hexadecimales
• Las claves se muestran una sola vez al crearlas y se almacenan solo como hash SHA-256
• Cada llamada actualiza la marca de tiempo de último uso y el contador de solicitudes de la clave

Las herramientas

Agrupadas por lo que hacen, con nombres claros para que el modelo elija la correcta. Una clave de solo lectura nunca accede a una herramienta que escribe o gasta créditos de investigación.

• Descubrimiento: list_properties, search_analytics
• Rendimiento: top_queries, top_pages, top_countries, compare_periods
• Diagnóstico: content_decay, cannibalization, ctr_benchmark, page_poaching, rank_changes, new_lost_rankings
• Indexación: url_inspection, sitemaps
• Cronología: annotations, y create_annotation con una clave de escritura
• Analítica: ga4_overview, ga4_breakdown, ga4_key_events
• Investigación: palabras clave, SERP, backlinks, seguimiento de posiciones y auditorías de sitio, que gastan créditos de investigación
• Motor de contenido: content_list_tasks, content_claim, content_get_brief, content_submit, content_publish y las herramientas de portada, para redactar desde la cola

Las fechas son opcionales

Omite el rango en cualquier herramienta y el servidor usa los últimos 28 días estables, teniendo en cuenta el desfase de informes de Search Console, con la ventana de comparación por defecto en el periodo anterior de la misma duración. El cliente nunca necesita saber la fecha de hoy para hacer una pregunta con sentido.

Ámbitos y límites de velocidad

Una clave es de solo lectura o de lectura y escritura. Una clave de solo lectura no puede acceder a ninguna herramienta de escritura, y cada modificación con una clave de escritura queda registrada en la auditoría.

• 60 solicitudes por minuto por clave, 1000 por hora por cuenta
• Superar el límite devuelve HTTP 429 con Retry-After en segundos
• Revoca una sola clave sin afectar al resto de la cuenta

REST, si lo prefieres

Las herramientas de Search Console y GA4 también se exponen como rutas GET y POST bajo /v1 con un documento OpenAPI 3.1 generado en /v1/openapi.json, que sirve además como especificación de llamada a funciones. Mismas claves, mismos permisos, mismos límites.