mcp-google-crux

Servidor MCP para a API do Chrome UX Report (CrUX) — Core Web Vitals de usuários reais (LCP, INP, CLS, TTFB) e histórico de 40 semanas para qualquer origem ou URL. Para Claude, Cursor, Codex e outros clientes de IA.

GitHubExperimente este MCPPatrocinado

Documentação

A1 Google CrUX MCP

Português | Русский

npm Glama CI License: MIT

A1 Google CrUX MCP traz dados reais de Core Web Vitals para aplicativos de IA. Verifique se um site ou página pública passa em LCP, INP e CLS, compare mobile com desktop e veja como as métricas mudaram ao longo do tempo.

Ele lê o conjunto de dados Chrome UX Report do Google — dados de campo coletados de usuários do Chrome, não um teste de velocidade sintético ou uma forma de alterar seu site.

  • 6 ferramentas somente leitura. Avaliação de Core Web Vitals, comparação de dispositivos, comparação origem-versus-página, tendência de 40 semanas e registros brutos mais recentes ou históricos.
  • Dados de usuários reais. São os mesmos dados de campo do CrUX usados pelo PageSpeed Insights e pelos sinais de Core Web Vitals do Google.
  • Limite claro de disponibilidade. Apenas origens e URLs públicas com tráfego real suficiente de usuários têm dados; no_data é um resultado válido.
  • Custo de cota conhecido. O CrUX permite 150 consultas por minuto por projeto. A comparação de dispositivos faz quatro chamadas de API; a comparação origem-versus-página faz duas.

Comece com uma pergunta somente leitura:

O https://example.com passa nos Core Web Vitals no mobile?

Conectar o servidor · Explorar casos de uso · Abrir documentação técnica

Veja funcionando em um minuto

Você: O https://example.com/pricing passa nos Core Web Vitals no mobile?

Assistente: Mostra p75 de LCP, INP e CLS, suas classificações bom/necessita melhorias/ruim e o resultado geral. Nada é alterado.

Você: Compare esta página com a média do site e mostre como o mobile difere do desktop.

Assistente: Compara a origem e a URL, depois os grupos de dispositivos e suas participações no tráfego. Todas as seis ferramentas leem apenas o conjunto de dados público do CrUX.

Conteúdo

Início rápido

Você precisa do Node.js 20+ e de uma chave de API do Google Cloud com a Chrome UX Report API habilitada.

  1. Crie uma chave de API restrita.
  2. Adicione o servidor ao seu aplicativo de IA.
  3. Faça a pergunta somente leitura acima.
Codex

Em Configurações → Servidores MCP, selecione Adicionar servidor, escolha STDIO, insira o comando npx -y mcp-google-crux@latest e as variáveis de ambiente CRUX_API_KEY, depois selecione Salvar e Reiniciar.

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

Documentação MCP do Codex

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

Documentação MCP do Claude Code

Claude Desktop

O caminho oficial atual é Configurações → Extensões. Para uma extensão personalizada do desktop, abra Configurações avançadas → Desenvolvedor de extensões → Instalar extensão…, selecione um arquivo .mcpb e siga as instruções.

Este repositório atualmente publica um pacote npm stdio e não contém um pacote .mcpb. Para builds do Claude Desktop que ainda suportam configuração local, use a seguinte configuração JSON stdio como alternativa:

{"mcpServers":{"google-crux":{"command":"npx","args":["-y","mcp-google-crux@latest"],"env":{"CRUX_API_KEY":"your_key"}}}}

Nesses builds, salve-o em ~/Library/Application Support/Claude/claude_desktop_config.json no macOS ou %APPDATA%\Claude\claude_desktop_config.json no Windows.

Documentação MCP do Claude Desktop

Cursor

Adicione {"mcpServers":{"google-crux":{"type":"stdio","command":"npx","args":["-y","mcp-google-crux@latest"],"env":{"CRUX_API_KEY":"your_key"}}}} a ~/.cursor/mcp.json no macOS/Linux ou %USERPROFILE%\.cursor\mcp.json no Windows. Documentação MCP do Cursor

VS Code

Execute MCP: Abrir configuração do usuário e adicione:

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

Verifique com MCP: Listar servidores. Documentação MCP do VS Code

O que você pode pedir para ele fazer

  • Esta origem ou URL pública passa nos Core Web Vitals?
  • Compare resultados de celular, desktop, tablet e todos os dispositivos.
  • Esta página é mais rápida ou mais lenta que a média do site?
  • Como LCP, INP e CLS mudaram nas últimas 25 semanas?
  • Mostre os histogramas brutos do CrUX e percentis para uma revisão técnica.

Como ler dados do CrUX

O CrUX relata uma janela móvel de 28 dias, atualizada diariamente. Os dados históricos são semanais e atualizados às segundas-feiras. O valor-chave é p75: 75% das visitas observadas estão nele ou abaixo dele. get_core_web_vitals interpreta os limites das métricas para você; as ferramentas de registros brutos expõem histogramas completos e frações de densidade.

Ausência de dados não significa que o site está quebrado. Significa que o Google não tem uma amostra suficientemente grande de usuários públicos do Chrome para aquela origem, URL ou grupo de dispositivos. Tablets e URLs individuais frequentemente não têm dados.

Obtendo acesso

  1. No Google Cloud Console, crie ou selecione um projeto; nenhuma conta de cobrança é necessária para o CrUX.
  2. Habilite a Chrome UX Report API.
  3. Crie uma chave de API em APIs e serviços → Credenciais.
  4. Restrinja a chave à Chrome UX Report API e passe-a como CRUX_API_KEY.

A chave é armazenada na configuração do cliente MCP e é enviada na URL da solicitação da API, portanto, trate-a como uma senha.

Configuração

VariávelObrigatóriaDescrição
CRUX_API_KEYSimChave do Google Cloud com a Chrome UX Report API habilitada.
CRUX_API_BASENãoSubstituição da URL base da API.
CRUX_TIMEOUT_MSNãoTempo limite por solicitação; padrão 30000 ms.
CRUX_MAX_RETRIESNãoTentativas para falhas 429, 5xx e de rede; padrão 3.

Dados, limites e trabalho em segundo plano

  • Conjunto de dados público somente leitura. O servidor não pode alterar sites, Search Console, registros do CrUX ou classificações do Google.
  • Tentativas conscientes de cota. Ele tenta novamente em 429, 5xx e erros de rede com backoff. Tenha em mente as comparações compostas ao planejar a cota de 150 consultas por minuto do projeto.
  • Sem monitoramento em segundo plano. O servidor funciona apenas quando chamado. Se seu aplicativo de IA suportar tarefas agendadas, ele pode criar um relatório de desempenho recorrente.
  • Telemetria anônima. Ele envia dados de instalação e versão, além de nomes de ferramentas, nunca chaves de API, URLs consultadas, resultados, argumentos ou prompts. Defina ASKADS_TELEMETRY=0 para optar por não participar.

Documentação técnica

Suporte

Encontrou um bug ou precisa de um cenário? Crie um problema ou escreva no Telegram.


Две Моны дают пять

Você chegou ao fim!