Impostazioni cookie

I cookie necessari tengono il sito funzionante. La statistica mostra quali pagine sono utili. Puoi cambiare scelta in qualsiasi momento dal footer.

Cookie policy di questo sito — tutti i dettagli: categorie di cookie, come salviamo la tua scelta nel browser e come revocare il consenso.

Necessari

Funzioni di base del sito e la tua scelta di consenso. Sempre attivi.

Analisi

Aiuta a capire come viene usato il sito. Caricato solo dopo il tuo consenso.

GitHubScarica lo ZIP

Report CrUX Core Web Vitals

Core Web Vitals sul campo dal Chrome UX Report, tenuti separati dai tempi di laboratorio così i due non si confondono mai. Richiede la tua chiave API di Google Cloud.

Vedi su GitHubAvvio rapido

Cosa fa

  • Terminale: opzioni di seohead crux-report

Dati sul campo, non di laboratorio

crux-report restituisce LCP, INP e CLS al 75° percentile, misurati su visite Chrome reali. Ogni metrica è giudicata contro le soglie di web.dev e marcata good, needs improvement o poor. I risultati di Lighthouse e PageSpeed sono misure di laboratorio e restano in report separati.

  • Soglie: LCP 2,5 e 4 s, INP 200 e 500 ms, CLS 0,1 e 0,25.
  • I dati mancanti sono mostrati come non disponibili, mai come superati.
  • Il report porta le date di raccolta.

Chiave e ambito

Serve una chiave API di Google Cloud con l'API Chrome UX Report attivata. Senza, il report dice di non essere girato. Puoi chiedere una URL, un'origine, oppure un campione limitato fino a 25 URL.

  • La chiave si legge da CRUX_API_KEY o dal percorso di configurazione, e viaggia in un header di richiesta, non nella URL.
  • --form-factor prende PHONE, DESKTOP o TABLET.
  • --origin dà un aggregato di origine, etichettato come tale. Non sostituisce i dati mancanti per URL.
  • --cache-dir conserva una cache locale privata per i run campionati.

Dentro un audit di sito

Salva il JSON di crux-report e passalo a site-audit con --crux-evidence. L'audit legge il file salvato e non chiama Google. Così un risultato sul campo resta riutilizzabile su più audit.

  • Gli ambiti URL e origine restano distinti nell'audit.
  • I risultati sul campo non sostituiscono mai i risultati di laboratorio di Lighthouse.

Tre passaggi, una scansione salvata

  1. Aggiungi la tua chiave API Google

    Conserva una chiave API Chrome UX Report nel percorso di configurazione o in CRUX_API_KEY. Senza, il report dice di non essere girato.

  2. Tira il p75 sul campo per una URL

    Esegui crux-report su una URL, facoltativamente con --form-factor PHONE o DESKTOP, e ottieni LCP, INP e CLS al 75° percentile.

  3. Leggi i verdetti contro le soglie ufficiali

    Ogni metrica è marcata good, needs improvement o poor con i limiti web.dev (LCP 2,5/4 s, INP 200/500 ms, CLS 0,1/0,25). I dati mancanti sono mostrati come non disponibili, mai come superati.

Un solo comando

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

Prima installa SpiderHead: guida all'installazione. Ogni comando funziona anche come strumento MCP per agenti AI.

Cosa ti serve

  • Una chiave API di Google Cloud con l'API Chrome UX Report attivata
  • Una URL di pagina, un'origine, oppure fino a 25 URL per un campione
  • Opzionale: un form factor (PHONE, DESKTOP o TABLET)

Limiti

  • CrUX copre solo URL e origini con abbastanza traffico Chrome reale. Le altre non restituiscono dati.
  • Riporta la finestra di raccolta corrente, non una diagnosi del perché una pagina è lenta.
  • SpiderHead prova il parsing delle risposte offline. Non assicura che la tua chiave funzioni finché non la usi.
  • I dati sul campo non sono dati di laboratorio e non sostituiscono Lighthouse.

Domande

Serve un account Google o un piano a pagamento?
Serve una chiave API di Google Cloud con l'API Chrome UX Report attivata. Le chiamate sono gratuite entro la quota API di Google.
Perché una metrica dice non disponibile?
CrUX non ha un record corrente per quella URL o form factor, il periodo di raccolta non è valido, oppure la chiamata al provider è fallita. Una metrica non disponibile non è mai contata come superata.
Posso avere CrUX per un intero sito?
Usa --origin per un aggregato a livello di origine. È etichettato come aggregato di origine e non sostituisce i dati mancanti per URL. Per più pagine, passa --urls con un campione fino a 25 URL.
È la stessa cosa di PageSpeed o Lighthouse?
No. CrUX sono dati sul campo da utenti Chrome reali. PSI e Lighthouse sono misure di laboratorio e restano separati nei report.
Come metto CrUX in un audit di sito?
Salva il JSON di crux-report, poi passalo a site-audit con --crux-evidence. L'audit legge il file salvato in locale e non chiama Google.
Cosa viene conservato sul mio computer?
Nulla per impostazione predefinita. La chiave resta nel tuo ambiente o nella cartella di configurazione. Se usi --cache-dir, lì viene conservata una cache privata dei risultati campionati per 24 ore per impostazione predefinita.

Continua a esplorare

Dal blog e dal glossario

Core Web Vitals: guida completa 2026BlogLCP: come ottimizzare il Largest Contentful PaintBlogChrome UX Report (CrUX)GlossarioCore Web VitalsGlossarioInteraction to Next Paint (INP)Glossario

Altre funzionalità del gruppo · Fonti di dati

Integrazione Google Search ConsoleFunzionalitàDati GA4 e Yandex MetrikaFunzionalitàIntegrazione Yandex WebmasterFunzionalitàAnalizzatore dei log del serverFunzionalitàControllo backlink per donor notiFunzionalitàTool per raccogliere il core semanticoFunzionalità

Provalo sul tuo sito

Scarica lo ZIPTutte le funzionalità