llms.txt Checker
Verifica che il tuo llms.txt esista, rispetti il formato e sia raggiungibile dai crawler AI.
| Parte | Contenuto | Link |
|---|
Cos'è llms.txt?
llms.txt è un semplice file Markdown che sta nella radice di un sito web e ne dà ai modelli AI una breve mappa. Indica il nome del sito, dice in una riga cos'è il sito e rimanda alle pagine che lo spiegano meglio.
L'idea nasce da un problema semplice. Un modello linguistico può leggere solo una certa quantità di testo alla volta, e una normale pagina web è fatta in gran parte di navigazione, script e layout. llms.txt consegna al modello un elenco pulito delle pagine che contano, in un formato che legge con facilità.
Cosa va nel file
Quattro cose, in quest'ordine: il nome del sito, un breve riepilogo, le informazioni di contesto che servono prima a chi legge, e gruppi di link. Ogni link può avere una nota che dice di cosa parla la pagina. Il formato è tutto qui. Non contiene codice né impostazioni, solo testo che anche una persona può leggere.
Da dove viene l'idea
Il formato è pubblicato su llmstxt.org come proposta aperta. Nessun ente di standardizzazione lo sostiene e nessuno è tenuto a supportarlo, ed è per questo che la domanda su chi legge il file conta più del formato stesso.
Chi lo usa oggi
Soprattutto la documentazione. Le aziende di software pubblicano un llms.txt perché gli strumenti di programmazione e gli agenti trovino la pagina giusta della documentazione senza scansionare tutto il sito. C'è anche chi incolla il file in una chat per dare a un modello tutto il contesto in una volta. Se i grandi assistenti lo leggano di propria iniziativa è un'altra questione, trattata più in basso in questa pagina.
Cosa controlla questo llms.txt checker
Che il file esista. Deve aprirsi su /llms.txt nel tuo host e tornare come testo. Un reindirizzamento alla homepage o una pagina di errore non contano.
Che il formato sia valido. Un titolo, un riepilogo, le sezioni e i link scritti come il formato prevede. Ogni problema viene elencato con il suo numero di riga. È la parte di validazione di llms.txt.
Che i crawler AI possano raggiungerlo. Il checker legge il tuo robots.txt e ti dice se a qualche crawler di ricerca o AI viene detto di stare lontano da /llms.txt. Un file che nessuno può scaricare non serve a nulla.
Se c'è llms-full.txt. È facoltativo, e il risultato ti dice se ne hai uno.
Ottieni anche la struttura del file: il titolo, il riepilogo e ogni sezione con il numero di link che contiene. Una volta scaricato il file, i controlli avvengono nel tuo browser. Un file che incolli o modifichi non lascia mai la pagina.
Il formato llms.txt, con un esempio
Il file è normale Markdown con un ordine fisso. Solo il titolo è obbligatorio.
# Acme Analytics
> Acme Analytics è uno strumento di web analytics per negozi online. Traccia visite, ordini e ricavi senza cookie.
Il prezzo è per sito. Tutti i piani includono l'API.
## Documentazione
- [Primi passi](https://acme.example/docs/start): installa lo script e guarda i primi dati
- [Riferimento API](https://acme.example/docs/api): tutti gli endpoint con esempi
## Prodotto
- [Prezzi](https://acme.example/pricing): i piani e cosa include ciascuno
## Optional
- [Changelog](https://acme.example/changelog): cronologia delle versioniIl titolo
La prima riga è un solo # seguito dal nome del sito o del prodotto. Può essercene uno solo.
Il riepilogo
Una riga che inizia con > subito sotto il titolo. Dice cos'è il sito in una o due frasi. Un modello che non legge altro dovrebbe comunque capire cosa fai.
Testo libero
Paragrafi o elenchi semplici dopo il riepilogo. Usali per i fatti che servono a un modello prima di seguire un link. Qui niente intestazioni.
Sezioni con link
Ogni intestazione ## apre una sezione, e una sezione è un elenco di link. Un link per riga, scritto come - [Title](https://full-url): short note. La nota è facoltativa e vale la pena scriverla, perché dice al modello cosa troverà prima che spenda qualcosa per scaricare la pagina.
La sezione Optional
Una sezione chiamata Optional (cioè facoltativa) ha un significato speciale. Uno strumento con poco spazio a disposizione può saltarla. Mettici le pagine utili ma non indispensabili.
llms.txt vs llms-full.txt
I due file rispondono alla stessa esigenza con dimensioni diverse.
llms.txt è l'indice. È breve, e un modello che vuole di più deve seguire i link. llms-full.txt è il contenuto vero e proprio: il testo completo delle tue pagine principali riunito in un unico file Markdown, così uno strumento può caricare tutto con una sola richiesta.
Il file lungo è nato attorno al formato come convenzione, soprattutto sui siti di documentazione, dove leggere l'intero manuale in una volta è utile. A un sito di marketing con poche pagine serve di rado.
Se li pubblichi entrambi, tienili allineati. Un file lungo che descrive il prodotto dell'anno scorso è peggio di nessun file. Il checker ti dice se /llms-full.txt esiste nel tuo host e considera normale la sua assenza.
llms.txt funziona davvero?
La risposta onesta ha due parti.
Nessun grande assistente AI ha confermato di leggere llms.txt quando risponde a una domanda. Se aggiungi il file e ti aspetti che ChatGPT o Gemini inizino a citarti per questo, nulla lo conferma.
Il file viene usato altrove. Gli strumenti di programmazione lo leggono per imparare la documentazione di una libreria. Gli agenti lo aprono quando qualcuno indica loro un sito. Le persone lo incollano in una chat per dare a un modello tutto il contesto in una volta. Per un prodotto con una documentazione, questo è un uso reale già oggi.
Consideralo quindi un'aggiunta piccola ed economica. Si scrive in un'ora e mantenerlo non costa nulla. Non sostituisce il lavoro che decide se gli assistenti ti nominano, cioè meritare di essere citato ed essere menzionato sui siti di cui già si fidano.
llms.txt vs robots.txt vs sitemap.xml
I tre file stanno uno accanto all'altro nella radice di un sito e fanno lavori diversi.
| File | Cosa fa | Chi lo legge | Può bloccare l'accesso? |
|---|---|---|---|
robots.txt | Dice ai crawler quali URL possono scaricare | Crawler di ricerca e AI | Sì, per i crawler che lo rispettano |
sitemap.xml | Elenca ogni URL che vuoi far trovare | Motori di ricerca | No |
llms.txt | Indica ai modelli AI le poche pagine che spiegano il sito | Strumenti e agenti che scelgono di farlo | No |
L'errore più comune è aspettarsi che llms.txt controlli qualcosa. Non può tenere fuori un crawler e non può farlo entrare. Se il robots.txt blocca a un crawler le tue pagine, elencarle in llms.txt non cambia nulla. Controlla cosa dice il tuo file a ciascun crawler con il Robots.txt Tester.
Come creare un file llms.txt
- Scegli le pagine. Prendi quelle che spiegano cosa fai: la pagina del prodotto, i prezzi, la documentazione principale, la pagina che risponde alla domanda che ricevi più spesso. Lascia fuori tutto il resto.
- Scrivi il titolo e il riepilogo. Il nome sulla prima riga, poi una o due frasi sotto
>che anche un estraneo capirebbe. - Raggruppa i link. Dai a ogni gruppo un'intestazione
##ed elenca le pagine con URL completi e una breve nota ciascuna. - Salvalo come
llms.txtnella radice. Deve aprirsi suyoursite.com/llms.txtcome testo semplice. - Controllalo. Incolla la bozza nel checker prima di pubblicarla, poi verifica l'indirizzo reale quando il file è online.
Se puoi, scrivilo a mano. Un file generato dalla sitemap elenca tutto, e un elenco di tutto è il contrario di ciò a cui serve il formato.
Best practice per llms.txt
Scrivi un riepilogo che spiega, non uno slogan. "Il modo più veloce per crescere" non dice nulla a un modello. "Uno strumento di prenotazione per studi dentistici" sì.
Tieni l'elenco breve. Scegli le pagine che manderesti a qualcuno che non ti ha mai sentito nominare. Se non sai decidere tra due pagine, la più debole va sotto Optional.
Descrivi ogni link. La nota dopo i due punti è ciò che un modello usa per decidere se vale la pena aprire la pagina.
Usa indirizzi completi. Ogni link inizia con https:// e punta all'URL finale, non a un reindirizzamento.
Rimanda a pagine che si leggono bene come testo. Una pagina che mostra il suo contenuto senza script e senza login è quella che un modello può usare.
Aggiornalo quando il sito cambia. Link morti e prezzi vecchi in questo file fanno più danni di un file mancante.
Lascialo aperto nel robots.txt. Il file è utile solo ai crawler a cui è permesso scaricarlo.
Errori comuni in llms.txt
Il file non è nella radice. /docs/llms.txt o /static/llms.txt non è dove gli strumenti cercano.
L'indirizzo restituisce la homepage. Molti siti rispondono a qualsiasi URL sconosciuto con una pagina invece che con un errore. Sembra che il file esista, e invece no.
Nessun titolo, oppure due. Il file inizia con una sola riga #. Tutto ciò che viene sotto usa ##.
Link relativi. /pricing non significa nulla per uno strumento che ha ricevuto il file da un'altra parte. Usa l'indirizzo completo.
Tutte le pagine del sito. Un elenco lungo vanifica lo scopo. Il valore sta in ciò che lasci fuori.
Il robots.txt blocca il file. Un Disallow ampio può coprire /llms.txt senza che nessuno lo volesse.
Link a pagine che un modello non può leggere. Se la pagina richiede un login o costruisce il suo contenuto con gli script, il link non porta a nulla di utile.
Domande frequenti
Cos'è llms.txt?
llms.txt è un semplice file Markdown nella radice di un sito web che dà ai modelli AI una breve mappa del sito. Indica il nome del sito, dice in una riga cos'è e rimanda alle pagine che vale la pena leggere. È un formato proposto, non uno standard web ufficiale.
Dove va messo il file llms.txt?
Nella radice dell'host, in modo che si apra su yoursite.com/llms.txt. Un file in una sottocartella non viene trovato dagli strumenti che lo cercano. Ogni sottodominio ha bisogno del proprio.
Come faccio a verificare il mio llms.txt?
Inserisci il tuo sito nel checker qui sopra. Scarica il file e ti dice se esiste, se il formato è valido e se il tuo robots.txt tiene i crawler AI lontani dal file. Per controllare una bozza, incollala.
ChatGPT, Claude e Gemini usano llms.txt?
Nessun grande assistente ha confermato di leggere llms.txt quando risponde a una domanda. Oggi il file è usato dagli strumenti di programmazione, dagli agenti a cui viene indicato e dalle persone che lo incollano in una chat. Consideralo un'aggiunta a basso costo, non una leva per il posizionamento.
llms.txt è la stessa cosa del robots.txt?
No. Il robots.txt dice ai crawler dove possono andare. llms.txt elenca le pagine che vorresti far leggere ai modelli AI. Non consente e non blocca nulla, quindi una pagina che vuoi tenere fuori ha comunque bisogno di una regola nel robots.txt.
Cos'è llms-full.txt?
Un file complementare che contiene il testo completo delle tue pagine principali in un unico documento Markdown. llms.txt è l'indice breve con i link, llms-full.txt è l'intero contenuto. È facoltativo.
llms.txt aiuta la SEO?
Su Google no. Il posizionamento nella ricerca non lo usa. Il suo unico effetto possibile riguarda gli strumenti e gli agenti che scelgono di leggerlo, e il file non sostituisce nulla di ciò che fai già per la ricerca.
Quanto deve essere lungo un file llms.txt?
Breve. È un indice, quindi elenca le pagine che spiegano meglio il tuo prodotto e lascia fuori il resto. Se una sezione è utile ma non necessaria, mettila sotto un'intestazione chiamata Optional, che gli strumenti possono saltare.
Mi serve un llms.txt generator?
No. Il file è abbastanza breve da scriverlo a mano, e un elenco scelto a mano batte uno generato. La maggior parte dei generatori copia la sitemap, che elenca ogni pagina. Se ne usi uno, riduci il risultato alle pagine che contano e passalo nel checker.
Come aggiungo llms.txt a un sito WordPress?
Diversi plugin SEO possono creare il file a partire dalle tue impostazioni. Senza plugin, carica un file chiamato llms.txt nella cartella principale del sito, accanto a robots.txt. Poi avvia il checker per confermare che si apra su /llms.txt.
Un llms.txt pulito dice a un modello dove guardare. Se poi gli assistenti nominano il tuo brand quando qualcuno chiede è un'altra domanda, e a quella risponde il controllo AI Visibility.