Validatore llms.txt

Cosa fa llms.txt e cosa non fa

llms.txt è una convenzione Markdown proposta per presentare una panoramica concisa del sito e collegamenti selezionati. Non è una policy per i robot, un accordo di licenza, un controllo di autenticazione o un requisito universale di indicizzazione per l’IA. Il nome del sito in un H1, un riepilogo utile e collegamenti Markdown organizzati aiutano i lettori a comprendere il sito. La proposta non impone una sezione chiamata letteralmente Docs né un riepilogo universale di 150 caratteri. L’adozione varia in base a chi utilizza il file; non affermare che tutti i principali crawler di IA lo leggano.

Pubblica nella radice pubblica senza modificare il sito

Rendi disponibile il file su /llms.txt con una risposta di esito positivo contenente il testo previsto, non una pagina di errore HTML con il tema del sito o una schermata di accesso. Usa la funzionalità per i file pubblici supportata dal tuo CMS, una risorsa statica dell’hosting o una risposta testuale configurata esplicitamente. Se la piattaforma riserva i percorsi della radice, verifica un metodo di pubblicazione ufficialmente supportato prima di aggiungere un plugin o un proxy. Controlla sia il dominio personalizzato sia l’anteprima dell’hosting, perché reindirizzamenti e cache possono comportarsi diversamente.

Scegli un piccolo insieme di pagine di destinazione utili

Collega pagine canoniche stabili: panoramica del prodotto, prezzi, documentazione, condizioni di assistenza e guide importanti. Usa etichette descrittive per i collegamenti e, facoltativamente, un breve contesto, così che il lettore sappia cosa tratta ogni pagina. I collegamenti HTTPS assoluti sono una scelta pratica di pubblicazione, non una prova che quelli relativi causino automaticamente errori HTTP. Escludi dashboard private, bozze di pagine, URL di tracciamento e contenuti obsoleti. Mantieni aggiornate le informazioni collegate e le traduzioni; non elencare una pagina solo per ingrandire il file.

Verifica dopo la pubblicazione e dopo modifiche importanti

Recupera il file pubblicato e controlla corpo della risposta, stato e tipo di contenuto; text/plain con codifica UTF-8 è un’impostazione predefinita ragionevole. Segui i collegamenti di destinazione per confermare che siano pubblici e pertinenti. Dopo l’invalidazione della cache, confronta il file online con la versione che intendevi pubblicare. Un validatore può individuare problemi di formattazione e collegamenti, ma non può dimostrare che un motore abbia letto il file o che una risposta futura citerà il tuo sito.

Interpreta gli avvisi senza confonderli con la specifica

Un validatore locale può consigliare URL assoluti, una sezione di documentazione con un nome specifico o un breve riepilogo come verifiche editoriali. Questi consigli non sono requisiti universali della proposta llms.txt. Controlla il Markdown effettivo e le pagine collegate, e mantieni le preferenze di accesso in robots.txt. Il superamento della validazione significa che le verifiche eseguite non hanno rilevato alcuno dei problemi elencati; non certifica l’adozione da parte dei fornitori, la raggiungibilità dei collegamenti se non testata, la conformità alle licenze o la futura visibilità nelle risposte dell’IA.

Prove e prossime azioni

Lista di controllo per l’implementazione

• Conferma che il tuo CMS supporti il metodo scelto per il percorso pubblico nella radice.
• Usa Markdown, non un modello copiato di robots.txt.
• Descrivi ciò che il sito offre realmente.
• Includi URL pubblici stabili ed etichette chiare.
• Testa il dominio reale dopo la pubblicazione.
• Considera il file un contesto facoltativo, non una garanzia di citazione.

Passo dopo passo

1. 1
   Definisci una base di riferimento

   Salva URL della pagina, data, lingua, mercato di riferimento e domande esatte prima di apportare modifiche. Registra ciò che la pagina dice effettivamente e ciò che ogni risposta testata cita; una menzione senza un collegamento alla fonte non è una citazione.

2. 2
   Apporta una modifica coerente

   Risolvi prima il problema più evidente, poi verifica la pagina pubblicata anziché limitarti all’anteprima nell’editor. Tieni un registro degli interventi per evitare di scambiare restyling, campagne o modifiche al prodotto non correlati per effetti di questo lavoro.

3. 3
   Ripeti e confronta

   Ripeti le stesse domande e verifiche tecniche dopo la pubblicazione. Mantieni costanti motori e condizioni di misurazione, indica la dimensione del campione e valuta l’accuratezza delle risposte insieme alle citazioni. Una singola risposta non rappresenta un posizionamento stabile.