SEO Auditor
Auditoria SEO on-page de qualquer URL pública: títulos, meta, headings, imagens/alt, links internos, dados estruturados e Core Web Vitals, com checklist acionável e priorizado.
SEO Auditor
Plugin para Claude Code que faz uma auditoria SEO on-page completa de qualquer página pública. Ele busca o HTML real da URL, analisa os principais sinais de SEO técnico e de conteúdo, e entrega um relatório com um checklist acionável e priorizado — sem depender de ferramentas pagas.
O que faz
O SEO Auditor automatiza a parte chata e repetitiva de uma auditoria de página. Em vez de inspecionar manualmente o <head>, contar headings e verificar atributos alt um por um, você aponta o plugin para uma URL e recebe um diagnóstico estruturado. Ele analisa:
- Títulos e meta tags:
<title>,meta description, canonical,robots, Open Graph e Twitter Cards. - Estrutura de headings: presença de um único
<h1>, hierarquia correta de<h2>/<h3>e uso de palavra-chave. - Imagens e alt: imagens sem atributo
alt, alts vazios e oportunidades de otimização. - Links internos: quantidade, âncoras descritivas, links quebrados aparentes e profundidade de navegação.
- Dados estruturados: presença e validade aparente de JSON-LD (Schema.org), tipos detectados e campos faltantes.
- Core Web Vitals: leitura de métricas de desempenho (LCP, INP, CLS) via PageSpeed Insights quando a chave de API estiver disponível.
- Checklist acionável: lista final de correções, ordenada por impacto e esforço.
Instalação
- Copie a pasta
seo-auditor/para o diretório de plugins do seu projeto ou para~/.claude/plugins/. - Confirme que
.claude-plugin/plugin.jsonexiste. - Reinicie o Claude Code (ou recarregue os plugins). Os comandos
/seo-auditorficarão disponíveis. - Opcionalmente, defina a variável de ambiente descrita em Configuração para habilitar a leitura de Core Web Vitals via PageSpeed Insights.
Comandos disponíveis
/auditar— Faz a auditoria SEO on-page completa de uma URL e devolve um relatório com checklist priorizado./comparar— Compara a sua página com a de um concorrente para a mesma palavra-chave e mostra onde você está atrás ou à frente.
Configuração
Nenhuma API paga é obrigatória: o plugin busca o conteúdo público da URL diretamente. Para habilitar a análise de Core Web Vitals em campo e laboratório, defina (apenas o NOME — preencha com seu próprio valor):
GOOGLE_PAGESPEED_API_KEY— chave da API do Google PageSpeed Insights, usada para consultar LCP, INP e CLS. Sem essa variável, o plugin ainda audita todos os sinais on-page, mas estima desempenho apenas a partir do HTML (por exemplo, peso de imagens e scripts bloqueantes).
Nunca cole o valor da chave nos comandos ou no chat; mantenha-o em variáveis de ambiente.
Exemplo de uso
Auditar uma página:
/auditar https://aulasdeia.com/cursos palavra-chave: cursos de inteligência artificialComparar com um concorrente para a mesma intenção de busca:
/comparar minha=https://aulasdeia.com/cursos rival=https://concorrente.com/cursos palavra-chave: cursos de IAO relatório vem em seções: resumo executivo, achados por categoria (com gravidade) e o checklist final ordenado por prioridade (Crítico → Alto → Médio → Baixo), com instruções específicas de correção.
Segurança e limites
- Apenas URLs públicas: o plugin foi feito para páginas acessíveis sem login. Não tente auditar áreas autenticadas ou conteúdo privado de terceiros sem permissão.
- Respeito ao alvo: faça auditorias pontuais. Evite varrer um site inteiro rapidamente, o que pode ser interpretado como abuso pelo servidor de destino.
- Segredos: a
GOOGLE_PAGESPEED_API_KEYnunca é impressa nem armazenada pelo plugin. Mantenha-a fora do repositório (.envno.gitignore). - Cotas da API: o PageSpeed Insights tem limite de requisições; o plugin avisa quando a chave não está presente e cai para a estimativa baseada em HTML.
- Diagnóstico, não garantia: as recomendações seguem boas práticas atuais de SEO, mas rankeamento depende de muitos fatores. Trate o checklist como um plano de ação priorizado, não como promessa de posição.
- Validação humana: revise as correções sugeridas no contexto do seu site antes de aplicá-las, principalmente mudanças em canonical,
robotse dados estruturados.