Quais regras de SEO colocar no AGENTS.md ou no CLAUDE.md?
Coloque uma lista curta de regras que dá para conferir em toda página nova: uma pergunta e um H1, title e description únicos, canonical, hreflang, texto renderizado no servidor, JSON-LD igual ao texto visível, entrada no sitemap, fatos com fonte e nunca mexer em páginas que já funcionam. Regras guiam o agente; não provam que a página no ar está certa.
Fatos
- O AGENTS.md é usado por mais de 60 mil projetos open source e é mantido pela Agentic AI Foundation, da Linux Foundation, em 13/10/2026. (AGENTS.md)
- O Claude Code v2.1.277 ou mais novo lê o AGENTS.md quando o projeto não tem CLAUDE.md, e um CLAUDE.md pode incluí-lo com a linha @AGENTS.md. (Claude Code docs: How Claude remembers your project)
- A Anthropic recomenda manter cada CLAUDE.md abaixo de 200 linhas e diz que o Claude o trata como contexto, não como configuração obrigatória. (Claude Code docs: How Claude remembers your project)
- O Codex junta arquivos AGENTS.md do ~/.codex e da raiz do projeto para baixo, até 32 KiB por padrão. (OpenAI Codex docs: AGENTS.md)
- O Google diz que dados estruturados devem representar fielmente a página e não podem marcar conteúdo que o leitor não vê. (Google Search Central: General structured data guidelines)
Qual arquivo deve ter as regras, AGENTS.md ou CLAUDE.md?
Use o AGENTS.md se mais de um agente de código trabalha no repositório, porque Codex e Cursor o leem e o Claude Code lê ou importa. Deixe o CLAUDE.md para notas só do Claude, com uma linha de importação para ele receber as regras comuns:
# CLAUDE.md @AGENTS.md
Quais regras copiar?
As regras abaixo são curtas, concretas e conferíveis, como a documentação dos próprios agentes recomenda. Cole como uma seção do arquivo:
## SEO rules for new pages - Only add new content pages. Never change the home page or a page that already works. - One question per page. The H1 is that question; the first paragraph answers it. - Unique <title> (up to 60 characters) and meta description (70 to 165). - Self-referencing rel="canonical" on every page. - Each language version links the others with hreflang; canonical stays in its own language. - The text is in the server-rendered HTML, not loaded only by JavaScript. - JSON-LD describes only what the page visibly says. - Every number or date in a fact links to the source that states it. Invent nothing. - Add the page to the sitemap and link to it from a related page. - A page is done when it is checked on the live URL, not when the build passes.
Por que cada regra?
Cada regra evita um jeito conhecido de a página falhar:
| Regra | Por quê |
|---|---|
| Canonical em toda página | O Google trata o rel=canonical como sinal forte e o sitemap só como sinal fraco |
| hreflang entre idiomas | O Google usa hreflang para versões de idioma, com canonical no mesmo idioma |
| Texto renderizado no servidor | Robôs que não rodam JavaScript veem uma página vazia |
| JSON-LD igual ao texto visível | As diretrizes de dados estruturados do Google proíbem marcar conteúdo escondido |
| Nunca mexer em páginas que funcionam | Reescrever pode perder o tráfego que a página já tem |
O que as regras não garantem?
Regras não garantem o resultado publicado: a própria documentação do Claude Code diz que o arquivo é contexto, não configuração obrigatória. Deploy que falhou, canonical errado ou página vazia só aparecem na URL em produção, então confira cada página lá e acompanhe a indexação no Search Console.
Passo a passo
- Escolha o arquivo. Use um AGENTS.md na raiz do repositório; se tiver CLAUDE.md, adicione @AGENTS.md nele.
- Cole as regras. Copie o bloco de regras e ajuste caminhos e idiomas ao seu site.
- Mantenha curto. Fique bem abaixo de 200 linhas; regras de uma pasta vão num arquivo dentro dela.
- Confira em produção. Depois de cada deploy, abra as URLs novas e confira title, canonical, conteúdo e JSON-LD.
Erros comuns
- Escrever regras vagas como "siga as boas práticas de SEO", que o agente não consegue conferir.
- Ter CLAUDE.md e AGENTS.md sem importação, e o Claude Code nunca ler as regras comuns.
- Colar um manual longo de SEO que esconde as regras que importam.
- Achar que o arquivo de regras prova que as páginas publicadas estão certas.
Como o easyIndex resolve
O easyIndex passa as regras das páginas ao seu agente de código passo a passo pelo MCP, audita cada página ao ser enviada e confere no site no ar depois de publicada; um passo só conclui com evidência que o easyIndex checa, não com o relatório do agente.
Ele nunca mexe no seu site nem no repositório, e funciona com Claude Code, Codex, Cursor ou qualquer cliente MCP, por R$ 57 por site por mês depois de 7 dias grátis.
Perguntas frequentes
O Claude Code lê o AGENTS.md?
Sim, a partir da v2.1.277 quando não há CLAUDE.md; com CLAUDE.md, adicione a linha @AGENTS.md para incluí-lo.
Essas regras fazem meu site aparecer no ChatGPT?
Nenhuma regra garante isso. Elas deixam as páginas claras e rastreáveis; citar é decisão do ChatGPT.
Devo colocar llms.txt nas regras?
É opcional. Páginas renderizadas no servidor, canonical e sitemap vêm primeiro.
Uma subpasta pode ter regras próprias?
Sim. Os agentes leem o AGENTS.md mais próximo na árvore de pastas, então um arquivo dentro da pasta vale para ela.
Continue lendo
- Como usar o Cursor para SEO e para aparecer no ChatGPT?
- Como usar o Codex para SEO e para aparecer no ChatGPT?
- Como fazer GEO com o Claude Code ou o Codex?
- Dados estruturados (schema) ajudam a IA a citar meu site?
- O ChatGPT e o Claude conseguem ler meu site em JavaScript?
- Como o easyIndex funciona, do que eu preciso e quanto tempo até ver resultados?
Verificado em .