llms.txt: cos’è, come funziona e quali file aiutano le AI a leggere il tuo sito

Il file llms.txt è un indice del sito in Markdown per gli assistenti AI: elenca pagine e articoli con indirizzo e descrizione, così ChatGPT e Perplexity sanno cosa leggere.

Un assistente AI che visita un sito deve tirare fuori il testo da menu, script, slider e moduli. Questo file gli consegna la stessa informazione già pulita, a un indirizzo che conosce: https://kobalt.it/llms.txt. È una proposta pubblicata da Jeremy Howard su llmstxt.org nel settembre 2024 e non è uno standard ufficiale, ma fa già parte dell’ottimizzazione per i motori generativi.

Cos’è llms.txt e cosa non è?

È un indice dei contenuti, non un file di permessi: non blocca e non autorizza nulla. Per dire alle AI cosa fare dei tuoi testi servono robots.txt e Content-Signal.

Viene spesso descritto come il robots.txt dell’intelligenza artificiale, e lo diceva anche una versione precedente di questo articolo. Non lo è: il formato prevede un titolo, una breve descrizione in forma di citazione e poi elenchi di link, senza nessuna istruzione allow o disallow.

Un esempio reale: il file di kobalt.it

Apre con il nome del sito e una descrizione in forma di citazione, poi spiega come leggere le altre risorse ed elenca pagine e articoli, ognuno con la sua descrizione.

# Kobalt

> Kobalt è il progetto professionale di Lino Sabato, sviluppatore WordPress e consulente SEO freelance di Bari...

## Come leggere questo sito

- Questo file (llms.txt): indice sintetico con titolo, URL e descrizione di ogni contenuto.
- https://kobalt.it/llms-full.txt: testo integrale di tutti i contenuti in un unico documento.
- Singola pagina in Markdown: aggiungi ?llms=md alla URL.

## Pagine

- [Consulente SEO Bari: il posizionamento su Google e AI che porta clienti veri](https://kobalt.it/consulente-seo-bari/): Consulente SEO Bari per chi vuole più clienti da Google...

Conta oltre 250 righe e nessuna è scritta a mano: lo genera il sito e si aggiorna da solo a ogni pubblicazione. Le descrizioni sono le meta description che Google vede nei risultati, come quella della pagina di consulenza SEO qui sopra.

Che differenza c’è tra llms.txt e llms-full.txt?

Il primo è la mappa con titoli, indirizzi e descrizioni; llms-full.txt contiene il testo integrale delle pagine pubbliche in un solo documento Markdown, da leggere con una richiesta.

Su kobalt.it llms-full.txt supera le 140.000 parole: comodo per un agente che deve conoscere tutto il sito, troppo per chi cerca una sola informazione.

RisorsaCosa contieneA cosa serve
/llms.txtTitolo, indirizzo e descrizione di ogni contenutoCapire com’è fatto il sito e cosa leggere
/llms-full.txtIl testo integrale di tutto il sitoLeggere tutto con una sola richiesta
?llms=md su ogni paginaUna pagina in Markdown, senza menu né scriptRispondere su un argomento preciso
/ai/summary.json, service.json, faq.jsonDati dell’attività, servizi con prezzi, FAQDare fatti esatti, senza doverli dedurre
Content-Signal in robots.txtLe preferenze d’uso dei contenutiDire se i testi possono servire alle risposte AI o all’addestramento

Quali altri file aiutano le AI a leggere un sito?

Oltre ai file llms aiutano la versione Markdown di ogni pagina, il catalogo delle risorse, una guida per gli agenti e un profilo con i dati dell’attività.

La pagina in Markdown

Ogni indirizzo del sito risponde anche in Markdown: basta aggiungere ?llms=md, oppure chiederlo con l’header Accept: text/markdown. Prova con la pagina chi sono in Markdown: titolo, descrizione, data di aggiornamento e testo, nient’altro. Questa versione ha il noindex, quindi non fa concorrenza alla pagina normale su Google.

Il catalogo e la guida per gli agenti

/.well-known/api-catalog elenca le risorse pubbliche del sito nel formato dello standard RFC 9727. /.well-known/agent-skills/ contiene una breve guida che spiega a un agente come leggere il sito nel modo più efficiente. Ogni pagina li segnala con gli header Link.

Il profilo AI

Sono tre file JSON, /ai/summary.json, /ai/service.json e /ai/faq.json, con i dati dell’attività, i servizi con i prezzi e le domande frequenti. Sono i fatti che un assistente cerca quando qualcuno chiede quanto costa un servizio o chi lo offre a Bari.

Come si dice alle AI cosa possono fare con i tuoi contenuti?

Con la riga Content-Signal in robots.txt: tre preferenze che dicono se i contenuti possono comparire nelle ricerche, finire nelle risposte AI o servire ad addestrare i modelli.

User-agent: *
Content-Signal: ai-train=yes, search=yes, ai-input=yes

Questa è la riga di kobalt.it: le tre preferenze sono tutte su sì, perché per un sito che vive di contatti essere citato da un assistente AI è un vantaggio. La convenzione è descritta su contentsignals.org e non tutti i crawler la rispettano ancora: per tenere fuori davvero un bot restano le regole Disallow di robots.txt.

Un errore che trovo spesso: aggiungere a robots.txt un gruppo dedicato a un solo bot, per esempio User-agent: GPTBot. Da quel momento quel bot ignora tutte le regole scritte per User-agent: *, esclusioni comprese.

Come si crea llms.txt su WordPress?

Con un plugin che lo genera dai contenuti e lo aggiorna a ogni pubblicazione. Scriverlo a mano si può, ma su un sito che cambia diventa vecchio in poche settimane.

Rank Math e Yoast SEO ne generano già una versione di base, e plugin dedicati come Website LLMS TXT aggiungono più opzioni. A mano basta un file Markdown nella cartella principale del sito, nel formato descritto su llmstxt.org.

Perché ho sviluppato K-llms?

Perché i plugin che ho provato si fermavano ai due file llms e non leggevano bene i contenuti dei blocchi ACF con cui costruisco i siti dei miei clienti.

K-llms è il plugin che uso su kobalt.it e che genera tutto quello che hai visto in questo articolo:

  • legge i contenuti come li vede il visitatore, blocchi ACF e shortcode compresi, e li trasforma in Markdown pulito;
  • prende le descrizioni dalla meta description di Rank Math o Yoast;
  • lascia fuori le pagine in noindex, quelle protette da password e carrello, checkout e account di WooCommerce;
  • pubblica entrambi i file llms, le pagine in Markdown, il catalogo per gli agenti, la riga Content-Signal e il profilo AI;
  • rigenera tutto in background a ogni pubblicazione, senza rallentare il salvataggio;
  • avvisa se in robots.txt un gruppo dedicato a un bot annulla le esclusioni generali;
  • non chiama servizi esterni, non usa cookie e non traccia nessuno.

Non è ancora pubblico: per ora lo installo e lo configuro io, insieme al resto del lavoro sul sito. Se ti serve un sito costruito così fin dall’inizio, trovi tutto nella pagina sulla creazione di siti a Bari.

Vuoi che anche il tuo sito si faccia trovare e citare dalle AI? Installo K-llms sul tuo WordPress, scegliamo insieme le impostazioni e controllo robots.txt e dati strutturati. Scrivimi e ne parliamo.

Domande frequenti su llms.txt e AI SEO

llms.txt è uno standard ufficiale?

No, llms.txt è una convenzione proposta nel 2024, non uno standard ufficiale come robots.txt, e non tutti i modelli AI lo leggono. Adottarlo costa poco e può diventare più rilevante man mano che i crawler AI si standardizzano.

llms.txt blocca l’addestramento delle AI?

No. llms.txt è solo un indice dei contenuti e non contiene permessi. Per dire se i tuoi testi possono servire ad addestrare i modelli si usa la riga Content-Signal in robots.txt, per esempio ai-train=no; per tenere fuori un crawler serve una regola Disallow per il suo user-agent.

ChatGPT e Claude leggono il mio sito?

I modelli AI vengono addestrati su copie del web, non in tempo reale. ChatGPT con la ricerca e Perplexity recuperano contenuti attuali con i propri crawler, Claude usa la ricerca web quando è attiva. Un sito ben strutturato, veloce e con contenuti chiari viene citato più facilmente.

Che differenza c’è tra llms.txt e robots.txt?

Sono complementari: robots.txt dice ai crawler cosa non possono scansionare e, con Content-Signal, come possono usare i contenuti; llms.txt dice alle AI cosa leggere e come sono organizzate le pagine importanti. Stanno entrambi nella cartella principale del dominio e nessuno dei due sostituisce l’altro.

Cos’è llms-full.txt?

È la versione completa di llms.txt: invece dei soli link contiene il testo integrale di tutte le pagine pubbliche in un unico file Markdown, per dare a un agente AI l’intero sito con una sola richiesta. Su siti grandi diventa pesante, per questo conviene affiancargli le singole pagine in Markdown.

Come creo il file llms.txt su WordPress?

Con un plugin che genera il file dai contenuti e lo aggiorna a ogni pubblicazione. Rank Math e Yoast ne creano una versione di base; su questo sito uso K-llms, che ho sviluppato io e che pubblica anche llms-full.txt, le pagine in Markdown, Content-Signal e il profilo AI.

Vuoi che il tuo sito venga trovato anche da ChatGPT e Perplexity?

Chiamami al 329 6277 257 o scrivimi: studio la situazione del tuo sito, ti dico da dove iniziare e se K-llms fa al caso tuo.

Scrivimi per una consulenza gratuita

Aggiornato il