llms.txt: cos'è, come si scrive e a cosa serve davvero

In Italia “llms txt” conta circa 590 ricerche al mese su Google (nostra analisi: volumi medi mensili di ricerca su Google, Italia, ultimi 12 mesi). Dietro la curiosità c'è una domanda pratica: serve davvero un file per «parlare» ai modelli linguistici, o è l'ennesima moda? Qui trovi com'è fatto il formato, come si scrive, chi lo legge oggi (con le dichiarazioni di Google) e in quali casi ha senso pubblicarlo.

Cos'è llms.txt#

llms.txt è un file di testo in Markdown, pubblicato nella radice di un sito (/llms.txt), che elenca con link e brevi descrizioni i contenuti più utili per un modello linguistico. La proposta è di Jeremy Howard (Answer.AI) e porta la data del 3 settembre 2024 (Answer.AI, “/llms.txt: a proposal to provide information to help LLMs use websites”). La motivazione: un modello ha una finestra di contesto limitata e le pagine web, piene di menu, script e pubblicità, sono un materiale scomodo da leggere. Chi gestisce il sito sa quali pagine contano e può indicarle, invece di lasciare che sia lo strumento a indovinare.

Non è uno standard ufficiale di un ente come l'IETF o il W3C: è una convenzione proposta da un singolo autore, descritta sul sito llmstxt.org. Anche la documentazione di Chrome la definisce «optional at the moment» (vedi più sotto).

Il formato esatto#

Secondo la specifica su llmstxt.org, il file è Markdown e contiene, in quest'ordine:

1. un titolo H1 con il nome del progetto o del sito: è l'unica parte obbligatoria;
2. un blockquote (>) con un riassunto breve;
3. zero o più paragrafi o elenchi di dettaglio, di qualsiasi tipo Markdown tranne i titoli;
4. zero o più sezioni H2, ciascuna con un elenco di link nella forma - [nome](url), seguita facoltativamente da due punti e da una nota.

Una sezione H2 chiamata “Optional” ha un significato speciale: per convenzione contiene informazioni secondarie, che un agente può saltare quando ha bisogno di meno contesto. Lo schema che propone la specifica è questo:

# Titolo

> Descrizione facoltativa

Dettagli facoltativi

## Nome sezione

- [Titolo link](https://esempio.it/pagina): nota facoltativa

## Optional

- [Titolo link](https://esempio.it/altra-pagina)

La specifica dice anche che il file può stare nella radice o in un percorso qualsiasi del sito e vale per le pagine sotto quel percorso; se ne esistono più d'uno, un agente dovrebbe usare il più specifico.

llms-full.txt e le versioni .md delle pagine#

Alla specifica si affiancano due convenzioni. La prima, descritta su llmstxt.org, riguarda le singole pagine: ognuna può avere una versione Markdown pulita allo stesso indirizzo, con .md aggiunto all'URL (pagina.html.md) o al posto dell'estensione (pagina.md); per gli URL senza nome di file si usa index.html.md. Per far trovare queste versioni si possono usare i link rel="alternate" type="text/markdown" nell'HTML o nell'header HTTP Link.

La seconda è llms-full.txt: un file che, invece di elencare link, contiene direttamente il testo completo delle pagine. Non fa parte della specifica pubblicata su llmstxt.org: è una prassi diffusa tra chi pubblica documentazione. Ha senso quando il testo complessivo è abbastanza breve da stare in una finestra di contesto, e meno quando è enorme.

Differenza con robots.txt e sitemap.xml#

I tre file sembrano parenti, ma fanno lavori diversi:

Il punto da fissare è che llms.txt non blocca e non autorizza niente. Se vuoi impedire a un crawler di accedere a un percorso, la sede è robots.txt, e anche lì l'RFC 9309 precisa che «these rules are not a form of access authorization»: non sono un controllo degli accessi. Per decidere chi può leggere cosa, in particolare per i crawler delle aziende di intelligenza artificiale, trovi il quadro in GPTBot e il crawler di OpenAI. Sulla sitemap, che invece serve alla scoperta degli URL, c'è la guida alle sitemap.

Chi lo legge davvero oggi#

È la parte su cui conviene essere precisi, perché in giro si trovano promesse che nessuna fonte ufficiale conferma.

Google Ricerca lo ignora#

La guida di Google all'ottimizzazione per la Ricerca con funzioni di intelligenza artificiale (aggiornata il 10 luglio 2026) dice che non occorre creare «nuovi file leggibili dalle macchine, file di testo per l'AI, markup o Markdown» per comparire in Google Ricerca. Aggiunge che pubblicare file LLMS.txt o simili è lecito, ma «will neither harm nor help your site's visibility or rankings in Google Search, as Google Search ignores them», e nei passi successivi elenca tra le cose da non fare la creazione di «unnecessary AI text files (like llms.txt)» (Google Search Central, “AI optimization guide”). Questo vale per la Ricerca e per le sue funzioni AI, come le AI Overview e AI Mode: pubblicare il file non migliora né peggiora la visibilità.

La stessa linea l'ha espressa John Mueller di Google nel podcast Search Off the Record: un sistema basato su LLM non può usare llms.txt per distinguere un sito da un altro, perché per come è fatto non può fidarsi di ciò che il sito dichiara su di sé. Vede al massimo un ruolo ristretto, quando un agente è già dentro il sito (Search Engine Journal, 15 giugno 2026).

Strumenti e agenti: su richiesta, non per scoperta#

Dove il file è utile è nell'uso diretto. Un assistente di programmazione o un agente a cui indichi un indirizzo può leggere llms.txt e seguire i link per recuperare la documentazione giusta: è il caso d'uso da cui nasce la proposta. Su questo non esiste però un elenco ufficiale di chi lo legge e quanto: la specifica non lo fornisce, e noi non citiamo numeri di adozione che non siamo in grado di verificare. Chrome, dal canto suo, ha inserito in Lighthouse un controllo sul file, che segnala solo l'errore del server e restituisce «non applicabile» se il file risponde 404, perché lo considera «optional at the moment» (Chrome for Developers, “llms.txt” (Lighthouse)). Il controllo non dice nulla sul posizionamento.

Chi lo pubblica#

Lo pubblicano soprattutto siti di documentazione. La documentazione per sviluppatori di Anthropic, per esempio, ha un proprio file (platform.claude.com/llms.txt; l'indirizzo docs.anthropic.com/llms.txt rimanda lì): con un titolo H1, sezioni per lingua e, più in basso, elenchi di link con descrizione. Il suo formato si discosta in parte dalla specifica (per esempio non apre con il blockquote), segno di quanto la convenzione sia usata in modo libero.

Quando conviene e quando è inutile#

Ha senso pensarci se:

• pubblichi documentazione tecnica, API o guide per sviluppatori, che chi usa un assistente di programmazione vuole far leggere al modello;
• hai un sito con molte pagine e una struttura non evidente, in cui un indice ragionato aiuta un agente a orientarsi;
• vendi un prodotto software e vuoi che gli agenti trovino le pagine corrette (prezzi, limiti, istruzioni) invece di una pagina vecchia.

È di scarsa utilità se il sito è piccolo e già ben linkato, se il motivo è «salire nei risultati di Google» (la guida di Google dice in chiaro che non succede) o se manca il resto: contenuti chiari, scansionabili, con informazioni verificabili. Per capire come si ragiona sulla visibilità nei motori generativi, il punto di partenza sono i contenuti, come spieghiamo in Generative Engine Optimization e nella guida alla ricerca con intelligenza artificiale.

Come scriverlo passo passo#

1. Scegli le pagine. Parti da quelle che un lettore (umano o automatico) deve conoscere per capire cosa fai e usare il prodotto: non tutte le URL, una selezione.
2. Scrivi H1 e blockquote. Nome del sito e due frasi che dicono chi sei, cosa offri e per chi.
3. Raggruppa in sezioni H2. Nomi che descrivono il contenuto (“Prodotti”, “Guide”, “Assistenza”).
4. Una riga per link. Titolo chiaro, URL assoluto, una nota che dice cosa trovi nella pagina.
5. Metti il secondario in “Optional”. Archivio, note legali, pagine utili ma non essenziali.
6. Usa URL che rispondono 200. Niente redirect, niente pagine rimosse.

Un esempio: ecco un llms.txt per un'azienda ipotetica, “Rossi Serramenti”, inventata a scopo illustrativo.

# Rossi Serramenti

> Azienda ipotetica che produce e installa finestre in PVC e alluminio per privati e imprese edili. Questo file elenca le pagine da consultare per catalogo, prezzi indicativi e assistenza.

I prezzi sono indicativi e dipendono da misure e finiture. Per i preventivi vale solo la pagina Contatti.

## Prodotti

- [Finestre in PVC](https://www.esempio.it/prodotti/finestre-pvc): caratteristiche, finiture e prestazioni dichiarate
- [Finestre in alluminio](https://www.esempio.it/prodotti/finestre-alluminio): serie disponibili e dimensioni massime

## Guide

- [Come misurare una finestra](https://www.esempio.it/guide/misurare-finestra): istruzioni passo passo
- [Detrazioni e incentivi](https://www.esempio.it/guide/detrazioni): panoramica aggiornata, con le fonti ufficiali

## Assistenza

- [Garanzia e manutenzione](https://www.esempio.it/assistenza/garanzia): durata, condizioni, come richiederla
- [Contatti](https://www.esempio.it/contatti): sede, telefono, richiesta di preventivo

## Optional

- [Storia dell'azienda](https://www.esempio.it/chi-siamo)
- [Informativa privacy](https://www.esempio.it/privacy)

Dove pubblicarlo, codifica e tipo MIME#

Il file va alla radice del dominio, all'indirizzo https://www.tuosito.it/llms.txt, in chiaro e raggiungibile senza login. La specifica ammette anche un llms.txt in un percorso più profondo, valido per le pagine sotto quel percorso. La codifica sensata è UTF-8, che permette accenti e simboli nei titoli: la specifica prevede un BOM facoltativo, ma di solito non serve.

Sul tipo MIME la specifica non impone nulla. Nella pratica si serve come testo semplice con codifica dichiarata, cioè Content-Type: text/plain; charset=utf-8; l'importante è che il server risponda 200 e che il contenuto si legga come testo, non come una pagina HTML con una grafica attorno.

Come controllare che funzioni#

• Apri l'indirizzo nel browser e verifica che si veda testo semplice, non una pagina del sito.
• Da terminale, curl -I https://www.tuosito.it/llms.txt mostra codice di stato e header: cerca 200 e il tipo di contenuto.
• Controlla ogni link dell'elenco: devono rispondere 200, senza catene di redirect.
• Rileggi il file con lo schema della specifica: un solo H1, un blockquote, sezioni H2 con elenchi di link.
• Lighthouse in Chrome segnala se il server risponde con un errore al file; un 404 viene trattato come «non applicabile».

Errori comuni#

• Aspettarsi un effetto sul posizionamento. Per Google Ricerca non c'è, come visto.
• Usarlo come robots.txt. Mettere regole di blocco in llms.txt non ferma nessun crawler.
• Elencare tutte le URL. Un indice che ricopia la sitemap perde il suo scopo, che è la selezione.
• Link rotti o con redirect. Il file invecchia in fretta se non è generato dai contenuti.
• Promesse nel riassunto. Il blockquote descrive, non fa pubblicità: un testo promozionale non aiuta chi legge.
• Contenuti nascosti. Scrivere nel file cose che le pagine non dicono è l'errore peggiore: un agente che trova incoerenze smette di fidarsi.

Come lo pubblichiamo noi#

Anche seo.srl pubblica un llms.txt e un llms-full.txt, entrambi generati a ogni richiesta dai contenuti, come la sitemap, così restano allineati alle pagine. Il primo ha il nome del sito come H1, un blockquote di sintesi e sezioni H2 per guide, altri articoli, news, servizi e pagine, con una riga e una descrizione per voce; il secondo riporta il testo completo di pagine, servizi e articoli in Markdown, con titolo, URL, date e domande frequenti, separati da una linea. Entrambi sono serviti come text/plain; charset=utf-8, con cache di un'ora. Facciamo SEO dal 2009 e lo trattiamo per quel che è: un indice ordinato, non una leva di posizionamento.

Il passo successivo#

Se vuoi sapere se il tuo sito ha problemi più urgenti di un file per gli LLM (scansione, indicizzazione, struttura), richiedi l'audit SEO gratuito.