Configurações de cookies

Os cookies necessários mantêm o site funcionando. A análise mostra quais páginas são úteis. Você pode mudar sua escolha a qualquer momento pelo rodapé.

Política de cookies deste site — detalhes completos: categorias de cookies, como guardamos sua escolha no navegador e como retirar o consentimento.

Necessários

Funções básicas do site e sua escolha de consentimento. Sempre ativos.

Análise

Ajuda a entender como o site é usado. Carregado apenas com sua permissão.

GitHubBaixar ZIP

Relatório de Core Web Vitals do CrUX

Core Web Vitals de campo do Chrome UX Report, separados dos tempos de laboratório para que os dois nunca sejam confundidos. Exige sua própria chave de API do Google Cloud.

Ver no GitHubInício rápido

O que faz

  • Terminal: opções do seohead crux-report

Dados de campo, não de laboratório

O crux-report retorna LCP, INP e CLS no percentil 75, medidos em visitas reais ao Chrome. Cada métrica é comparada aos limites do web.dev e classificada como boa, precisa de melhorias ou ruim. Os resultados do Lighthouse e do PageSpeed são medições de laboratório e ficam em relatórios separados.

  • Limites: LCP de 2,5 e 4 s, INP de 200 e 500 ms, CLS de 0,1 e 0,25.
  • Dados ausentes aparecem como indisponíveis, nunca como aprovados.
  • O relatório mostra as datas da coleta.

Chave e escopo

Você precisa de uma chave de API do Google Cloud com a Chrome UX Report API ativada. Sem ela, o relatório informa que não foi executado. Você pode pedir uma URL, uma origem ou uma amostra limitada de até 25 URLs.

  • A chave é lida de CRUX_API_KEY ou do caminho de configuração e vai no cabeçalho da requisição, não na URL.
  • --form-factor aceita PHONE, DESKTOP ou TABLET.
  • --origin gera um agregado da origem, identificado como tal. Ele não substitui dados de URL que faltam.
  • --cache-dir mantém um cache local privado para as execuções com amostra.

Na auditoria do site

Salve o JSON do crux-report e passe-o ao site-audit com --crux-evidence. A auditoria lê o arquivo salvo e não faz nenhuma chamada ao Google. Assim, um mesmo resultado de campo pode ser reaproveitado em várias auditorias.

  • Os escopos de URL e de origem continuam separados na auditoria.
  • Resultados de campo nunca substituem os resultados de laboratório do Lighthouse.

Três passos, um rastreamento salvo

  1. Adicione sua chave de API do Google

    Salve uma chave da Chrome UX Report API no caminho de configuração ou em CRUX_API_KEY. Sem ela, o relatório informa que não foi executado.

  2. Colete o p75 de campo de uma URL

    Execute o crux-report em uma URL, se quiser com --form-factor PHONE ou DESKTOP, e obtenha LCP, INP e CLS no percentil 75.

  3. Compare os veredictos com os limites oficiais

    Cada métrica é classificada como boa, precisa de melhorias ou ruim, usando os limites do web.dev (LCP 2,5/4 s, INP 200/500 ms, CLS 0,1/0,25). Dados ausentes aparecem como indisponíveis, nunca como aprovados.

Um comando

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

Instale primeiro: guia de instalação. Todo comando também funciona como ferramenta MCP para agentes de IA.

O que você precisa

  • Uma chave de API do Google Cloud com a Chrome UX Report API ativada
  • Uma URL de página, uma origem ou até 25 URLs para uma amostra
  • Opcional: um fator de forma (PHONE, DESKTOP ou TABLET)

Limites

  • O CrUX cobre apenas URLs e origens com tráfego real suficiente no Chrome. As demais não retornam dados.
  • Ele mostra a janela de coleta atual e não explica por que a página está lenta.
  • O SpiderHead testa a leitura das respostas sem acessar a rede. Ele não garante que sua chave funciona até você executar o comando.
  • Dados de campo não são dados de laboratório e não substituem o Lighthouse.

Perguntas

Preciso de uma conta do Google ou de um plano pago?
Você precisa de uma chave de API do Google Cloud com a Chrome UX Report API ativada. As chamadas são gratuitas dentro da cota de API do Google.
Por que uma métrica aparece como indisponível?
O CrUX não tem registro atual para aquela URL ou fator de forma, o período de coleta é inválido ou a chamada ao provedor falhou. Uma métrica indisponível nunca conta como aprovada.
Dá para obter o CrUX de um site inteiro?
Use --origin para um agregado no nível da origem. Ele é identificado como agregado de origem e não substitui dados de URL que faltam. Para várias páginas, passe --urls com uma amostra de até 25 URLs.
É o mesmo que PageSpeed ou Lighthouse?
Não. O CrUX traz dados de campo de usuários reais do Chrome. PSI e Lighthouse são medições de laboratório e ficam separados nos relatórios.
Como incluo o CrUX na auditoria do site?
Salve o JSON do crux-report e passe-o ao site-audit com --crux-evidence. A auditoria lê o arquivo salvo localmente e não chama o Google.
O que fica salvo na minha máquina?
Nada por padrão. A chave fica no seu ambiente ou na pasta de configuração. Se você usar --cache-dir, um cache privado dos resultados amostrados fica ali por 24 horas por padrão.

Continue explorando

Do blog e do glossário

Core Web Vitals: guia completo 2026BlogLCP: como otimizar o Largest Contentful PaintBlogChrome UX Report (CrUX)GlossárioCore Web VitalsGlossárioInteraction to Next Paint (INP)Glossário

Mais neste grupo · Fontes de dados

Integração com o Google Search ConsoleRecursoDados do GA4 e do Yandex MetrikaRecursoIntegração com o Yandex WebmasterRecursoAnalisador de arquivos de log do servidorRecursoVerificador de backlinks de uma lista de doadoresRecursoFerramenta para montar o núcleo semânticoRecurso

Teste no seu próprio site

Baixar ZIPTodos os recursos