Aula 8 · 20 min
Agente erra de jeitos previsíveis: afirma sem conferir, soma errado, quebra o que funcionava, usa a chave que encontrou. Cada falha real do projeto de SEO do INEMA virou uma linha no changelog de falhas e uma regra no AGENTS.md. Esta aula mostra as falhas, a menor correção de cada uma e fecha o curso com o seu plano.
Começar a aula
Objetivo: reconhecer as falhas reais de agentes em SEO e aplicar as regras: API só autorizada, segredo fora do repo, conferir antes de afirmar.
Clique em cada bloco.
Uma linha por falha: data, o que quebrou, menor correção, prompt ou infra.
Clique em cada passo. Todas estão no FALHAS.md do projeto.
Um plano feito por agente dizia que o site não tinha Search Console: ele procurou só no código. A correção foi conferir o registro TXT do DNS antes de afirmar ausência.
No mesmo dia, o agente sugeriu instalar um pacote de processador diferente da máquina. Regra: conferir a arquitetura antes de sugerir pacote.
O export semanal somou as impressões da marca pela combinação consulta + página, e a parte passou a ser maior que o total. A correção foi somar só pela consulta.
Outro script contou como enriquecida toda ficha presente no arquivo, sem ler o campo que dizia se ela era. Nos dois casos: um número impossível que uma conferência simples pegaria.
Uma mudança visual deixou o índice de cursos "só busca", e as 310 fichas perderam o único link interno no HTML do servidor. A correção foi um índice recolhido, sem mudança visual.
Regerar uma área do site por um gerador antigo desfaria uma correção de canônico feita à mão. A regra ficou escrita: não regerar por cima.
O primeiro envio ao IndexNow com uma chave recém-publicada voltou 403; reenviar alguns minutos depois resolveu (infra). A chave do IndexNow é pública por desenho; a do Bing Webmaster é segredo.
Regra do método: API paga só com autorização explícita para aquela finalidade, e aviso aos buscadores só com URLs que respondem 200.
Copie o FALHAS.md para a raiz do projeto. Rode a varredura antes de cada push.
# FALHAS | data | o que quebrou | menor correção | prompt \| infra | |---|---|---|---| | 2026-10-02 | IndexNow devolveu 403 SiteVerificationNotCompleted no 1º envio (chave recém-publicada) | reenviar após ~4 min | infra | | 2026-10-02 | /cursos/ virou "só busca" e as fichas perderam o único link interno renderizado no servidor | índice recolhido (details) com links simples abaixo da busca | prompt | | 2026-09-24 | export semanal somou impressões da marca por query+page (parte maior que o total) | somas pela dimensão query só | prompt | | 2026-09-23 | plano dizia "sem Search Console" (procurou só no código) | conferir DNS TXT antes de afirmar ausência | prompt |
echo ".env" >> .gitignore git check-ignore -v .env # confirma que o .env está ignorado git grep -niIE "(api[_-]?key|apikey|secret|token)[[:space:]]*[:=]" # procura valor de chave no que vai para o repo
$ git check-ignore -v .env .gitignore:1:.env .env $ git grep -niIE "(api[_-]?key|apikey|secret|token)[[:space:]]*[:=]" avisar.sh:1:curl "https://ssl.bing.com/webmaster/api.svc/json/SubmitUrlBatch?apikey=$BING_API_KEY" rodar.sh:2:export BING_API_KEY=9f3a1c0000000000000000000000beef
Repositório de teste montado para a aula; a chave é falsa.
$BING_API_KEY, uma referência à variável. Está certo.Você é quem responde ao agente. A conversa é ficção; as regras vêm do método inemaSEO.
Escolha a sua resposta. O comentário aparece logo depois e a conversa segue conforme a escolha.
No projeto de SEO das aulas anteriores.
Crie o FALHAS.md na raiz e registre 3 falhas que você já viu um agente cometer (neste curso ou antes), cada uma com a menor correção e se foi prompt ou infra. Leve a regra de cada uma para o AGENTS.md.
Pronto quando: o FALHAS.md tem 3 linhas no formato data | o que quebrou | menor correção | prompt ou infra, e o AGENTS.md ganhou pelo menos uma regra nova vinda delas.
Rode a varredura no projeto e em cada repositório onde um agente trabalhou. Confira o .gitignore.
Pronto quando: git check-ignore -v .env mostra a regra do .gitignore, e a varredura não encontra nenhum valor de chave escrito (só referências a variáveis).
A explicação aparece depois da sua resposta.
Pergunta 1 de 4
O agente diz que o site "não tem Search Console" porque não achou nada no código. O que pedir?competência
Pergunta 2 de 4
A soma da marca ficou maior que o total de impressões. Qual a menor correção?
Pergunta 3 de 4
Qual destas chaves pode ficar visível no site sem problema?
Pergunta 4 de 4
A varredura achou o valor de uma chave escrito num script já commitado. O que fazer?
Escolha uma alternativa. A explicação aparece depois da sua tentativa.
Quatro degraus e os exercícios de cada um. Clique num exercício para ver o "pronto quando".
linha, portões e AGENTS.md
2 exercícios
AGENTS.md na raiz e uma volta da máquina no papel.
Ver a aulaauditor e extração (aulas 2 e 3)
2 exercícios
Lista de achados com evidência e uma extração com trava.
Ver a aulalote e meta (aulas 4 e 5)
2 exercícios
Lote com dry-run e marcador; página pelo loop e pelo portão.
Ver a aularelatório, ferramentas e regras (aulas 6 a 8)
2 exercícios
Relatório semanal com propostas aprovadas e FALHAS.md vivo.
Ver a aulaA base: sem portões escritos, automatizar SEO é publicar errado mais rápido.
Requer o AGENTS.md. Os agentes que só leem vêm antes dos que escrevem; o mapa mostra a aula 2, o plano abaixo lista todas.
Requer os degraus anteriores. Escrever no site só com dry-run, meta de nível 3 e portão antes do push.
O observador fecha a máquina toda semana, e cada falha nova vira regra.
Máquina, ler, escrever e rotina. Só suba de degrau quando o "pronto quando" do anterior for verdade.
Depois deste curso vem o curso 6: o método como serviço para clientes.
Escolha a data de início e quanto tempo você tem por semana.