Docs

Quali regole SEO devo mettere in AGENTS.md o CLAUDE.md?

Metti per ogni nuova pagina un elenco breve di regole verificabili: una domanda e un H1, un titolo e una descrizione unici, un canonical, hreflang, testo generato sul server, JSON-LD coerente con il testo visibile, una voce nella sitemap, fatti con fonte, e non toccare mai le pagine che già funzionano. Le regole guidano l'agente; non dimostrano che la pagina online sia corretta.

Dati

Quale file deve contenere le regole, AGENTS.md o CLAUDE.md?

Usa AGENTS.md se nel repository lavora più di un agente di codifica, perché Codex e Cursor lo leggono e Claude Code lo legge o lo importa. Tieni CLAUDE.md per le note valide solo per Claude, con una riga di importazione perché Claude riceva anche le regole comuni:

# CLAUDE.md
@AGENTS.md

Quali regole devo copiare?

Queste regole sono brevi, concrete e verificabili, come consigliano le stesse documentazioni degli agenti. Incollale come una sezione del file:

## 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.

Perché ognuna di queste regole?

Ogni regola risponde a un modo noto in cui le pagine falliscono:

RegolaPerché
Canonical su ogni paginaGoogle considera rel=canonical un segnale forte, la sitemap solo debole
hreflang tra le lingueGoogle usa le alternative hreflang per le versioni linguistiche, con un canonical nella stessa lingua
Testo generato sul serverAltrimenti i crawler che non eseguono JavaScript vedono una pagina vuota
JSON-LD coerente con il testo visibileLe linee guida di Google sui dati strutturati vietano di segnalare contenuti nascosti
Non toccare le pagine che funzionanoUna riscrittura può far perdere traffico che una pagina già ottiene

Cosa non possono garantire le regole?

Le regole non possono garantire il risultato pubblicato: la documentazione di Claude Code dice che il file è contesto, non configurazione imposta. Un deploy fallito, un canonical sbagliato o una pagina vuota si vedono solo sull'URL online, quindi controlla ogni pagina lì e osserva l'indicizzazione in Search Console.

Passo dopo passo

  1. Scegli il file. Usa AGENTS.md nella radice del repository; aggiungi @AGENTS.md in CLAUDE.md se ne tieni uno.
  2. Incolla le regole. Copia il blocco di regole e adatta percorsi e lingue al tuo sito.
  3. Tienilo breve. Resta ben sotto le 200 righe; sposta le regole di una sola cartella in un file annidato.
  4. Controlla online. Dopo ogni deploy apri i nuovi URL e conferma titolo, canonical, contenuto e JSON-LD.

Errori comuni

  • Scrivere regole vaghe come "segui le best practice SEO" che l'agente non può verificare.
  • Tenere sia CLAUDE.md sia AGENTS.md senza importazione, così Claude Code non legge mai le regole comuni.
  • Incollare un lungo manuale SEO che seppellisce le regole importanti.
  • Considerare il file delle regole come la prova che le pagine pubblicate sono corrette.

Come lo risolve easyIndex

easyIndex dà al tuo agente di codifica le regole delle pagine passo dopo passo via MCP, controlla ogni pagina quando viene inviata e la verifica sul sito online dopo la pubblicazione; un passo si completa con le prove che easyIndex verifica, non con il report dell'agente.

Non modifica mai il tuo sito né il tuo repository, funziona con Claude Code, Codex, Cursor o qualsiasi client MCP, a US$ 30 al mese per sito dopo una prova gratuita di 7 giorni.

Domande frequenti

Claude Code legge AGENTS.md?

Sì, dalla versione 2.1.277 quando non c'è un CLAUDE.md; con un CLAUDE.md, aggiungi la riga @AGENTS.md per includerlo.

Queste regole faranno citare il mio sito da ChatGPT?

Nessuna regola può promettere questo. Rendono le pagine chiare e leggibili dai crawler; la citazione è una decisione di ChatGPT.

Devo aggiungere llms.txt alle regole?

È facoltativo. Prima contano le pagine generate sul server, i canonical e una sitemap.

Una sottocartella può avere regole proprie?

Sì. Gli agenti leggono il file AGENTS.md più vicino nell'albero delle cartelle, quindi un file annidato può contenere le regole di quella cartella.

Continua a leggere

Verificato il .

Regole SEO per AGENTS.md o CLAUDE.md