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

28 ottobre 2026 · Alessandro Caprai, Divulgatore, formatore e consulente AI

<https://caprai.dev/it/ai-marketing/post/guida-file-llms-txt>

---

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](https://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](https://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](https://www.searchenginejournal.com/googles-llms-txt-guidance-depends-on-which-product-you-ask/575431/)). Da maggio, però, Google lo controlla in Lighthouse e in PageSpeed Insights, dentro la nuova categoria **Agentic Browsing** ([DebugBear](https://www.debugbear.com/blog/lighthouse-agentic-browsing)): 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:

```markdown
# 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](/it/intelligenza-artificiale/post/web-agentico-che-cos-e-e-perche-conta-per-il-tuo-sito). 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](https://pagespeed.web.dev/): 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](/it/ai-marketing/post/tutorial-il-tuo-sito-e-visibile-agli-llm). E se vuoi portare questo metodo nel tuo team, ne parliamo nei percorsi di [formazione per le aziende](/it/aziende).
