Vai al contenuto

Guida al file llms.txt: cos'è, come scriverlo e cosa aspettarsi davvero

Alessandro Caprai · 28 ottobre 2026 · 6 min di lettura

Quando ho costruito caprai.dev ho deciso che il sito dovesse parlare due lingue: quella delle persone e quella dei modelli di intelligenza artificiale. Il file llms.txt è stato uno dei primi passi, e oggi caprai.dev è uno dei 3.826 siti inseriti nella directory llmstxt.cloud, che raccoglie chi adotta lo standard.

Questo è il vademecum che avrei voluto avere allora: che cosa fa il file, che cosa non fa e come scriverlo in un'ora.

In breve. llms.txt è un file di testo in Markdown, pubblicato alla radice del sito, che presenta ai modelli linguistici chi sei e quali pagine leggere per prime. Non controlla l'accesso come robots.txt e non elenca tutto come la sitemap: è una presentazione curata, pensata per gli assistenti AI che leggono il tuo sito su richiesta di qualcuno.

Che cos'è llms.txt

La proposta è di Jeremy Howard, cofondatore di Answer.AI, ed è stata pubblicata nel settembre 2024 su llmstxt.org. Non è uno standard ufficiale, ma una convenzione che si è diffusa in fretta. Per capirla basta confrontarla con i due file che conosciamo già:

  • robots.txt dice ai crawler dove possono andare.
  • sitemap.xml elenca tutte le pagine da indicizzare.
  • llms.txt sceglie le pagine che contano e spiega in poche parole perché.

Il file vive a un indirizzo fisso, tuosito.it/llms.txt, spesso accompagnato da llms-full.txt con il testo integrale dei contenuti.

Che cosa fa davvero, a ottobre 2026

Nel 2026 il ruolo di llms.txt si è chiarito, e in meglio. La documentazione di Google Search spiega che il file non è un necessario fattore di posizionamento (Search Engine Journal). Da maggio, però, Google lo controlla in Lighthouse e in PageSpeed Insights, dentro la nuova categoria Agentic Browsing (DebugBear): quella che misura quanto un sito è pronto per gli agenti AI, accanto all'accessibilità e agli strumenti offerti agli agenti.

È questo il suo campo principale. Quando un assistente o un agente arriva sul tuo sito per conto di una persona e cerca un punto da cui partire, llms.txt gli consegna la versione dei fatti che hai scelto tu. È uno strumento di marketing prima ancora che di SEO o di GEO, l'ottimizzazione per le risposte delle AI: orienta il modo in cui un'AI racconta il tuo brand quando qualcuno glielo chiede.

Come creare il file: la struttura

La specifica è minimale. Ecco lo scheletro:

# Nome del sito

> Una o due frasi: chi sei, per chi lavori, che cosa offri.

Qualche riga di contesto: lingue, area geografica, come leggere il sito.

## Servizi
- [Formazione AI per aziende](https://tuosito.it/aziende): percorsi per team, con prezzi e regole

## Guide principali
- [Titolo della guida](https://tuosito.it/guida): il problema che risolve, in una riga

## Url Articoli
- [Archivio articoli](https://tuosito.it/blog): approfondimenti meno centrali

Le regole formali sono tre: un solo titolo con #, il riassunto nella riga che inizia con >, poi sezioni con ## fatte di link, ciascuno seguito da una breve descrizione dopo i due punti. La sezione Optional dice al modello che quel materiale si può saltare quando lo spazio è poco.

Il vademecum: otto regole operative

  1. Scrivi il riassunto come una frase di posizionamento. È la riga che un modello ripeterà più spesso: chi sei, per chi lavori, che cosa ti distingue.
  2. Seleziona, non elencare. Se il file diventa una copia della sitemap ha perso il suo scopo. In alto le pagine che vuoi vedere citate, il resto in Optional o in llms-full.txt.
  3. Scrivi descrizioni che dicono il valore. Non ricopiare la meta description: spiega a che cosa serve la pagina e per chi.
  4. Ordina per priorità commerciale. Prima le pagine che portano contatti o vendite (servizi, corsi, chi sei), poi i contenuti di approfondimento.
  5. Usa link assoluti e stabili. Un link che porta altrove o a una pagina che non esiste più è un'occasione persa.
  6. Gestisci le lingue con criterio. Se il sito è multilingua, una sezione per lingua con i link alla versione giusta, mai lo stesso elenco ripetuto.
  7. Resta coerente con il resto del sito. Nome, descrizione e servizi devono dire le stesse cose della pagina chi sono e dei dati strutturati. Le AI incrociano le fonti, e una contraddizione costa credibilità.
  8. Generalo, non scriverlo a mano. Un file statico invecchia alla prima pagina nuova: se il sito ha un CMS o un database, fai in modo che si aggiorni da solo.

Il caso caprai.dev

Il nostro llms.txt non è scritto a mano: lo genera il sito leggendo dal database gli articoli pubblici, i corsi pubblicati e le pagine principali, in italiano, inglese e spagnolo. In fondo c'è una sezione che le guide di solito non citano: gli strumenti che il sito mette a disposizione degli agenti AI, di cui ho parlato nell'articolo sul web agentico. Accanto ci sono llms-full.txt, con il testo completo degli articoli, e una versione in Markdown di ogni articolo, più leggera da elaborare per un modello.

Due lezioni le ho imparate sul campo. La prima: llms-full.txt pubblica tutto, ed è il punto più delicato del sito. In passato un errore nel codice faceva finire nel file anche il testo integrale degli articoli riservati. L'abbiamo corretto, e oggi dei test automatici controllano che nessun contenuto chiuso finisca nei due file. La seconda: le informative legali finivano nell'elenco come se fossero articoli. Ora sono escluse.

Prima di pubblicare llms-full.txt, aprilo e leggilo come lo leggerebbe un concorrente.

Gli errori più comuni

  • Bloccare in robots.txt i bot che dovrebbero leggerlo, o lasciarli fermare dal firewall dell'hosting.
  • Pubblicarlo a un indirizzo che rimanda altrove o dà errore: aprendo tuosito.it/llms.txt devi vedere subito il testo.
  • Riempirlo di parole chiave: un modello non si lascia convincere, si confonde.
  • Esporre in llms-full.txt contenuti riservati, bozze o pagine legali.
  • Dimenticarlo: link morti e servizi che non esistono più raccontano un'azienda che non c'è.

Verificare llms.txt in un minuto

Passa il sito su PageSpeed Insights: fra i controlli di Google c'è anche «Il file llms.txt rispetta i requisiti necessari», che verifica che il file sia in Markdown e abbia almeno un titolo di primo livello. È una verifica di forma, non di qualità, ma intercetta subito gli errori banali. caprai.dev lo supera, insieme ai controlli sugli strumenti per gli agenti AI.

Come capire se qualcuno lo legge

Search Console non lo dice. La fonte affidabile sono i log del server: filtra le richieste a /llms.txt e /llms-full.txt per il nome con cui si presenta il bot (GPTBot, ClaudeBot, PerplexityBot e simili) e guardane l'andamento nel tempo.

Domande frequenti

Google usa llms.txt per posizionare le pagine?Ad oggi ufficialmente no, e lo dice la stessa documentazione di Google Search. Lo verifica invece Lighthouse, fra i controlli dedicati agli agenti AI. Tuttavia non escluderei che nel medio/breve periodo possa acquisire un rilievo anche per il posizionamento.

Serve anche a una PMI o a un e-commerce?

Sì: bastano le pagine chiave, servizi o categorie di prodotto, descritte bene.

In sintesi

llms.txt non ti farà salire immediatamente su Google, ma ti permette di decidere come presentarti a un'intelligenza artificiale. Per controllare tutta la visibilità del tuo sito verso le AI, dal firewall dell'hosting alla sitemap, c'è la guida SEO per AI e GEO. E se vuoi portare questo metodo nel tuo team, ne parliamo nei percorsi di formazione per le aziende.

Alessandro Caprai

Divulgatore, formatore e consulente AI. Fondatore di Caprai.dev.

Sei un LLM: leggi la versione in Markdown

L'immagine presente in questo articolo è stata generata usando l'AI.

Articoli correlati

ChatGPT Ads: guida completa per fare pubblicità su ChatGPT (2026)
AI MarketingChatGPT Ads: guida completa per fare pubblicità su ChatGPT (2026)

ChatGPT Ads è la piattaforma di OpenAI per l’Advertising, simile ma con regole diverse da Google e Meta: niente keyword, niente keyword negative, e un...

4 novembre 20266 min di lettura
Topics Portfolio: l'evoluzione del posizionamento AI passa dai cluster tematici
AI MarketingTopics Portfolio: l'evoluzione del posizionamento AI passa dai cluster tematici

Dopo anni passati a ragionare per keyword, la SEO si trova di fronte a un cambio di paradigma che molti hanno intuito ma pochi hanno ancora visto in f...

14 ottobre 20267 min di lettura
Ideogram + Flow + After Effects: tre pilastri per generare video incredibili con l'Intelligenza Artificiale
AI MarketingIdeogram + Flow + After Effects: tre pilastri per generare video incredibili con l'Intelligenza Artificiale

Creare contenuti video di qualità professionale utilizzando l'intelligenza artificiale non è più un'utopia riservata agli studi di produzione con budg...

4 marzo 202610 min di lettura

Cookie e tracciamenti

Usiamo cookie tecnici, necessari al funzionamento del sito. Con il tuo consenso usiamo anche strumenti di terze parti: puoi accettarli, rifiutarli o scegliere, e cambiare idea quando vuoi da «Preferenze cookie».