Auditoria técnica, análise on-page, schema markup, sitemap e otimização para busca por IA (GEO) — tudo como comandos /seo dentro do Claude Code, sem sair do editor.
Claude SEO não é um produto da Anthropic nem afiliado oficialmente ao Claude Code — é uma skill de terceiros (open source, MIT) que se instala em ~/.claude/skills/ e passa a responder a comandos /seo na sua sessão do Claude Code. Ela orquestra 12 sub-skills e 6 subagentes especializados para cobrir o ciclo inteiro de SEO técnico e de conteúdo.
Audita um site inteiro delegando em paralelo para 6 subagentes: técnico, conteúdo, schema, sitemap, performance e visual. Gera um SEO Health Score (0–100) e um plano de ação priorizado.
Detecta JSON-LD/Microdata/RDFa existentes, valida contra os tipos suportados pelo Google e gera markup novo — com consciência de depreciações (ex.: HowTo, FAQ restrito a gov/saúde).
Prepara o site para ser citado por AI Overviews do Google, busca web do ChatGPT e Perplexity — analisando acesso de crawlers de IA (GPTBot, ClaudeBot, PerplexityBot), llms.txt e citabilidade por passagem.
O comando /seo é o ponto de entrada único. A skill principal (seo/SKILL.md) detecta o tipo de comando e delega para a sub-skill certa; para /seo audit, ela dispara 6 subagentes em paralelo via Task tool.
SKILL.md com a tabela de roteamento e as regras centrais; carregado sempre, dispara o resto sob demanda.
Uma por comando — seo-audit, seo-technical, seo-schema, seo-geo, seo-hreflang etc. — cada uma com seu próprio SKILL.md.
Rodam em paralelo durante /seo audit: técnico, conteúdo, schema, sitemap, performance, visual. Sempre via Task tool, nunca via Bash direto.
A skill roda scripts Python locais (fetch, parse HTML, screenshot) por baixo dos comandos /seo.
Requisito do instalador (o README ainda cita 3.8+ em um trecho, mas o install.sh exige 3.10+).
# checar versão python3 --version
A skill só existe dentro de uma sessão do Claude Code — é onde os comandos /seo são reconhecidos.
# iniciar o Claude Code claude
Usado pelo instalador para clonar o repositório e copiar os arquivos da skill para ~/.claude/.
# checar git git --version
Opcional: Playwright (screenshots visuais no /seo audit) e uma conta paga na DataForSEO se quiser dados de SERP/keywords/backlinks ao vivo via extensão MCP.
Os comandos abaixo são os reais do projeto (ver install.sh e README.md). O instalador copia os arquivos de seo/, skills/ e agents/ para dentro de ~/.claude/.
Baixa e copia os arquivos direto para ~/.claude/skills/seo e ~/.claude/agents/.
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.sh | bash # Unix/macOS/Linux
Clona o repositório e roda o instalador local — útil se quiser inspecionar o script antes.
git clone https://github.com/AgriciDaniel/claude-seo.git
cd claude-seo
./install.sh
A skill fica disponível assim que o Claude Code inicia — não precisa de configuração extra.
claude
Dispara os 6 subagentes em paralelo e devolve um SEO Health Score (0–100) com plano de ação priorizado.
/seo audit https://example.com
Cada sub-skill também responde isoladamente — página única, schema, sitemap ou GEO.
/seo page https://example.com/about # análise profunda de 1 página /seo schema https://example.com # detecta/valida/gera Schema.org /seo sitemap generate # gera sitemap com templates por indústria /seo geo https://example.com # otimização para AI Overviews/ChatGPT/Perplexity
Remove os arquivos copiados para ~/.claude/.
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/uninstall.sh | bash
/seoTabela completa dos 13 comandos disponíveis, direto do README do projeto.
| Comando | O que faz |
|---|---|
/seo audit <url> | Auditoria completa do site, com subagentes em paralelo |
/seo page <url> | Análise profunda de uma única página |
/seo sitemap <url> | Analisa um sitemap XML existente |
/seo sitemap generate | Gera um sitemap novo com templates por indústria |
/seo schema <url> | Detecta, valida e gera markup Schema.org |
/seo images <url> | Análise de otimização de imagens |
/seo technical <url> | Auditoria SEO técnica (9 categorias) |
/seo content <url> | Análise de qualidade de conteúdo e E-E-A-T |
/seo geo <url> | Otimização para AI Overviews / busca por IA (GEO) |
/seo plan <tipo> | Planejamento estratégico (saas, local, ecommerce, publisher, agency) |
/seo programmatic <url|plan> | SEO programático em escala, com trava de qualidade |
/seo competitor-pages <url|generate> | Geração de páginas comparativas "X vs Y" |
/seo hreflang <url> | Auditoria e geração de hreflang/i18n |
A skill funciona por completo sem nenhuma extensão paga. A DataForSEO é opcional, para quem quer dados de SERP/keywords/backlinks ao vivo.
/seo dataforseo serp|keywords|backlinks|ai-mentions.docs/AUDIT-REPORT.md): arquitetura, segurança e qualidade de código avaliadas como excelentes; testes automatizados ainda ausentes.install.sh) ainda baixa os arquivos.