Cookie-Einstellungen

Notwendige Cookies halten die Seite am Laufen. Analytics zeigt, welche Seiten nützlich sind. Die Wahl lässt sich jederzeit im Footer ändern.

Cookie-Richtlinie dieser Website – alle Details: Cookie-Kategorien, wie wir Ihre Auswahl im Browser speichern und wie Sie Ihre Einwilligung widerrufen.

Notwendig

Grundfunktionen der Seite und Ihre Einwilligung. Immer aktiv.

Analyse

Hilft zu verstehen, wie die Seite genutzt wird. Wird nur nach Ihrer Zustimmung geladen.

GitHubZIP herunterladen

CrUX-Bericht zu Core Web Vitals

Felddaten zu Core Web Vitals aus dem Chrome UX Report, getrennt von Labormessungen, damit beides nie verwechselt wird. Dafür brauchen Sie einen eigenen Google-Cloud-API-Schlüssel.

Auf GitHub ansehenSchnellstart

Was es leistet

  • Terminal: Optionen von seohead crux-report

Felddaten, keine Labordaten

crux-report liefert LCP, INP und CLS im 75. Perzentil, gemessen an echten Chrome-Besuchen. Jede Metrik wird anhand der Schwellenwerte von web.dev bewertet und als gut, verbesserungswürdig oder schlecht markiert. Ergebnisse von Lighthouse und PageSpeed sind Labormessungen und stehen in eigenen Berichten.

  • Schwellenwerte: LCP 2,5 und 4 s, INP 200 und 500 ms, CLS 0,1 und 0,25.
  • Fehlende Daten werden als nicht verfügbar angezeigt, nie als bestanden.
  • Der Bericht enthält die Erfassungszeiträume.

Schlüssel und Umfang

Sie brauchen einen Google-Cloud-API-Schlüssel mit aktivierter Chrome UX Report API. Ohne ihn meldet der Bericht, dass er nicht gelaufen ist. Sie können eine URL, einen Origin oder eine begrenzte Stichprobe von bis zu 25 URLs abfragen.

  • Der Schlüssel wird aus CRUX_API_KEY oder dem Konfigurationspfad gelesen und im Anfrage-Header übertragen, nicht in der URL.
  • --form-factor akzeptiert PHONE, DESKTOP oder TABLET.
  • --origin liefert ein Origin-Aggregat, das als solches gekennzeichnet ist. Es ersetzt keine fehlenden URL-Daten.
  • --cache-dir legt einen privaten lokalen Cache für Stichprobenläufe an.

In ein Site-Audit einbinden

Speichern Sie das JSON von crux-report und übergeben Sie es mit --crux-evidence an site-audit. Das Audit liest die gespeicherte Datei und ruft Google nicht auf. So lässt sich ein Felddaten-Ergebnis in mehreren Audits wiederverwenden.

  • URL- und Origin-Scope bleiben im Audit getrennt.
  • Felddaten ersetzen nie die Labor-Ergebnisse von Lighthouse.

Drei Schritte, ein gespeicherter Scan

  1. Google-API-Schlüssel hinterlegen

    Legen Sie einen Schlüssel für die Chrome UX Report API im Konfigurationspfad oder in CRUX_API_KEY ab. Ohne ihn meldet der Bericht, dass er nicht gelaufen ist.

  2. Felddaten (p75) für eine URL abrufen

    Starten Sie crux-report für eine URL, optional mit --form-factor PHONE oder DESKTOP, und erhalten Sie LCP, INP und CLS im 75. Perzentil.

  3. Werte an den offiziellen Schwellenwerten prüfen

    Jede Metrik wird anhand der Grenzwerte von web.dev als gut, verbesserungswürdig oder schlecht markiert (LCP 2,5/4 s, INP 200/500 ms, CLS 0,1/0,25). Fehlende Daten werden als nicht verfügbar angezeigt, nie als bestanden.

Ein Befehl

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

Zuerst installieren: Installationsanleitung. Jeder Befehl läuft auch als MCP-Tool für KI-Agenten.

Was Sie brauchen

  • Ein Google-Cloud-API-Schlüssel mit aktivierter Chrome UX Report API
  • Eine Seiten-URL, ein Origin oder bis zu 25 URLs als Stichprobe
  • Optional: ein Gerätetyp (PHONE, DESKTOP oder TABLET)

Grenzen

  • CrUX deckt nur URLs und Origins mit genug echtem Chrome-Traffic ab. Für alle anderen kommen keine Daten zurück.
  • Der Bericht zeigt den aktuellen Erfassungszeitraum, aber keine Diagnose, warum eine Seite langsam ist.
  • SpiderHead prüft die Verarbeitung der Antworten offline. Ob Ihr Schlüssel funktioniert, zeigt sich erst beim ersten echten Aufruf.
  • Felddaten sind keine Labordaten und ersetzen Lighthouse nicht.

Fragen

Brauche ich ein Google-Konto oder einen kostenpflichtigen Tarif?
Sie brauchen einen Google-Cloud-API-Schlüssel mit aktivierter Chrome UX Report API. Die Abfragen sind im Rahmen des Google-API-Kontingents kostenlos.
Warum steht bei einer Metrik „nicht verfügbar“?
Für diese URL oder diesen Gerätetyp gibt es bei CrUX keinen aktuellen Eintrag, der Erfassungszeitraum ist ungültig, oder der Abruf beim Anbieter ist fehlgeschlagen. Eine nicht verfügbare Metrik zählt nie als bestanden.
Kann ich CrUX für eine ganze Website abrufen?
Verwenden Sie --origin für ein Aggregat auf Origin-Ebene. Es ist als Origin-Aggregat gekennzeichnet und ersetzt keine fehlenden URL-Daten. Für mehrere Seiten übergeben Sie --urls mit einer Stichprobe von bis zu 25 URLs.
Ist das dasselbe wie PageSpeed oder Lighthouse?
Nein. CrUX sind Felddaten echter Chrome-Nutzer. PSI und Lighthouse sind Labormessungen und bleiben in den Berichten getrennt.
Wie binde ich CrUX in ein Site-Audit ein?
Speichern Sie das JSON von crux-report und übergeben Sie es mit --crux-evidence an site-audit. Das Audit liest die Datei lokal und ruft Google nicht auf.
Was wird auf meinem Rechner gespeichert?
Standardmäßig nichts. Der Schlüssel bleibt in Ihrer Umgebung oder im Konfigurationsordner. Mit --cache-dir wird dort ein privater Cache der Stichprobenergebnisse abgelegt, standardmäßig 24 Stunden lang.

Weiterstöbern

Aus Blog und Glossar

Core Web Vitals: Der vollständige Leitfaden 2026BlogLCP optimieren: So verbessern Sie Largest Contentful PaintBlogChrome UX Report (CrUX)GlossarCore Web VitalsGlossarInteraction to Next Paint (INP)Glossar

Mehr in dieser Gruppe · Datenquellen

Integration der Google Search ConsoleFunktionGA4- und Yandex-Metrika-DatenFunktionIntegration Yandex WebmasterFunktionServer-Logfile-AnalyseFunktionBacklink-Checker für bekannte LinkgeberFunktionTool für den semantischen KernFunktion

Testen Sie es auf Ihrer eigenen Website

ZIP herunterladenAlle Funktionen