Agente auditor: o raio-x, o claude-seo e a lista com evidência
O primeiro agente que vale montar é o que só lê. Ele roda o raio-x, roda o claude-seo e devolve uma lista de problemas, cada um com a linha que prova. Não corrige nada: quem decide o que mexer é você, e a régua de 2026 filtra o que é moda.
Objetivo: rodar o raio-x só de leitura e o claude-seo, e fazer o agente listar problemas com evidência, sem alterar nada.
01 · Do raio-x à lista que você decide
Clique em cada bloco.
Clique em cada bloco do diagrama para ver o que ele faz.
O auditor só lê. Quem escreve no site passa por portão.
02 · Como montar o auditor
Clique em cada passo.
1. Raio-x em arquivo
Rode o auditoria.sh do método com a home e as páginas que importam, e salve a saída num arquivo. É a evidência que o agente vai ler.
O script só faz pedidos de leitura (curl). Pode rodar em qualquer site público, inclusive o do concorrente.
2. claude-seo
O claude-seo pede Python 3.10 ou mais e o Claude Code. Os comandos /seo audit, /seo technical e /seo geo rodam sem pagar nada além da sua assinatura.
A extensão DataForSEO (volume de busca, SERP, backlinks) exige conta paga: o README fala em recarga mínima de US$ 50 e US$ 1 de teste (README de 06/03/2026; confira no site).
Instale lendo antesPrefira clonar e ler o install.sh antes de rodar. Script baixado direto para o bash roda sem você ver o que faz.
3. O pedido
Peça uma tabela: achado, linha de evidência copiada do arquivo, gravidade e correção proposta. E diga o que ele não pode fazer: alterar arquivo, rodar comando que escreva, chamar API.
Achado sem linha de evidência é descartado, como na trava da aula 3.
4. A régua
O módulo de GEO do claude-seo trata llms.txt como padrão emergente, e a referência de schema dele sobre FAQ é de 2023. Marque esses itens como [régua] e decida pelo que vale em 2026.
Bloquear robô de treino não bloqueia robô de busca: robots.txt se decide por finalidade (curso 1, aula 6).
git clone https://github.com/AgriciDaniel/claude-seo.git
cd claude-seo
less install.sh # leia antes de rodar
./install.sh
claude # abre o Claude Code
/seo audit https://www.seusite.com
/seo technical https://www.seusite.com
/seo geo https://www.seusite.com
Pedido ao agente auditor
Leia auditoria.txt (e o relatório do /seo audit, se houver).
Devolva uma tabela com até 10 achados: achado | linha de evidência copiada do arquivo | gravidade (alta/média/baixa) | correção proposta.
Regras:
- Achado sem linha de evidência não entra.
- Não altere nenhum arquivo, não rode comando que escreva, não chame API.
- Marque [régua] toda recomendação sobre llms.txt, FAQ ou "otimizar para IA".
- Robôs no robots.txt: separe busca, ação do usuário e treino.
Redirecionamento: http e sem www vão para um endereço só (308). Nada a fazer.
robots.txt: ClaudeBot está no mesmo grupo dos robôs de busca, mas é robô de treino. Decidir por finalidade.
courses-sitemap: 0 anotações hreflang. O agente aponta; você sabe o contexto (as fichas são só em português e a versão traduzida é outro site).
llms.txt 200: [régua] opcional e barato, não é alavanca de citação.
04 · Prática: o primeiro auditor
Use o seu site. Se não tiver um, use um site público que você conheça bem.
E1 · Raio-x em arquivo
20 min
Rode o auditoria.sh com a home e mais 3 páginas importantes e salve em auditoria.txt. Se tiver o Claude Code, rode também /seo technical na home.
Pronto quando: auditoria.txt existe com as 4 páginas, cada uma com status, title, canonical e a contagem de links internos.
E2 · A lista com evidência
30 min
Passe o pedido do auditor ao agente. Confira cada linha de evidência no arquivo e escreva, ao lado de cada achado, a sua decisão: corrigir, ignorar (com o porquê) ou [régua].
Pronto quando: você tem 5 achados, cada um com uma linha que existe de fato no auditoria.txt e a sua decisão, e o git status do projeto mostra que o agente não alterou nada.
05 · Teste o que aprendeu
A explicação aparece depois da sua resposta.
Pergunta 1 de 4
O agente auditor apontou um problema, mas não copiou nenhuma linha da saída. O que fazer?competência
Correto
Achado sem evidência é opinião. O pedido exige a linha copiada da saída; sem ela, o achado não entra na lista.
O núcleo roda com o Claude Code e Python. Dado de mercado (volume exato, SERP, backlinks) vem da DataForSEO, que é paga. A aula 7 mostra quando isso se paga.
Não é essa
O núcleo roda com o Claude Code e Python. Dado de mercado (volume exato, SERP, backlinks) vem da DataForSEO, que é paga. A aula 7 mostra quando isso se paga.Rever: Como montar o auditor
Pergunta 3 de 4
Na saída real, ClaudeBot aparece no grupo com OAI-SearchBot e Claude-SearchBot. Qual é o achado?
Correto
Busca, ação do usuário e treino são finalidades diferentes. Liberar ou bloquear treino é uma decisão separada, que não afeta a busca.
O módulo de GEO sugere criar llms.txt para aparecer mais nas IAs. Como tratar?
Correto
Um estudo do Ahrefs (137 mil domínios, 15/06/2026) viu que 97% dos arquivos não recebem nenhuma requisição. Pode ter, mas não como alavanca.
Não é essa
Um estudo do Ahrefs (137 mil domínios, 15/06/2026) viu que 97% dos arquivos não recebem nenhuma requisição. Pode ter, mas não como alavanca.Rever: Como montar o auditor
Teste concluído
Você acertou {a} de {n}. Acertando todas, a aula é marcada como concluída.
Escolha uma alternativa. A explicação aparece depois da sua tentativa.
06 · Para levar
Só leituraO auditor lê e aponta. Escrever no site passa por portão.
EvidênciaCada achado com a linha que prova; sem linha, não entra.
Grátis primeiroauditoria.sh e o núcleo do claude-seo. DataForSEO é opcional e pago.
Régua de 2026llms.txt opcional; rich result de FAQ encerrado em 07/05/2026; robots por finalidade.