ferramentas

Como automatizar o Google PageSpeed Insights com n8n

Node da SearchOps conecta a API do PageSpeed ao n8n pra monitorar performance, SEO e Core Web Vitals em escala — sem código

Como automatizar o Google PageSpeed Insights com n8n

O problema

Testar performance de página manualmente não escala. Abrir o PageSpeed Insights, colar a URL, esperar o resultado, anotar os números — funciona pra uma página. Pra 50 landing pages, 3 concorrentes e teste mobile + desktop, vira trabalho repetitivo que ninguém mantém.

O pacote @searchops/n8n-nodes-pagespeed resolve isso. Ele integra a API do Google PageSpeed Insights direto no n8n, permitindo automatizar testes de performance, SEO, acessibilidade e boas práticas em qualquer escala — com agendamento, alertas condicionais e integração com o resto do seu stack.

O que o node faz

  • Análise automatizada de performance com agendamento
  • Teste de URLs em massa a partir de planilhas ou bancos de dados
  • Estratégias mobile e desktop
  • Resposta simplificada ou completa da API
  • Integração com alertas (Slack, email), relatórios e pipelines de CI/CD

Instalação

Via Community Nodes (recomendado)

  1. Abra sua instância do n8n
  2. Vá em Settings > Community Nodes
  3. Clique em Install
  4. Digite o nome do pacote: @searchops/n8n-nodes-pagespeed
  5. Aceite os termos de nós comunitários
  6. Clique em Install

Via npm

npm install @searchops/n8n-nodes-pagespeed

Reinicie o n8n depois da instalação.

Chave de API do Google

O node funciona sem credenciais, mas com limites apertados — 25 requisições por dia. Pra workflows em produção, a chave de API é obrigatória.

Como gerar a chave

1. Acesse o Google Cloud Console em console.cloud.google.com.

2. Crie ou selecione um projeto. Dê um nome descritivo — algo como "n8n-automacao".

3. Ative a API do PageSpeed Insights. Vá em API Library, busque "PageSpeed Insights API" e clique em Enable.

4. Gere a credencial. Em Credentials, clique em Create Credentials > API Key. Copie a chave gerada.

5. Restrinja a chave (recomendado). Edite a chave, em "API restrictions" selecione "Restrict key" e escolha apenas "PageSpeed Insights API". Isso evita que uma chave vazada seja usada pra outros serviços.

Adicionando a chave no n8n

  1. Crie um novo nó PageSpeed Insights no seu workflow
  2. Clique em Create New Credential
  3. Cole a chave de API
  4. Nomeie a credencial (ex.: "PageSpeed API – Produção")
  5. Salve

Limites de uso

Cenário Limite diário
Sem chave de API 25 requisições
Com chave de API (gratuito) 25.000 requisições

Pra a grande maioria dos workflows, o tier gratuito é mais que suficiente.

Configuração do node

Parâmetros básicos

URL (obrigatório) — a página a ser analisada. Precisa incluir o protocolo:

  • Correto: https://exemplo.com.br
  • Incorreto: exemplo.com.br

Strategy — ambiente de teste:

  • Mobile (padrão) — emula dispositivo móvel com conexão 3G
  • Desktop — testa em condições de desktop

Categories — quais auditorias rodar:

  • Performance — Core Web Vitals e métricas de velocidade
  • SEO — verificações de otimização pra busca
  • Accessibility — conformidade com WCAG
  • Best Practices — padrões modernos da web

Simplified Output — quando ativado (padrão), retorna só as métricas essenciais em formato limpo. Desativado, devolve a resposta completa da API com todos os dados brutos.

Opções avançadas

Locale — formata resultados no idioma desejado. Use pt-BR pra português brasileiro, en pra inglês, es pra espanhol.

Parâmetros UTM — rastreia sessões de análise no Google Analytics. Aceita UTM Campaign e UTM Source.

Entendendo a resposta

Saída simplificada

{
  "requestedUrl": "https://exemplo.com.br",
  "finalUrl": "https://exemplo.com.br/",
  "strategy": "mobile",
  "scores": {
    "performance": 95,
    "accessibility": 100,
    "seo": 92,
    "bestPractices": 100
  },
  "metrics": {
    "firstContentfulPaint": {
      "score": 0.99,
      "value": 1234,
      "displayValue": "1.2 s"
    },
    "largestContentfulPaint": {
      "score": 0.95,
      "value": 2345,
      "displayValue": "2.3 s"
    }
  }
}

Interpretação dos scores

  • 90–100 — bom (verde)
  • 50–89 — precisa melhorar (laranja)
  • 0–49 — ruim (vermelho)

Métricas que importam

First Contentful Paint (FCP) — quando o primeiro conteúdo aparece na tela. Meta: abaixo de 1,8 segundo.

Largest Contentful Paint (LCP) — quando o maior elemento visível termina de carregar. Meta: abaixo de 2,5 segundos. É a métrica de Core Web Vitals mais impactante pra percepção de velocidade.

Cumulative Layout Shift (CLS) — mede estabilidade visual. Aquele pulo que a página dá quando um banner carrega tarde? Isso. Meta: abaixo de 0,1.

Total Blocking Time (TBT) — tempo em que a página fica travada sem responder a interações. Meta: abaixo de 200ms.

Speed Index — velocidade com que o conteúdo aparece visualmente. Meta: abaixo de 3,4 segundos.

Workflows prontos pra usar

Monitoramento diário de performance

Checar a homepage todo dia e alertar quando a performance cai.

  1. Schedule Trigger — configurado pra 6h da manhã
  2. PageSpeed Insights — analisa a URL com categoria Performance
  3. IF Node — verifica se scores.performance < 80
  4. Slack ou Email — envia alerta se a condição for verdadeira

Auditoria em massa de URLs

Auditar 50 landing pages por mês a partir de uma planilha.

  1. Google Sheets — lê a lista de URLs
  2. Loop Over Items — processa cada URL
  3. PageSpeed Insights — roda a análise
  4. Google Sheets — escreve os scores de volta na planilha

Comparativo com concorrentes

Comparar a performance do seu site com 3 concorrentes toda semana.

  1. Schedule Trigger — toda segunda-feira
  2. Set Node — define array com URLs dos concorrentes
  3. PageSpeed Insights — analisa cada URL
  4. Function Node — calcula médias dos scores
  5. Database — armazena dados históricos pra comparação

Gate de performance em CI/CD

Bloquear deploys que prejudiquem a performance.

  1. Webhook Trigger — escuta eventos de deploy
  2. PageSpeed Insights — testa a URL de staging
  3. IF Node — verifica se algum score ficou abaixo de 75
  4. HTTP Request — bloqueia o deploy ou envia aviso

Troubleshooting

"API Key Invalid" — verifique se a chave tem a API do PageSpeed ativada no Google Cloud Console. Chaves restritas a outras APIs não funcionam aqui.

Erros de rate limit — adicione a chave de API se ainda não tiver. Pra workflows pesados, insira nós Wait entre as requisições pra espaçar as chamadas.

"URL Not Found" — a URL precisa ser acessível publicamente. Teste em aba anônima. Páginas bloqueadas por robots.txt ou que exigem autenticação não funcionam.

Scores inconsistentes — variação é normal. Performance muda com carga do servidor, condições de rede e até horário do dia. Rode múltiplos testes e trabalhe com médias. Foque na tendência, não no número isolado.

Boas práticas

Teste nas condições reais do usuário. Se seu público é mobile, use a estratégia mobile. Parece óbvio, mas muita gente testa só desktop porque o score é mais alto.

Monitore tendências, não testes isolados. Um score de 85 não diz quase nada sozinho. Um score que caiu de 95 pra 85 em duas semanas diz muito.

Defina limiares realistas. Score 100 em tudo não é meta de produção. Mantenha performance acima de 90 nas páginas críticas e investigue quedas abruptas.

Combine dados de campo e de laboratório. O PageSpeed entrega dois tipos de dado: field data (medições de usuários reais via Chrome UX Report) e lab data (simulações controladas). Os dois juntos dão o panorama completo.

Agende nos horários certos. Rode testes fora dos picos de tráfego pra não distorcer resultados com carga alta no servidor.

Integrações possíveis

  • Dashboards — alimente Grafana, DataDog ou dashboards próprios com os scores
  • Relatórios de SEO — combine com outros nós pra criar relatórios completos de saúde técnica do site
  • Entregas pra clientes — gere relatórios mensais de performance automaticamente
  • SLAs internos — monitore se os times de desenvolvimento estão cumprindo metas de performance

Por que automatizar

Teste manual de performance é o tipo de tarefa que todo mundo sabe que deveria fazer com frequência — e quase ninguém faz. Automatizar resolve isso:

  • Consistência — mesmas condições de teste sempre
  • Detecção precoce — pega regressões antes do usuário sentir
  • Histórico — entende tendências ao longo de meses
  • Escala — testa centenas de URLs sem esforço manual
  • Integração — conecta dados de performance com o resto das métricas do negócio

Comece simples: agende um teste diário da homepage. Quando estiver confortável, expanda pra múltiplas URLs, adicione alertas condicionais e integre os dados de performance no seu monitoramento existente.

pagespeedn8ncore-web-vitalsperformanceautomacao