Réglages des cookies

Les cookies nécessaires gardent le site fonctionnel. L'analytics montre quelles pages sont utiles. Vous pouvez changer votre choix à tout moment depuis le pied de page.

Politique de cookies — le détail : catégories de cookies, stockage de votre choix dans le navigateur et retrait du consentement.

Nécessaires

Fonctions de base du site et votre choix de consentement. Toujours actifs.

Mesure d'audience

Aide à comprendre comment le site est utilisé. Chargé uniquement avec votre accord.

GitHubTélécharger le ZIP

Rapport CrUX Core Web Vitals

Les Core Web Vitals terrain issus du Chrome UX Report, séparés des mesures en laboratoire pour ne jamais les confondre. Nécessite votre propre clé d’API Google Cloud.

Voir sur GitHubDémarrage rapide

Ce qu'elle fait

  • Terminal : options de seohead crux-report

Données terrain, pas de laboratoire

crux-report renvoie le LCP, l’INP et le CLS au 75e percentile, mesurés sur de vraies visites dans Chrome. Chaque métrique est comparée aux seuils de web.dev et classée bonne, à améliorer ou mauvaise. Les résultats de Lighthouse et de PageSpeed sont des mesures en laboratoire ; ils figurent dans des rapports séparés.

  • Seuils : LCP 2,5 et 4 s, INP 200 et 500 ms, CLS 0,1 et 0,25.
  • Une donnée manquante s’affiche comme indisponible, jamais comme réussie.
  • Le rapport indique les dates de collecte.

Clé et périmètre

Il vous faut une clé d’API Google Cloud avec l’API Chrome UX Report activée. Sans elle, le rapport indique qu’il ne s’est pas exécuté. Vous pouvez demander une URL, une origine ou un échantillon limité à 25 URL.

  • La clé est lue dans CRUX_API_KEY ou dans le chemin de configuration, et elle est envoyée dans un en-tête de requête, jamais dans l’URL.
  • --form-factor accepte PHONE, DESKTOP ou TABLET.
  • --origin donne un agrégat par origine, signalé comme tel. Il ne remplace pas les données d’URL manquantes.
  • --cache-dir conserve un cache local privé pour les analyses sur échantillon.

Dans un audit de site

Enregistrez le JSON de crux-report et transmettez-le à site-audit avec --crux-evidence. L’audit lit le fichier enregistré et n’appelle pas Google. Un même résultat terrain peut ainsi servir à plusieurs audits.

  • Les périmètres URL et origine restent distincts dans l’audit.
  • Les résultats terrain ne remplacent jamais les résultats de laboratoire de Lighthouse.

Trois étapes, un seul scan enregistré

  1. Ajoutez votre clé d’API Google

    Enregistrez une clé de l’API Chrome UX Report dans le chemin de configuration ou dans CRUX_API_KEY. Sans elle, le rapport indique qu’il ne s’est pas exécuté.

  2. Récupérez le p75 terrain d’une URL

    Lancez crux-report sur une URL, éventuellement avec --form-factor PHONE ou DESKTOP, et obtenez le LCP, l’INP et le CLS au 75e percentile.

  3. Lisez les verdicts selon les seuils officiels

    Chaque métrique est classée bonne, à améliorer ou mauvaise selon les limites de web.dev (LCP 2,5/4 s, INP 200/500 ms, CLS 0,1/0,25). Une donnée manquante s’affiche comme indisponible, jamais comme réussie.

Une seule commande

bash
seohead crux-report --url https://example.com/

Commencez par installer : guide d'installation. Chaque commande fonctionne aussi comme outil MCP pour les agents IA.

Ce qu'il vous faut

  • Une clé d’API Google Cloud avec l’API Chrome UX Report activée
  • Une URL de page, une origine, ou jusqu’à 25 URL pour un échantillon
  • Facultatif : un type d’appareil (PHONE, DESKTOP ou TABLET)

Limites

  • CrUX ne couvre que les URL et origines qui reçoivent assez de trafic Chrome réel. Les autres ne renvoient aucune donnée.
  • Le rapport couvre la fenêtre de collecte en cours. Il ne diagnostique pas la raison de la lenteur d’une page.
  • SpiderHead vérifie l’analyse des réponses hors ligne. Il ne garantit pas que votre clé fonctionne tant que vous n’avez pas lancé la commande.
  • Les données terrain ne sont pas des données de laboratoire et ne remplacent pas Lighthouse.

Questions

Faut-il un compte Google ou un abonnement payant ?
Il vous faut une clé d’API Google Cloud avec l’API Chrome UX Report activée. Les appels sont gratuits dans le quota de l’API Google.
Pourquoi une métrique indique-t-elle « indisponible » ?
CrUX n’a aucun enregistrement actuel pour cette URL ou ce type d’appareil, la période de collecte n’est pas valide, ou l’appel au fournisseur a échoué. Une métrique indisponible n’est jamais comptée comme réussie.
Puis-je obtenir CrUX pour un site entier ?
Utilisez --origin pour un agrégat au niveau de l’origine. Il est signalé comme tel et ne remplace pas les données d’URL manquantes. Pour plusieurs pages, passez --urls avec un échantillon de 25 URL au maximum.
Est-ce la même chose que PageSpeed ou Lighthouse ?
Non. CrUX fournit des données terrain issues de vrais utilisateurs de Chrome. PSI et Lighthouse sont des mesures en laboratoire et restent séparées dans les rapports.
Comment intégrer CrUX dans un audit de site ?
Enregistrez le JSON de crux-report, puis transmettez-le à site-audit avec --crux-evidence. L’audit lit le fichier enregistré localement et n’appelle pas Google.
Qu’est-ce qui est stocké sur ma machine ?
Rien par défaut. La clé reste dans votre environnement ou votre dossier de configuration. Si vous utilisez --cache-dir, un cache privé des résultats échantillonnés y est conservé 24 heures par défaut.

Pour aller plus loin

Du blog et du glossaire

Core Web Vitals : le guide complet 2026BlogLCP : comment optimiser le Largest Contentful PaintBlogChrome UX Report (CrUX)GlossaireCore Web VitalsGlossaireInteraction to Next Paint (INP)Glossaire

Autres dans ce groupe · Sources de données

Intégration de Google Search ConsoleFonctionnalitéDonnées GA4 et Yandex MetrikaFonctionnalitéIntégration de Yandex WebmasterFonctionnalitéAnalyseur de fichiers de logs serveurFonctionnalitéVérificateur de backlinks pour une liste de sites donneursFonctionnalitéOutil de collecte du noyau sémantiqueFonctionnalité

Essayez-le sur votre site

Télécharger le ZIPToutes les fonctionnalités