Habilidade de Auditoria de Sites
Audite sites para problemas de SEO, técnicos, conteúdo, desempenho e segurança usando a CLI squirrelscan.
O squirrelscan fornece uma ferramenta CLI squirrel - disponível para macOS, Windows e Linux. Ela realiza auditorias extensas de sites
simulando um navegador, um rastreador de busca e analisando a estrutura e o conteúdo do site com base em mais de 230 regras.
Isso fornecerá uma lista de problemas, bem como sugestões sobre como corrigi-los.
Links
- O site do squirrelscan está em https://squirrelscan.com
- A documentação (incluindo referências de regras) está em docs.squirrelscan.com
Você pode consultar a documentação de qualquer regra usando este modelo:
https://docs.squirrelscan.com/rules/{rule_category}/{rule_id}
exemplo:
https://docs.squirrelscan.com/rules/links/external-links
O que Esta Habilidade Faz
Esta habilidade permite que agentes de IA auditem sites com base em mais de 230 regras em 21 categorias, incluindo:
- Problemas de SEO: Meta tags, títulos, descrições, URLs canônicas, tags Open Graph
- Problemas Técnicos: Links quebrados, cadeias de redirecionamento, velocidade da página, compatibilidade com dispositivos móveis
- Desempenho: Tempo de carregamento da página, uso de recursos, cache
- Qualidade do Conteúdo: Estrutura de cabeçalhos, texto alternativo de imagens, análise de conteúdo
- Segurança: Segredos vazados, uso de HTTPS, cabeçalhos de segurança, conteúdo misto
- Acessibilidade: Texto alternativo, contraste de cores, navegação por teclado
- Usabilidade: Validação de formulários, tratamento de erros, fluxo do usuário
- Links: Verificação de links internos e externos quebrados
- E-E-A-T: Expertise, Experiência, Autoridade, Confiabilidade
- Experiência do Usuário: Fluxo do usuário, tratamento de erros, validação de formulários
- Dispositivo Móvel: Verificação de compatibilidade com dispositivos móveis, design responsivo, elementos táteis
- Rastreabilidade: Verificação de rastreabilidade, robots.txt, sitemap.xml e mais
- Schema: Marcação Schema.org, dados estruturados, rich snippets
- Legal: Conformidade com requisitos legais, políticas de privacidade, termos de serviço
- Social: Open graph, twitter cards e validação de esquemas, snippets, etc.
- Estrutura de URL: Comprimento, hífens, palavras-chave
- Palavras-chave: Excesso de palavras-chave
- Conteúdo: Estrutura do conteúdo, cabeçalhos
- Imagens: Texto alternativo, contraste de cores, tamanho da imagem, formato da imagem
- SEO Local: Consistência NAP, metadados geográficos
- Vídeo: Esquema VideoObject, acessibilidade e mais
A auditoria rastreia o site, analisa cada página com base nas regras de auditoria e retorna um relatório abrangente com:
- Pontuação geral de saúde (0-100)
- Detalhamento por categoria (SEO principal, SEO técnico, conteúdo, segurança)
- Problemas específicos com URLs afetadas
- Detecção de links quebrados
- Recomendações acionáveis
- As regras têm níveis de erro, aviso e notificação, e também têm uma classificação entre 1 e 10
Quando Usar
Use esta habilidade quando precisar:
- Analisar a saúde de um site
- Depurar problemas de SEO técnico
- Corrigir todos os problemas mencionados acima
- Verificar links quebrados
- Validar meta tags e dados estruturados
- Gerar relatórios de auditoria do site
- Comparar a saúde do site antes/depois de alterações
- Melhorar o desempenho, acessibilidade, SEO, segurança e muito mais do site.
Você deve reauditar o máximo possível para garantir que seu site permaneça saudável e tenha um bom desempenho.
Pré-requisitos
Esta habilidade requer a CLI squirrel instalada e no PATH.
Instalação: squirrelscan.com/download
Verificação:
squirrel --version
Configuração
Execute squirrel init para criar um arquivo de configuração squirrel.toml no diretório atual. Se nenhum existir, crie um e especifique um nome de projeto:
squirrel init -n my-project
# sobrescrever configuração existente
squirrel init -n my-project --force
Uso
Introdução
Existem três processos que podem ser executados e todos são armazenados em cache no banco de dados local do projeto:
- crawl - subcomando para executar um rastreio ou atualizar, continuar um rastreio
- analyze - subcomando para analisar os resultados do rastreio
- report - subcomando para gerar um relatório no formato desejado (llm, text, console, html, etc.)
O comando 'audit' é um wrapper em torno desses três processos e os executa sequencialmente:
squirrel audit https://example.com --format llm
VOCÊ DEVE sempre preferir a opção de formato llm - ela foi feita para você e fornece um formato de saída exaustivo e compacto.
A PRIMEIRA VARREDURA deve ser uma varredura de superfície, que é um escaneamento rápido e superficial do site para coletar informações básicas sobre o site, como sua estrutura, conteúdo e pilha de tecnologia. Esta varredura pode ser feita rapidamente e sem impactar o desempenho do site.
A SEGUNDA VARREDURA deve ser uma varredura profunda, que é um escaneamento completo e detalhado do site para coletar mais informações sobre o site, como segurança, desempenho e acessibilidade. Esta varredura pode levar mais tempo e pode impactar o desempenho do site.
Se o usuário não fornecer um site para auditar, pergunte qual URL ele gostaria de auditar.
Você deve PREFERIR auditar sites ao vivo - somente lá obtemos uma VERDADEIRA representação do site e problemas de desempenho ou renderização.
Se você tiver sites locais e ao vivo para auditar, peça ao usuário para escolher qual auditar e SUGIRA que ele escolha o site ao vivo.
Você pode aplicar correções de uma auditoria no site ao vivo contra o código local.
Ao planejar tarefas de escopo para que possam ser executadas simultaneamente como subagentes para acelerar as correções.
Ao implementar correções, aproveite os subagentes para acelerar a implementação das correções.
Após aplicar as correções, verifique se o código ainda compila e passa nas verificações existentes do projeto.
Fluxo de Trabalho Básico
O processo de auditoria consiste em duas etapas:
- Executar a auditoria (salva no banco de dados, mostra saída no console)
- Exportar relatório no formato desejado
# Etapa 1: Executar auditoria (padrão: saída no console)
squirrel audit https://example.com
# Etapa 2: Exportar no formato LLM
squirrel report <audit-id> --format llm
Diffs de Regressão
Quando precisar detectar regressões entre auditorias, use o modo de diff:
# Comparar relatório atual com um ID de auditoria de referência
squirrel report --diff <audit-id> --format llm
# Comparar o relatório de domínio mais recente com um domínio de referência
squirrel report --regression-since example.com --format llm
O modo diff suporta console, text, json, llm e markdown. html e xml não são suportados.
Executando Auditorias
Ao executar uma auditoria:
- Apresente o relatório - mostre ao usuário os resultados da auditoria e a pontuação
- Proponha correções - liste os problemas que você pode corrigir e peça a confirmação do usuário antes de fazer alterações
- Paralelize as correções aprovadas - use subagentes para edições em massa de conteúdo (texto alternativo, cabeçalhos, descrições)
- Itere - corrija o lote → reaudite → apresente resultados → proponha o próximo lote
- Pause para julgamento - links quebrados, mudanças estruturais e qualquer coisa ambígua devem ser sinalizados para revisão do usuário
- Mostre antes/depois - apresente a comparação de pontuação após cada lote de correção
-
Ciclo de Iteração: Após corrigir um lote de problemas, reaudite e continue corrigindo até:
- A pontuação atingir a meta (normalmente 85+), OU
- Apenas problemas que exigem julgamento humano permanecerem (por exemplo, "este link deve ser removido?")
-
Trate todas as correções igualmente: Mudanças de código e mudanças de conteúdo são igualmente importantes.
-
Paralelize correções de conteúdo: Para problemas que afetam vários arquivos:
- Crie subagentes para corrigir em paralelo
- Exemplo: 7 arquivos precisam de texto alternativo → crie 1-2 agentes para corrigir todos
- Exemplo: 30 arquivos têm problemas de cabeçalho → crie agentes para editar em lote
-
Critérios de conclusão:
- ✅ Todos os erros corrigidos
- ✅ Todos os avisos corrigidos (ou documentados como exigindo revisão humana)
- ✅ Reauditoria confirma melhorias
- ✅ Comparação antes/depois mostrada ao usuário
Após as correções serem aplicadas, pergunte ao usuário se ele gostaria de revisar as alterações.
Metas de Pontuação
| Pontuação Inicial | Pontuação Alvo | Trabalho Esperado |
|---|---|---|
| < 50 (Nota F) | 75+ (Nota C) | Correções principais |
| 50-70 (Nota D) | 85+ (Nota B) | Correções moderadas |
| 70-85 (Nota C) | 90+ (Nota A) | Aperfeiçoamento |
| > 85 (Nota B+) | 95+ | Ajuste fino |
Um site só é considerado COMPLETO e CORRIGIDO quando as pontuações estão acima de 95 (Nota A) com cobertura definida como FULL (--coverage full).
Categorias de Problemas
| Categoria | Abordagem de Correção | Paralelizável |
|---|---|---|
| Meta tags/títulos | Editar componentes da página ou metadados | Não |
| Dados estruturados | Adicionar JSON-LD aos templates da página | Não |
| H1/cabeçalhos ausentes | Editar componentes da página + arquivos de conteúdo | Sim (conteúdo) |
| Texto alternativo de imagens | Editar arquivos de conteúdo | Sim |
| Hierarquia de cabeçalhos | Editar arquivos de conteúdo | Sim |
| Descrições curtas | Editar frontmatter do conteúdo | Sim |
| Links HTTP→HTTPS | Localizar e substituir no conteúdo | Sim |
| Links quebrados | Revisão manual (sinalizar para o usuário) | Não |
Para correções paralelizáveis: Crie subagentes com atribuições de arquivo específicas.
Correções em Arquivos de Conteúdo
Muitos problemas exigem a edição de arquivos de conteúdo. Eles são igualmente importantes quanto as correções de código:
- Texto alternativo de imagens: Adicionar texto alternativo descritivo às imagens
- Hierarquia de cabeçalhos: Corrigir níveis de cabeçalho ignorados
- Meta descrições: Estender descrições curtas no frontmatter
- Links HTTP: Atualizar links inseguros para HTTPS
Paralelizando Correções com Subagentes
Quando o usuário aprovar um lote de correções, você pode usar subagentes para aplicá-las em paralelo:
- Pergunte ao usuário primeiro — sempre confirme quais correções aplicar antes de criar subagentes
- Agrupe 3-5 arquivos por subagente para o mesmo tipo de correção
- Paralelize apenas arquivos independentes (sem componentes ou configuração compartilhados)
- Crie vários subagentes em uma única mensagem para execução concorrente
Opções Avançadas
Auditar mais páginas:
squirrel audit https://example.com --max-pages 200
Forçar rastreio novo (ignorar cache):
squirrel audit https://example.com --refresh
Retomar rastreio interrompido:
squirrel audit https://example.com --resume
Saída detalhada para depuração:
squirrel audit https://example.com --verbose
Opções Comuns
Opções do Comando Audit
| Opção | Alias | Descrição | Padrão |
|---|---|---|---|
--format <fmt> | -f <fmt> | Formato de saída: console, text, json, html, markdown, llm | console |
--coverage <mode> | -C <mode> | Modo de cobertura: quick, surface, full | surface |
--max-pages <n> | -m <n> | Número máximo de páginas a rastrear (máx. 5000) | varia por cobertura |
--output <path> | -o <path> | Caminho do arquivo de saída | - |
--refresh | -r | Ignorar cache, buscar todas as páginas novamente | false |
--resume | - | Retomar rastreio interrompido | false |
--verbose | -v | Saída detalhada | false |
--debug | - | Log de depuração | false |
--trace | - | Habilitar rastreamento de desempenho | false |
--project-name <name> | -n <name> | Sobrescrever nome do projeto | do config |
Modos de Cobertura
Escolha um modo de cobertura com base nas suas necessidades de auditoria:
| Modo | Páginas Padrão | Comportamento | Caso de Uso |
|---|---|---|---|
quick | 25 | Apenas sementes + sitemaps, sem descoberta de links | Verificações de CI, verificação rápida de saúde |
surface | 100 | Uma amostra por padrão de URL | Auditorias gerais (padrão) |
full | 500 | Rastrear tudo até o limite | Análise profunda |
O modo surface é inteligente - ele detecta padrões de URL como /blog/{slug} ou /products/{id} e rastreia apenas uma amostra por padrão. Isso o torna eficiente para sites com muitas páginas semelhantes (blogs, e-commerce).
# Verificação rápida de saúde (25 páginas, sem descoberta de links)
squirrel audit https://example.com -C quick --format llm
# Auditoria surface padrão (100 páginas, amostragem de padrões)
squirrel audit https://example.com --format llm
# Auditoria completa abrangente (500 páginas)
squirrel audit https://example.com -C full --format llm
# Sobrescrever limite de páginas para qualquer modo
squirrel audit https://example.com -C surface -m 200 --format llm
Quando usar cada modo:
quick: Pipelines de CI, verificações diárias de saúde, monitoramentosurface: A maioria das auditorias - cobre templates únicos de forma eficientefull: Antes de lançamentos, análise abrangente, mergulhos profundos
Opções do Comando Report
| Opção | Alias | Descrição |
|---|---|---|
--list | -l | Listar auditorias recentes |
--severity <level> | - | Filtrar por gravidade: error, warning, all |
--category <cats> | - | Filtrar por categorias (separadas por vírgula) |
--format <fmt> | -f <fmt> | Formato de saída: console, text, json, html, markdown, xml, llm |
--output <path> | -o <path> | Caminho do arquivo de saída |
--input <path> | -i <path> | Carregar de arquivo JSON (modo de fallback) |
Subcomandos de Config
| Comando | Descrição |
|---|---|
config show | Mostrar configuração atual |
config set <chave> <valor> | Definir valor de configuração |
config path | Mostrar caminho do arquivo de configuração |
config validate | Validar arquivo de configuração |
Outros Comandos
| Comando | Descrição |
|---|---|
squirrel feedback | Enviar feedback para a equipe squirrelscan |
squirrel skills install | Instalar skill do Claude Code |
squirrel skills update | Atualizar skill do Claude Code |
Comandos de Autogestão
Comandos de autogestão sob squirrel self:
| Comando | Descrição |
|---|---|
self install | Inicializar instalação local |
self update | Verificar e aplicar atualizações |
self completion | Gerar conclusões de shell |
self doctor | Executar verificações de saúde |
self version | Mostrar informações de versão |
self settings | Gerenciar configurações da CLI |
self uninstall | Remover squirrel do sistema |
Formatos de Saída
Saída Console (padrão)
O comando audit mostra saída no console legível por humanos por padrão, com cores e indicadores de progresso.
Formato LLM
Para obter saída otimizada para LLM, use o comando report com --format llm:
squirrel report <audit-id> --format llm
O formato LLM é um híbrido compacto XML/texto otimizado para eficiência de tokens (40% menor que XML verbose):
- Resumo: Pontuação geral de saúde e métricas principais
- Problemas por Categoria: Agrupados por categoria de regra de auditoria (SEO principal, técnico, conteúdo, segurança)
- Links Quebrados: Lista de links quebrados