Performance Audit Tool (Reutilizavel)

Ferramenta CLI para:

1. auditar varias URLs com Lighthouse (mobile e desktop),
2. consolidar os resultados em JSON (completo e enxuto),
3. gerar dashboard HTML para visualizacao rapida.

Requisitos

• Node.js + npm (com npx)
• Chrome/Chromium disponivel para Lighthouse
• Acesso de rede ao site alvo
• Chave da OpenRouter (para quick-wins via LLM)

Estrutura

• run-audit.js: executa auditorias Lighthouse em lote.
• build-report.js: consolida os JSONs e gera dashboard.
• gui-server.js: interface grafica web local para executar e visualizar auditorias.
• gui/: arquivos da interface (HTML/CSS/JS).
• urls.example.txt: modelo para lista de URLs.

Uso rapido

1) Criar lista de URLs

Use um arquivo texto com 1 URL por linha:

https://www.seusite.com/
https://www.seusite.com/sobre/
https://www.seusite.com/contato/

2) Rodar auditoria

node perf-audit-tool/run-audit.js --urls-file ./urls.txt

Opcional:

• --strategies mobile,desktop (padrao: ambos)
• --out-dir ./meus-relatorios
• --quiet
• --urls https://a.com,https://a.com/sobre (alternativa ao arquivo)

3) Consolidar e gerar dashboard

node perf-audit-tool/build-report.js --input-dir ./perf-audit-tool/outputs/20260225_180000

Opcional:

• --output-dir ./saida-final

Saidas geradas

Na pasta de saida:

• auditoria_consolidada.json (payload completo)
• auditoria_consolidada_enxuta.json (dados principais para LLM)
• dashboard.html (visualizacao)

Fluxo recomendado para varios projetos

1. Copiar a pasta perf-audit-tool/ para o projeto.
2. Criar urls.txt com as paginas principais.
3. Rodar run-audit.js.
4. Rodar build-report.js.
5. Compartilhar o auditoria_consolidada_enxuta.json + dashboard.html.

Interface grafica (GUI)

0) Configurar variaveis de ambiente

cd perf-audit-tool
cp .env.example .env

Edite o arquivo .env e preencha:

• OPENROUTER_API_KEY
• opcionalmente OPENROUTER_MODEL

Importante:

• a chave fica somente no backend (gui-server.js), nunca no frontend.

Inicie o servidor local:

node perf-audit-tool/gui-server.js

Abra no navegador:

http://127.0.0.1:4173

Na GUI voce consegue:

1. informar URLs (uma por linha),
2. descobrir URLs internas a partir da home e selecionar quais auditar,
3. escolher mobile/desktop,
4. iniciar auditoria em lote,
5. acompanhar logs em tempo real,
6. abrir dashboard e baixar JSONs consolidados,
7. gerar quick-wins por URL via LLM (OpenRouter).
8. gerar quick-wins direto do dashboard carregado ou de itens do histórico.
9. visualizar gráficos de Core Web Vitals no dashboard consolidado.
10. reutilizar histórico de respostas LLM por run (cache) sem gerar novamente.
11. aprofundar análise de uma URL com algoritmo + LLM (assets críticos CSS/JS + plano de ação técnico).

Aprofundamento por URL (algoritmo + LLM)

Na aba Quick-wins:

1. selecione uma URL do run (ou informe manualmente),
2. escolha mobile ou desktop,
3. clique em Aprofundar (usar cache) ou Aprofundar (regenerar).

O backend executa:

1. coleta técnica da URL com Lighthouse,
2. seleção de assets críticos (CSS/JS) e extração de amostras,
3. envio do bundle técnico para a LLM,
4. retorno de diagnóstico profundo + plano de ação.

Persistência:

• cache da última análise por URL/strategy,
• histórico completo de análises aprofundadas.