Habilidade de Auditoria SEO
Audite sites para SEO, aspectos técnicos, conteúdo, performance, segurança, renderização JavaScript e prontidão para IA usando a CLI do SEOmator.
O SEOmator fornece auditorias abrangentes de sites, analisando a estrutura e o conteúdo do site com base em 251 regras em 20 categorias.
Ele fornece uma lista de problemas com níveis de severidade, URLs afetadas e sugestões de correção acionáveis.
Links
- Pacote npm SEOmator: npmjs.com/package/@seomator/seo-audit
- Repositório GitHub: github.com/seo-skills/seo-audit-skill
- Interface Web: seomator.com/free-seo-audit-tool
O Que Esta Habilidade Faz
Esta habilidade permite que agentes de IA auditem sites para 251 regras em 20 categorias, incluindo:
- SEO Principal (19 regras): URLs canônicas, diretivas de indexação, unicidade de título, conflitos/loops canônicos
- Performance (22 regras): LCP, CLS, FCP, TTFB, INP, compressão, caching, minificação, HTTP/2
- Links (19 regras): Links quebrados, cadeias de redirecionamento, texto âncora, páginas órfãs, links localhost/fragmento
- Imagens (14 regras): Texto alternativo, dimensões, lazy loading, formatos modernos, tamanho do alt, imagens de fundo
- Segurança (16 regras): HTTPS, HSTS, CSP, segurança de links externos, segredos vazados, expiração/protocolo SSL
- SEO Técnico (13 regras): robots.txt, sitemap.xml, estrutura de URL, páginas 404, soft 404s, códigos de erro
- Rastreabilidade (18 regras): Conflitos de sitemap, sinais de indexabilidade, cadeias canônicas, problemas de paginação
- Dados Estruturados (13 regras): Marcação Schema.org, Artigo, Organização, FAQ, Produto, Breadcrumb
- Renderização JavaScript (13 regras): Verificações de DOM renderizado, incompatibilidades entre raw e renderizado, detecção de SSR
- Acessibilidade (12 regras): Rótulos ARIA, contraste de cores, rótulos de formulários, landmarks, alvos de toque
- Conteúdo (17 regras): Contagem de palavras, legibilidade, densidade de palavras-chave, detecção de duplicatas, larguras de pixel
- Social (9 regras): Tags Open Graph, cartões Twitter, botões de compartilhamento, links de perfil
- E-E-A-T (14 regras): Créditos de autor, citações, sinais de confiança, páginas sobre/contato, detecção YMYL
- Estrutura de URL (14 regras): Slugs com palavras-chave, stop words, maiúsculas, underscores, IDs de sessão, parâmetros de rastreamento
- Redirecionamentos (8 regras): Loops de redirecionamento, tipos (301/302), meta refresh, redirecionamentos JavaScript, redirecionamentos quebrados
- Mobile (5 regras): Tamanhos de fonte, rolagem horizontal, intersticiais intrusivos, problemas de viewport
- Internacionalização (10 regras): Atributo lang, validação de hreflang (links de retorno, conflitos, incompatibilidades)
- Validação HTML (9 regras): Doctype, charset, estrutura do head, lorem ipsum, múltiplos títulos/descrições
- Prontidão para IA/GEO (5 regras): HTML semântico, acesso a bots de IA, llms.txt, deriva de schema
- Conformidade Legal (1 regra): Consentimento de cookies
A auditoria rastreia o site, analisa cada página de acordo com as regras de auditoria e retorna um relatório abrangente com:
- Pontuação geral de saúde (0-100) com nota de letra (A-F)
- Detalhamentos por categoria com contagens de aprovação/advertência/falha
- Problemas específicos com URLs afetadas agrupadas por regra
- Recomendações de correção acionáveis
Quando Usar
Use esta habilidade quando você precisar:
- Analisar a saúde SEO de um site
- Depurar problemas técnicos de SEO
- Verificar links quebrados e cadeias de redirecionamento
- Validar meta tags, URLs canônicas e dados estruturados
- Auditar cabeçalhos de segurança, SSL e HTTPS
- Verificar conformidade de acessibilidade
- Analisar renderização JavaScript e compatibilidade SSR
- Avaliar prontidão para IA/GEO (HTML semântico, llms.txt, acesso a bots)
- Detectar conteúdo duplicado entre páginas
- Validar configuração de hreflang e internacionalização
- Verificar estrutura e validação de documentos HTML
- Gerar relatórios de auditoria do site em vários formatos
- Comparar a saúde do site antes/depois de alterações
Pré-requisitos
Esta habilidade requer a instalação da CLI do SEOmator.
Instalação
npm install -g @seomator/seo-audit
Verificar Instalação
Verifique se o seomator está instalado e o sistema está pronto:
seomator self doctor
Isso verifica:
- Versão do Node.js (18+ recomendado)
- Disponibilidade do npm
- Chrome/Chromium para Core Web Vitals e renderização JS
- Permissões de escrita para ~/.seomator
- Presença de arquivo de configuração local
Configuração
Executar seomator init cria um arquivo de configuração seomator.toml no diretório atual.
seomator init # Configuração interativa
seomator init -y # Usar padrões
seomator init --preset blog # Configuração otimizada para blog
seomator init --preset ecommerce # Configuração para e-commerce
seomator init --preset ci # Configuração CI mínima
Se não houver um arquivo seomator.toml no diretório, CRIE UM com seomator init antes de executar auditorias.
Uso
Melhores Práticas para Agentes de IA
VOCÊ DEVE sempre preferir --format llm - ele fornece saída XML otimizada para tokens, projetada especificamente para agentes de IA (50-70% menor que JSON).
Ao auditar:
- Prefira sites ativos em vez de servidores de desenvolvimento locais para dados precisos de performance e renderização
- Use
--no-cwvpara auditorias mais rápidas quando não forem necessárias verificações de Core Web Vitals e renderização JS - Defina o escopo das correções como tarefas concorrentes ao implementar várias correções
- Execute verificação de tipos/formatação após implementar correções (tsc, eslint, prettier, etc.)
Descoberta de Site
Se o usuário não fornecer um site para auditar:
- Verifique configurações de servidor de desenvolvimento local (scripts package.json, arquivos .env)
- Procure por links de projetos Vercel/Netlify
- Verifique variáveis de ambiente para URLs de implantação
- Pergunte ao usuário qual URL auditar
Se você tiver sites locais e ativos disponíveis, sugira auditar o site ativo para obter resultados precisos.
Fluxo de Trabalho Básico
# Auditoria rápida de página única com saída LLM
seomator audit https://exemplo.com --format llm --no-cwv
# Rastreamento de várias páginas (até 50 páginas)
seomator audit https://exemplo.com --crawl -m 50 --format llm --no-cwv
# Auditoria completa com Core Web Vitals + análise de renderização JS
seomator audit https://exemplo.com --crawl -m 20 --format llm
Opções Avançadas
Forçar novo rastreamento (ignorar cache):
seomator audit https://exemplo.com --refresh --format llm
Retomar rastreamento interrompido:
seomator audit https://exemplo.com --resume --format llm
Auditar apenas categorias específicas:
seomator audit https://exemplo.com -c core,security,js --format llm --no-cwv
Salvar relatório HTML para compartilhar:
seomator audit https://exemplo.com --format html -o relatorio.html
Saída detalhada para depuração:
seomator audit https://exemplo.com --format llm -v
Referência de Comandos
Opções do Comando Audit
| Opção | Alias | Descrição | Padrão |
|---|---|---|---|
--format <fmt> | -f | Formato de saída: console, json, html, markdown, llm | console |
--max-pages <n> | -m | Número máximo de páginas para rastrear | 10 |
--crawl | Habilitar rastreamento de várias páginas | false | |
--categories <lista> | -c | Categorias separadas por vírgula para auditar | Todas |
--refresh | -r | Ignorar cache, buscar novo | false |
--resume | Retomar rastreamento interrompido | false | |
--no-cwv | Pular Core Web Vitals + renderização JS | false | |
--verbose | -v | Mostrar progresso | false |
--output <caminho> | -o | Caminho do arquivo de saída | |
--config <caminho> | Caminho do arquivo de configuração | ||
--save | Salvar em ~/.seomator | false |
Outros Comandos
seomator init # Criar arquivo de configuração
seomator self doctor # Verificar configuração do sistema
seomator config --list # Mostrar todos os valores de configuração
seomator report --list # Listar relatórios anteriores
seomator db stats # Mostrar estatísticas do banco de dados
Formatos de Saída
| Formato | Flag | Melhor Para |
|---|---|---|
| console | --format console | Saída de terminal humano (padrão) |
| json | --format json | CI/CD, processamento programático |
| html | --format html | Relatórios independentes, compartilhamento |
| markdown | --format markdown | Documentação, GitHub |
| llm | --format llm | Agentes de IA (recomendado) |
A saída --format llm é um formato XML compacto otimizado para eficiência de tokens:
- 50-70% menor que a saída JSON
- Problemas classificados por severidade (críticos primeiro)
- Sugestões de correção incluídas para cada problema
- Saída limpa para pipe em ferramentas de IA
Exemplos
Exemplo 1: Auditoria Rápida com Saída LLM
# Usuário pergunta: "Verifique exemplo.com para problemas de SEO"
seomator audit https://exemplo.com --format llm --no-cwv
Exemplo 2: Rastreamento Profundo para Site Grande
# Usuário pergunta: "Faça uma auditoria completa com até 100 páginas"
seomator audit https://exemplo.com --crawl -m 100 --format llm --no-cwv
Exemplo 3: Nova Auditoria Após Alterações
# Usuário pergunta: "Re-audite o site, ignore resultados em cache"
seomator audit https://exemplo.com --refresh --format llm --no-cwv
Exemplo 4: Gerar Relatório Compartilhável
# Usuário pergunta: "Crie um relatório HTML que eu possa compartilhar"
seomator audit https://exemplo.com --crawl -m 20 --format html -o relatorio-seo.html
Exemplo 5: Foco em Áreas Específicas
# Usuário pergunta: "Apenas verifique minha renderização JavaScript e redirecionamentos"
seomator audit https://exemplo.com -c js,redirect --format llm
Avaliando Resultados
Faixas de Pontuação
| Pontuação | Nota | Significado |
|---|---|---|
| 90-100 | A | Excelente - Apenas otimizações menores |
| 80-89 | B | Bom - Lidar com advertências |
| 70-79 | C | Precisa de Trabalho - Correções prioritárias necessárias |
| 50-69 | D | Ruim - Múltiplos problemas críticos |
| 0-49 | F | Crítico - Grandes problemas a resolver |
Ordem de Prioridade (por peso da categoria)
Corrija os problemas nesta ordem para máximo impacto:
- Principal (12%) - Meta tags, canônico, H1, indexação
- Performance (12%) - Core Web Vitals + otimização
- Links (8%) - Estrutura de links internos
- Imagens (8%) - Performance + acessibilidade
- Segurança (8%) - Sinais de confiança, SSL
- SEO Técnico (7%) - Fundação de rastreamento
- Rastreabilidade (5%) - Indexabilidade, paginação
- Dados Estruturados (5%) - Snippets enriquecidos
- Renderização JavaScript (5%) - DOM renderizado, SSR
- Conteúdo (5%) - Qualidade do texto + duplicatas
- Acessibilidade (4%) - Conformidade WCAG
- Social (3%) - Compartilhamento social
- E-E-A-T (3%) - Confiança, especialização
- Estrutura de URL (3%) - Higiene de URL
- Redirecionamentos (3%) - Cadeias de redirecionamento
- Mobile (2%) - Viewport, fontes
- Internacionalização (2%) - Hreflang
- Validação HTML (2%) - Estrutura do documento
- Prontidão para IA/GEO (2%) - HTML semântico, bots de IA
- Conformidade Legal (1%) - Consentimento de cookies
Corrigir por Severidade
- Falhas (status: "fail") - Deve corrigir imediatamente
- Advertências (status: "warn") - Deve corrigir em breve
- Aprovações (status: "pass") - Nenhuma ação necessária
Resumo da Saída
Após implementar as correções, forneça ao usuário um resumo de todas as alterações feitas.
Ao planejar o escopo, organize as tarefas para que possam ser executadas simultaneamente como subagentes para acelerar a implementação.
Solução de Problemas
comando seomator não encontrado
Se você vir este erro, o seomator não está instalado ou não está no seu PATH.
Solução:
npm install -g @seomator/seo-audit
Core Web Vitals não medidos
Se as métricas CWV estiverem faltando, o Chrome/Chromium pode não estar disponível.
Solução:
- Instale Chrome, Chromium ou Edge
- Execute
seomator self doctorpara verificar a detecção do navegador - Use
--no-cwvpara pular CWV se não for necessário
Tempo limite de rastreamento ou desempenho lento
Para sites grandes, as auditorias podem levar vários minutos.
Solução:
- Use
--verbosepara ver o progresso - Limite páginas com
-m 20para resultados mais rápidos - Use
--no-cwvpara pular medições baseadas em navegador
URL inválida
Certifique-se de que a URL inclua o protocolo:
# Errado
seomator audit exemplo.com
# Correto
seomator audit https://exemplo.com
Como Funciona
- Buscar: Baixa o HTML da página e mede o tempo de resposta
- Analisar: Extrai DOM, meta tags, links, imagens, dados estruturados
- Enriquecer: Busca robots.txt e sitemap uma vez por auditoria
- Renderizar (se CWV habilitado): Captura o DOM renderizado via Playwright para análise de renderização JS
- Rastrear (se habilitado): Descobre e busca páginas vinculadas
- Analisar: Executa 251 regras de auditoria em cada página
- Pontuar: Calcula pontuações ponderadas por categoria e geral
- Relatar: Gera saída no formato solicitado
Os resultados são armazenados em ~/.seomator/ para recuperação posterior com seomator report.
Recursos
- Referência completa das regras: Consulte
docs/SEO-AUDIT-RULES.mdpara todas as 251 regras - Arquitetura de armazenamento: Consulte
docs/STORAGE-ARCHITECTURE.mdpara detalhes do banco de dados - Ajuda da CLI:
seomator --helpeseomator <comando> --help