llms.txt: cos'è, come crearlo e un esempio completo
C’è un file di testo che nel giro di due anni è passato da proposta di nicchia a presenza fissa nella root dei siti di Anthropic, Stripe, Cloudflare e Cursor. Si chiama llms.txt, pesa pochi kilobyte e ha un obiettivo preciso: far capire il tuo sito a un modello linguistico senza fargli scavare tra menu, script e markup. Vediamo cos’è, come si scrive e — soprattutto — cosa può realisticamente fare per te.
Cos’è il file llms.txt?
llms.txt è un file Markdown pubblicato nella root del sito (tuodominio.it/llms.txt) che fornisce ai modelli linguistici un indice curato dei contenuti: chi sei, cosa fai e quali pagine contano davvero, con un link e una riga di contesto per ciascuna.
La proposta arriva da Jeremy Howard, co-fondatore di Answer.AI, che l’ha pubblicata il 3 settembre 2024. Il problema che vuole risolvere è concreto: quando un LLM visita una pagina web si trova davanti HTML gonfio di navigazione, banner, JavaScript e boilerplate. La finestra di contesto è una risorsa limitata, e gran parte va sprecata a separare il contenuto dal rumore. llms.txt fa il lavoro a monte: consegna al modello una versione pulita, gerarchica e già commentata della mappa del sito.
Un punto va chiarito subito: llms.txt è una proposta della community, non uno standard ufficiale. Nessun ente lo governa, nessun crawler è obbligato a rispettarlo. La specifica vive su llmstxt.org, è aperta al contributo pubblico e ha già una discreta adozione reale — ne parliamo più avanti.
Che differenza c’è tra llms.txt, robots.txt e sitemap.xml?
Sono tre file con tre logiche opposte: robots.txt esclude, sitemap.xml elenca, llms.txt seleziona e spiega. Confonderli è l’errore più comune di chi si avvicina al tema.
| robots.txt | sitemap.xml | llms.txt | |
|---|---|---|---|
| A chi parla | Crawler dei motori di ricerca e bot | Motori di ricerca | LLM e agenti AI |
| Cosa comunica | Cosa non leggere (esclusione) | Inventario completo degli URL | Selezione curata con contesto |
| Formato | Direttive testuali (User-agent, Disallow) | XML | Markdown |
| Obbligatorietà | Standard consolidato, rispettato dai crawler seri | Standard supportato da tutti i motori | Proposta non ufficiale, adozione volontaria |
Robots.txt è un cartello di divieto: dice ai bot dove non possono entrare. Sitemap.xml è l’elenco telefonico: tutti gli URL, senza gerarchia di importanza né spiegazioni. llms.txt è la brochure ragionata: poche pagine scelte, ordinate per priorità, ognuna con una descrizione che dice al modello perché quel contenuto è rilevante. Non a caso la specifica precisa che llms.txt è progettato per coesistere con gli standard esistenti, non per sostituirli.
Come si scrive un llms.txt? Il formato esatto
Si scrive in Markdown puro, seguendo una struttura fissa definita dalla specifica. L’ordine delle sezioni non è negoziabile, e solo la prima è obbligatoria:
- Un H1 con il nome del sito o del progetto. È l’unica sezione richiesta dalla specifica.
- Un blockquote con una sintesi breve — le informazioni chiave per capire tutto il resto del file.
- Zero o più blocchi Markdown liberi (paragrafi, liste — tutto tranne heading) con contesto aggiuntivo su come interpretare i contenuti.
- Zero o più sezioni delimitate da H2, ognuna contenente una lista di link nel formato
[nome](url): nota facoltativa sul contenuto. - Una sezione H2 chiamata “Optional”, con significato speciale: i link elencati lì possono essere saltati dal modello quando serve un contesto più corto. È il posto giusto per contenuti secondari.
La rigidità del formato è voluta: essendo prevedibile, il file può essere processato sia da un LLM sia da un parser classico o una regex. La specifica suggerisce anche una pratica complementare: offrire versioni Markdown pulite delle pagine chiave, raggiungibili aggiungendo .md all’URL originale.
Un esempio completo di llms.txt
Ecco come apparirebbe il file per un laboratorio artigiano fittizio, con tutte le sezioni della specifica al posto giusto:
# Bottega Aurea
> Bottega Aurea è un laboratorio di ceramica artigianale con sede a Verona.
> Produciamo servizi da tavola su misura per ristoranti e privati,
> organizziamo corsi di tornio e vendiamo online in tutta Europa.
> Spedizioni in 5 giorni lavorativi, resi entro 30 giorni.
Le pagine elencate sono disponibili anche in versione Markdown
aggiungendo `.md` all'URL.
## Prodotti e servizi
- [Collezioni da tavola](https://www.bottegaaurea.it/collezioni): catalogo completo con prezzi, materiali e tempi di produzione
- [Ceramica su misura per ristoranti](https://www.bottegaaurea.it/ristoranti): servizio B2B, minimi d'ordine e casi studio
- [Corsi di tornio](https://www.bottegaaurea.it/corsi): calendario, livelli e prezzi aggiornati
## Informazioni pratiche
- [Spedizioni e resi](https://www.bottegaaurea.it/spedizioni): tempi, costi e condizioni per Italia ed Europa
- [Domande frequenti](https://www.bottegaaurea.it/faq): cura dei pezzi, personalizzazioni, tempi di attesa
- [Contatti](https://www.bottegaaurea.it/contatti): showroom, orari e prenotazione visite
## Optional
- [La nostra storia](https://www.bottegaaurea.it/storia): il laboratorio dal 1987 a oggi
- [Rassegna stampa](https://www.bottegaaurea.it/press): articoli e intervisteNota il criterio: non c’è tutto il sito, ci sono le pagine che rispondono alle domande che un potenziale cliente farebbe a un assistente AI. Prezzi, condizioni, servizi. La storia aziendale sta sotto Optional, dove non consuma contesto a chi cerca informazioni operative.
Come si pubblica llms.txt sul proprio sito?
Si carica il file nella root del dominio, esattamente come robots.txt: deve rispondere su tuodominio.it/llms.txt con content-type testuale. Non serve registrarlo da nessuna parte, non esiste una “Search Console” per llms.txt.
Operativamente:
- Scrivi il file seguendo la struttura vista sopra. Un editor di testo basta; la specifica è volutamente scrivibile a mano.
- Caricalo nella root. Su un sito statico è un file in più nella cartella di pubblicazione; su WordPress si usa un plugin SEO che lo supporti o si carica via FTP; su piattaforme di documentazione come Mintlify o GitBook viene generato in automatico.
- Verifica che risponda aprendo l’URL nel browser: devi vedere il Markdown grezzo, non una pagina 404 o un redirect.
- Tienilo aggiornato. Un indice che punta a pagine morte o prezzi vecchi è peggio di nessun indice: consegna informazioni sbagliate proprio ai sistemi che le ripeteranno agli utenti.
Il punto 4 è quello che separa un esercizio di stile da un asset. Nei progetti che seguiamo, llms.txt non è un file scritto una tantum: è un output dell’architettura del sito, dove SEO, AEO e GEO sono scritte nel codice e ogni pagina nasce già con la sua versione leggibile dalle macchine.
Chi usa davvero llms.txt? Lo stato dell’adozione
L’adozione è reale ma polarizzata: fortissima nel mondo developer, marginale altrove — e con Google apertamente scettico.
Dal lato di chi pubblica, la lista è lunga: Anthropic espone llms.txt e llms-full.txt per la documentazione di Claude, e lo stesso fanno Stripe, Cloudflare, Vercel e Cursor. Le piattaforme di documentazione hanno fatto da moltiplicatore: quando Mintlify ha attivato la generazione automatica del file, migliaia di siti lo hanno adottato in una notte — e fu proprio Anthropic, racconta Mintlify, a chiederne l’implementazione. Dal lato di chi consuma, i coding assistant — Cursor, Claude Code, Windsurf, Cline — cercano attivamente il file quando un utente li punta verso una documentazione.
Poi c’è Google, e qui il quadro cambia. John Mueller ha paragonato llms.txt al vecchio meta tag keywords: un’auto-dichiarazione del sito su se stesso, che nessun sistema può usare per distinguere un sito buono da uno che si vende bene. Gary Illyes ha confermato che Google non supporta il file e non prevede di farlo; la guida ufficiale di Google sulla ricerca generativa dice esplicitamente che non servono file AI speciali per comparire in AI Overviews o AI Mode. La posizione però non è un anatema: lo stesso Mueller riconosce che sulla documentazione tecnica il file ha senso, come aiuto alla navigazione per agenti che il sito lo conoscono già.
La lettura corretta, quindi: llms.txt oggi non è una leva di ranking, è una leva di leggibilità per gli agenti che scelgono di usarlo. Va trattato come un tassello della strategia, non come la strategia — che resta quella descritta nella nostra guida alla GEO: contenuti citabili, structured data, risposte dirette alle domande reali.
Cos’è llms-full.txt e quando conviene?
llms-full.txt è la variante integrale: un unico file Markdown che contiene tutto il contenuto del sito concatenato, pensato per l’ingestione completa in una sola richiesta. Se llms.txt è la mappa, llms-full.txt è il libro.
La convenzione è nata dalla collaborazione tra Mintlify e Anthropic, che aveva bisogno di un modo pulito per dare in pasto ai modelli l’intera documentazione senza parsing dell’HTML, ed è poi entrata nella specifica di llmstxt.org. Conviene quando il tuo contenuto principale è documentazione: API, guide tecniche, knowledge base. Per un sito vetrina o un e-commerce di poche decine di pagine, il file indice basta e avanza; un llms-full.txt da centinaia di migliaia di token servirebbe a poco.
Vale la pena crearlo?
Sì, a una condizione: che arrivi dopo le fondamenta, non al posto loro. llms.txt costa un paio d’ore, non può danneggiarti e ti rende immediatamente più leggibile per gli agenti AI che lo cercano. Ma è l’ultimo strato di un lavoro che parte più in basso: contenuti che rispondono a domande vere, structured data corretti, un’architettura veloce e pulita. Un indice curato che punta a pagine deboli non convince nessun modello.
È l’approccio che seguiamo con One Domain: SEO, AEO e GEO costruite insieme su un dominio unico, dove llms.txt è uno degli output del sistema — non un cerotto applicato a un sito che le macchine non riescono a leggere. Se vuoi capire a che punto è il tuo sito e cosa vedono davvero gli LLM quando lo visitano, prenota una call: trenta minuti, diagnosi concreta.
Domande frequenti
- llms.txt sostituisce robots.txt o la sitemap?
- No, li affianca. Robots.txt dice ai crawler cosa non leggere, sitemap.xml elenca tutti gli URL per i motori di ricerca, llms.txt offre agli LLM una selezione curata con contesto. Tre file, tre funzioni diverse: nessuno rende obsoleti gli altri.
- Google usa llms.txt per il ranking?
- No. John Mueller lo ha paragonato al vecchio meta tag keywords e Gary Illyes ha confermato che Google non lo supporta. Non influisce su ranking, AI Overviews o AI Mode. Pubblicarlo non danneggia, ma non sposta la visibilità su Google.
- Quanto tempo serve per creare un llms.txt?
- Per un sito di dimensioni normali, un paio d'ore: scegliere le 10-30 pagine che contano, scrivere una sintesi onesta in blockquote e una riga di contesto per ogni link. La manutenzione è minima: si aggiorna quando cambiano le pagine chiave.
- Che differenza c'è tra llms.txt e llms-full.txt?
- llms.txt è l'indice: una mappa curata con link e descrizioni. llms-full.txt è il contenuto completo del sito concatenato in un unico file Markdown, pensato per l'ingestione diretta. Il primo serve alla navigazione, il secondo alla lettura integrale.
- Serve anche a un sito vetrina o a un'attività locale?
- L'utilità dimostrata oggi riguarda soprattutto documentazione tecnica letta dai coding assistant. Per un'attività locale il beneficio è potenziale, non misurato. Costa poco, quindi ha senso pubblicarlo — ma dopo aver sistemato contenuti, structured data e architettura, non al posto loro.