mcp-google-crux

Google CrUX MCP

Español | Русский

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

Lee el conjunto de datos 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 de dispositivos, comparación origen-versus-página, tendencia de 40 semanas y registros históricos o más recientes sin procesar.
• Datos de usuarios reales. Son los mismos datos de campo de CrUX que utilizan PageSpeed Insights y las señales de Core Web Vitals de Google.
• Límite de disponibilidad claro. Solo los orígenes y URLs públicas con suficiente tráfico de usuarios reales tienen datos; no_data es un resultado válido.
• Costo de cuota conocido. CrUX permite 150 consultas por minuto por proyecto. La comparación de dispositivos realiza cuatro llamadas a la API; la comparación origen-versus-página realiza dos.

Comienza con una pregunta de solo lectura:

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

Conectar el servidor · Explorar casos de uso · Abrir documentación técnica

Véalo funcionar en un minuto

Usted: ¿Supera https://example.com/pricing Core Web Vitals en móvil?

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

Usted: Compare esta página con el promedio del sitio y muestre 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 solo leen el conjunto de datos público de CrUX.

Contenido

• Inicio rápido
• Qué puede pedirle que haga
• Cómo leer los datos de CrUX
• Cómo obtener acceso
• Configuración
• Datos, límites y trabajo en segundo plano
• Documentación técnica
• Soporte

Inicio rápido

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

1. Cree una clave de API restringida.
2. Agregue el servidor a su aplicación de IA.
3. Haga la pregunta de solo lectura anterior.

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

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

{"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}]}

Qué puede pedirle que haga

• ¿Supera este origen o URL pública Core Web Vitals?
• Compare resultados de teléfono, escritorio, tableta y todos los dispositivos.
• ¿Es esta página más rápida o más lenta que el promedio del sitio?
• ¿Cómo cambiaron LCP, INP y CLS durante las últimas 25 semanas?
• Muestre los histogramas y percentiles sin procesar de CrUX para una revisión técnica.

Cómo leer los datos de CrUX

CrUX informa una ventana móvil de 28 días, actualizada diariamente. Los datos históricos son semanales y se actualizan los lunes. El valor clave es p75: el 75% de las visitas observadas están en o por debajo de ese valor. get_core_web_vitals interpreta los umbrales de métricas por usted; 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 tiene una muestra suficientemente grande de usuarios públicos de Chrome para ese origen, URL o grupo de dispositivos. Las tabletas y las URLs individuales a menudo no tienen datos.

Cómo obtener acceso

1. En Google Cloud Console, cree o seleccione un proyecto; no se necesita cuenta de facturación para CrUX.
2. Habilite la API de Chrome UX Report.
3. Cree una clave de API en APIs y servicios → Credenciales.
4. Restrinja la clave a la API de Chrome UX Report y pásela 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, así que trátela 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 clasificaciones de Google.
• Reintentos conscientes de la cuota. Reintenta errores 429, 5xx y de red con retroceso. Tenga en cuenta las comparaciones compuestas al presupuestar la cuota de 150 consultas por minuto del proyecto.
• Sin monitoreo en segundo plano. El servidor solo funciona mientras se le llama. Si su 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 indicaciones. Establezca 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

¿Encontró un error o necesita un escenario? Cree un problema o escriba en Telegram.

¡Llegó al final!