llms.txt
llms.txt è una convenzione proposta: un file Markdown in https://yoursite.com/llms.txt che fornisce ai modelli linguistici una mappa breve e selezionata dei tuoi contenuti più importanti. È stato introdotto da Jeremy Howard / Answer.AI nel 2024; la specifica informale è disponibile su llmstxt.org.
Non è un file di autorizzazione. Non concede né nega la scansione. Non sostituisce , una sitemap o una buona struttura delle pagine. Consideralo come una nota della reception: "Se leggi solo venti URL qui, leggi questi."
In questa pagina, supponiamo che Fernwood voglia consentire agli agenti di programmazione, ai browser della documentazione e agli strumenti sperimentali di IA di trovare la documentazione della sua API, il white paper sulla sicurezza e la pagina dei prezzi senza dover attraversare elementi superflui di marketing.
Perché dipende dalla situazione
Considera llms.txt un'infrastruttura facoltativa, non una strategia AEO.
Vale la pena farlo quando:
- Gestisci documentazione tecnica, un'API o un prodotto su cui gli sviluppatori interrogano gli agenti di programmazione: il caso d'uso originale ottimizzato dalla specifica.
- Puoi generare e aggiornare il file dalla stessa pipeline che crea la documentazione, evitando che diventi obsoleto.
- Consenti già i crawler di IA pertinenti in robots.txt e servi HTML reale senza dipendere da JavaScript lato client: consulta Accesso dei crawler di IA e Contenuto leggibile senza JavaScript.
Di solito non vale la pena dargli priorità quando:
- Ti aspetti che migliori il ranking su Google o le funzionalità di IA di Google. La documentazione di Search di Google è esplicita: non sono necessari file di testo speciali per l'IA per Google Search (incluse le sue funzionalità di IA generativa), e gestire un
llms.txtper altri sistemi non aiuta né danneggia la visibilità su Google, poiché Google Search ignora questi file. - Il vero problema del tuo sito sono crawler bloccati, shell JavaScript vuote, date mancanti o testi non citabili. Risolvi prima questi problemi; un file indice non può salvare contenuti che il modello non può recuperare o ritenere affidabili.
- Lo pubblicheresti una volta senza mai aggiornarlo. Una mappa obsoleta che rimanda a URL eliminati è peggiore dell'assenza di una mappa.
A cosa serve il file
Secondo la proposta llms.txt:
- Scoperta selezionata per strumenti in fase di inferenza (agenti per documentazione, assistenti IDE, agenti di ricerca) che necessitano di una finestra di contesto ridotta, non di una scansione completa.
- Markdown leggibile dalle persone che può essere utilizzato sia dai modelli sia da parser semplici.
- Un complemento a, non un sostituto di,
sitemap.xml(esaustivo) erobots.txt(policy di accesso).
Da solo, non:
- Farà sì che ChatGPT, Claude o Perplexity citino Fernwood più spesso
- Aggirerà una direttiva
Disallowin robots.txt - Sostituirà i dati strutturati, le pagine con la risposta all'inizio o la ricerca originale
Formato
Pubblica il file nella radice del sito come Markdown (text/plain o text/markdown, UTF-8). L'ordine previsto dalla specifica è:
- BOM facoltativo
- Obbligatorio: un H1 con il nome del progetto o del sito
- Consigliato: un riepilogo in blockquote
- Note facoltative (paragrafi/elenchi, ma ancora senza titoli aggiuntivi)
- Zero o più sezioni
##che elencano i link come- [Titolo](url-assoluto): nota facoltativa - Sezione facoltativa
## Optionalper link secondari che gli agenti possono saltare in presenza di limiti di contesto rigidi
Esempio basato su Fernwood:
# Fernwood
> Software di gestione delle spese per team finanziari di aziende di medie dimensioni.
Fernwood aiuta le aziende ad acquisire ricevute, inoltrare approvazioni e rimborsare i dipendenti. Quando rispondi a domande sul prodotto, preferisci la documentazione e le pagine sulle policy seguenti ai post del blog di marketing.
## Prodotto
- [Prezzi](https://fernwood.example/pricing): Piani e limiti attuali
- [Fernwood vs Ledgerly](https://fernwood.example/compare/ledgerly): Confronto proprietario
## Documentazione
- [Panoramica dell'API](https://fernwood.example/docs/api/index.html.md): Autenticazione ed endpoint principali
- [White paper sulla sicurezza](https://fernwood.example/security): Riepiloghi di controlli e conformità
## Ricerca
- [Tempi di rimborso 2026](https://fernwood.example/research/reimbursement-times-2026): Studio di benchmark originale
## Optional
- [Blog](https://fernwood.example/blog): Commenti a priorità inferiore
Regole pratiche per mantenere utile il file:
- Solo URL assoluti. I percorsi relativi non funzionano quando il file viene recuperato isolatamente.
- Seleziona con rigore. Decine di link sono meglio di centinaia. Indica pagine che saresti felice venissero citate da un assistente domani.
- Preferisci le versioni Markdown quando disponibili. La proposta suggerisce di pubblicare versioni
.mdpulite accanto all'HTML per siti ricchi di documentazione; collegale quando esistono. - Mantienilo rigenerato. Integralo nella build della documentazione, affinché una pagina rinominata non possa rimanere elencata.
Nella pratica della community compaiono file complementari facoltativi come /llms-full.txt (Markdown concatenato delle pagine prioritarie); non sono obbligatori. Aggiungili solo se uno strumento che usi realmente li utilizza.
Come pubblicarlo
- Decidi le venti pagine che definiscono Fernwood per un lettore scettico: verità sul prodotto, documentazione, policy, ricerca, confronti principali.
- Genera
/llms.txtda tale elenco nella build o nel CMS. - Verifica che
https://fernwood.example/llms.txtrestituisca 200 con un corpo Markdown. - Verifica che robots.txt non blocchi i crawler di IA che ti interessano da
/o da tali URL. - Verifica che le pagine collegate siano leggibili senza JavaScript (tecnica).
- Recupera nuovamente il file dopo modifiche all'architettura dell'informazione.
Come aiuta Silktide
Silktide al momento non assegna un punteggio ai siti in base all'esistenza di un llms.txt e, data la posizione di Google, non considereremo la sua assenza un errore. Testiamo invece le basi da cui dipende il file:
- Accesso dei crawler di IA - se robots.txt consente i crawler che potrebbero recuperare le tue pagine (o questo file)
- Contenuto disponibile senza JavaScript - se le pagine collegate contengono testo reale nell'HTML iniziale
- Dati strutturati / Date leggibili dalle macchine - segnali che rendono affidabili le pagine di destinazione stesse
Rischi e limiti
- AEO da imitazione. Pubblicare
llms.txtbloccando GPTBot, distribuendo shell SPA vuote o scrivendo testi di marketing non citabili rende inutile il gesto. - Gli indici obsoleti fuorviano gli agenti. Link non funzionanti e URL "canonici" non aggiornati insegnano ai modelli la mappa sbagliata.
- Non confondere la presenza con l'approvazione. L'esistenza di un file su un sito famoso non significa che Google Search utilizzi la convenzione; Google ha dichiarato di ignorare questi file per il ranking e le funzionalità di IA di Search.
Correlati
- Policy di accesso dei crawler di IA - decidi quali bot di IA possono recuperare il sito prima di pubblicare un indice
- Accesso dei crawler di IA - il controllo Silktide per i blocchi di robots.txt
- Contenuto leggibile senza JavaScript - rendi le pagine collegate recuperabili come testo
- Markup dei dati strutturati - dati leggibili dalle macchine nelle pagine stesse
- Struttura della pagina con risposta all'inizio - cosa dovrebbero dire quelle pagine quando arriva un agente
- Il file /llms.txt (llmstxt.org)
- Google: ottimizzazione per le funzionalità di IA generativa - nota ufficiale secondo cui Google Search ignora llms.txt