Google CrUX MCP

English | Русский

A1 Google CrUX MCP lleva los datos reales de usuarios de Core Web Vitals a tu aplicación de IA. Comprueba si un sitio o página públicos superan los umbrales de LCP, INP y CLS, compara el móvil con el escritorio y observa cómo han cambiado estas métricas con el tiempo.

Lee el conjunto de datos del Chrome UX Report de Google: datos de campo recopilados de usuarios de Chrome, no una prueba de velocidad sintética ni una forma de modificar tu sitio.

• 6 herramientas de solo lectura. Evaluación de Core Web Vitals, comparación entre dispositivos, comparación entre origen y página, tendencia de 40 semanas y registros recientes o históricos sin procesar.

• Datos reales de usuarios. Son los mismos datos de campo de CrUX que usan PageSpeed Insights y las señales de Core Web Vitals de Google.

• Límites de disponibilidad claros. Solo los orígenes y URLs públicas con suficiente tráfico real de usuarios tienen datos; no_data es un resultado válido.

• Coste de cuota conocido. CrUX permite 150 consultas por minuto por proyecto. La comparación entre dispositivos hace cuatro llamadas a la API; la comparación entre origen y página, dos.

Empieza con una pregunta de solo lectura:

¿Aprueba https://example.com las Core Web Vitals en móvil?

Conecta el servidor · Explora casos de uso · Abre la documentación técnica

Compruébalo en un minuto

Tú: ¿Aprueba https://example.com/pricing las Core Web Vitals en móvil?

Asistente: Muestra el p75 de LCP, INP y CLS, sus valoraciones de bueno/necesita mejorar/deficiente y el resultado general. No cambia nada.

Tú: Compara esta página con la media del sitio y muestra en qué se diferencia el móvil del escritorio.

Asistente: Compara el origen y la URL, luego los grupos de dispositivos y sus cuotas de tráfico. Las seis herramientas leen únicamente el conjunto de datos público de CrUX.

Related MCP server: GSC Analyst Connector

Contenido

• Inicio rápido

• Qué puedes pedirle que haga

• Cómo leer los datos de CrUX

• Obtener acceso

• Configuración

• Datos, límites y trabajo en segundo plano

• Documentación técnica

• Soporte

Inicio rápido

Necesitas Node.js 20+ y una clave de API de Google Cloud con la Chrome UX Report API habilitada.

1. Crea una clave de API restringida.

2. Añade el servidor a tu aplicación de IA.

3. Haz la pregunta de solo lectura anterior.

En Settings → Plugins → MCP servers, selecciona Add server y añade npx -y mcp-google-crux@latest con CRUX_API_KEY.

codex mcp add google-crux --env CRUX_API_KEY=your_key -- npx -y mcp-google-crux@latest
codex mcp list

Documentación de Codex MCP

claude mcp add --env CRUX_API_KEY=your_key --transport stdio --scope user google-crux -- npx -y mcp-google-crux@latest
claude mcp list

Documentación de Claude Code MCP

Abre Settings → Developer → Edit Config y añade {"mcpServers":{"google-crux":{"command":"npx","args":["-y","mcp-google-crux@latest"],"env":{"CRUX_API_KEY":"your_key"}}}}.

Si Edit Config no está disponible, edita ~/Library/Application Support/Claude/claude_desktop_config.json en macOS o %APPDATA%\Claude\claude_desktop_config.json en Windows. Documentación de Claude Desktop MCP

Añade {"mcpServers":{"google-crux":{"type":"stdio","command":"npx","args":["-y","mcp-google-crux@latest"],"env":{"CRUX_API_KEY":"your_key"}}}} a ~/.cursor/mcp.json en macOS/Linux o %USERPROFILE%\.cursor\mcp.json en Windows. Documentación de Cursor MCP

Ejecuta MCP: Open User Configuration y añade:

{"servers":{"google-crux":{"type":"stdio","command":"npx","args":["-y","mcp-google-crux@latest"],"env":{"CRUX_API_KEY":"${input:crux_api_key}"}}},"inputs":[{"type":"promptString","id":"crux_api_key","description":"Google Cloud API key","password":true}]}

Compruébalo con MCP: List Servers. Documentación de VS Code MCP

Qué puedes pedirle que haga

• ¿Aprueba este origen o esta URL pública las Core Web Vitals?

• Compara los resultados de móvil, escritorio, tableta y todos los dispositivos.

• ¿Es esta página más rápida o más lenta que la media del sitio?

• ¿Cómo cambiaron LCP, INP y CLS durante las últimas 25 semanas?

• Muestra los histogramas y percentiles sin procesar de CrUX para una revisión técnica.

Cómo leer los datos de CrUX

CrUX informa de una ventana móvil de 28 días, actualizada a diario. Los datos históricos son semanales y se actualizan los lunes. El valor clave es p75: el 75 % de las visitas observadas se sitúan en ese valor o por debajo. get_core_web_vitals interpreta los umbrales de las métricas por ti; las herramientas de registros sin procesar exponen histogramas completos y fracciones de densidad.

La ausencia de datos no significa que el sitio esté roto. Significa que Google no dispone de una muestra pública de usuarios de Chrome suficientemente grande para ese origen, URL o grupo de dispositivos. Las tabletas y las URLs individuales a menudo no tienen datos.

Obtener acceso

1. En Google Cloud Console, crea o selecciona un proyecto; no se necesita cuenta de facturación para CrUX.

2. Habilita la Chrome UX Report API.

3. Crea una clave de API en APIs & Services → Credentials.

4. Restringe la clave a la Chrome UX Report API y pásala como CRUX_API_KEY.

La clave se almacena en la configuración del cliente MCP y se envía en la URL de la solicitud a la API, por lo que debes tratarla como una contraseña.

Configuración

Datos, límites y trabajo en segundo plano

• Conjunto de datos público de solo lectura. El servidor no puede modificar sitios, Search Console, registros de CrUX ni los rankings de Google.

• Reintentos conscientes de la cuota. Reintenta los errores 429, 5xx y de red con retroceso. Ten en cuenta las comparaciones compuestas al presupuestar la cuota de 150 consultas por minuto del proyecto.

• Sin monitorización en segundo plano. El servidor solo funciona cuando se le invoca. Si tu aplicación de IA admite tareas programadas, puede crear un informe de rendimiento recurrente.

• Telemetría anónima. Envía datos de instalación y versión, además de nombres de herramientas; nunca claves de API, URLs consultadas, resultados, argumentos ni prompts. Establece ASKADS_TELEMETRY=0 para optar por no participar.

Documentación técnica

• Catálogo de capacidades de MCP — páginas orientadas a tareas para cada herramienta.

• Todas las herramientas y entradas

• Documentación de desarrollo

• Documentación de publicación

• Documentación de la API de CrUX

Soporte

¿Has encontrado un error o necesitas un caso? Crea un issue o escribe en Telegram.