Crea il tuo file llms.txt in pochi clic

llms.txt è un file di testo in formato Markdown che si propone come una sorta di "mappa concisa" per i modelli linguistici di grandi dimensioni (LLM). L’idea, nata dal progetto llmstxt.org, è semplice: invece di lasciare che un agente di intelligenza artificiale analizzi l’intero sito in modo automatico (con il rischio di perdersi tra pagine poco rilevanti o contenuti ridondanti), il proprietario del sito può fornire una selezione curata di link, accompagnati da brevi note esplicative. Il file va posizionato nella root del dominio, esattamente come robots.txt, e viene letto da alcuni strumenti di AI che cercano documentazione o risorse specifiche.

Non si tratta di uno standard ufficiale, ma di una proposta volontaria. Non esiste alcuna garanzia che Google, Bing o altri motori di ricerca tradizionali lo utilizzino per l’indicizzazione, né che i risultati migliorino in termini di posizionamento. Tuttavia, per chi sviluppa API, librerie software o servizi SaaS, llms.txt può rappresentare un modo pratico per guidare gli assistenti di programmazione (come GitHub Copilot o altri strumenti basati su LLM) verso le pagine più utili, come la documentazione ufficiale, le guide rapide o i riferimenti alle policy.

Un esempio concreto: un sito italiano che offre un servizio di fatturazione elettronica potrebbe includere nel proprio llms.txt un link alla pagina delle API con una nota del tipo "Endpoint REST per l’invio delle fatture in formato FatturaPA", aiutando così uno sviluppatore (o un agente AI) a trovare subito ciò che serve senza dover scorrere decine di pagine. Il formato è pensato per essere leggero, leggibile sia dalle macchine che dagli umani, e soprattutto flessibile: spetta a te decidere quali sezioni includere e come descriverle.

Un file llms.txt valido segue una struttura precisa, che il Generatore di llms.txt rispetta alla lettera. Ecco come è organizzato:

1. Titolo principale (H1): la prima riga deve essere un’intestazione di primo livello, ad esempio # Guida API di FatturaElettronica.it. Questo titolo diventa il nome del progetto o del sito.

1. Sommario opzionale (blockquote): subito sotto, puoi aggiungere una breve descrizione racchiusa tra > (come nei commenti di Markdown). Ad esempio: > Servizio di fatturazione elettronica per professionisti e PMI, con API REST e integrazione con il Sistema di Interscambio. Il Generatore di llms.txt limita questa sezione a 300 caratteri per evitare che diventi troppo lunga.

1. Dettagli aggiuntivi (paragrafi): qui puoi inserire informazioni contestuali, come le versioni supportate o le lingue disponibili. Attenzione: se scrivi delle intestazioni (ad esempio # Requisiti), il tool le convertirà in testo normale, perché il formato llms.txt non ammette sottotitoli al di fuori delle sezioni di link.

1. Sezioni di link (H2): ogni sezione inizia con un’intestazione di secondo livello (ad esempio ## Documentazione). Al suo interno, i link vengono elencati con la sintassi - [Titolo della pagina](https://esempio.it/pagina): nota opzionale. La nota è utile per spiegare brevemente il contenuto della pagina, come "Guida all’integrazione con il Sistema di Interscambio" o "Esempi di codice in Python e JavaScript".

1. Sezione "Optional": riservata ai link meno prioritari, che un agente AI potrebbe saltare se lo spazio a disposizione è limitato. Il Generatore di llms.txt aggiunge automaticamente questa sezione, ma solo come ultima del file: se la posizioni altrove, il tool segnala un avviso.

Un esempio pratico di file generato potrebbe essere:

# Servizio di prenotazione online
> Piattaforma per la gestione di appuntamenti medici e servizi professionali.

Supporta prenotazioni in tempo reale e integrazione con Google Calendar.

## Documentazione
- [Guida rapida](https://esempio.it/guida): Istruzioni per iniziare in 5 minuti.
- [API REST](https://esempio.it/api): Endpoint per la gestione delle prenotazioni.

## Esempi
- [Codice di esempio](https://esempio.it/esempi): Script in PHP e Node.js.

## Optional
- [FAQ](https://esempio.it/faq): Domande frequenti.

Il Generatore di llms.txt è uno strumento gratuito che funziona interamente nel browser, senza bisogno di registrazione o upload di dati. Ecco come usarlo passo dopo passo:

1. Inserisci il nome del progetto: nella casella "Nome del sito o progetto", scrivi il titolo che apparirà come H1. Ad esempio, se gestisci un sito di ricette vegane, potresti inserire "RicetteVegane.it - Cucina senza ingredienti animali".

1. Aggiungi un sommario (facoltativo): nella casella "Sommario", scrivi una frase o due che riassumano lo scopo del sito. Il tool ti avviserà se superi i 300 caratteri.

1. Scrivi i dettagli aggiuntivi (facoltativo): qui puoi inserire informazioni come "Versione 2.0, supporto multilingua" o "Aggiornato a 15 maggio 2024". Ricorda che eventuali intestazioni verranno convertite in testo normale.

4. Crea le sezioni di link: per ogni sezione (ad esempio "Documentazione", "Guide", "API"), clicca su "Aggiungi sezione" e inserisci il titolo della sezione. Poi, per ogni link, compila: - Titolo: il testo cliccabile, come "Guida all’installazione". - URL: l’indirizzo completo, ad esempio https://esempio.it/guida. Il tool segnala URL non validi (come quelli senza http:// o https://). - Nota (facoltativa): una breve descrizione, come "Passaggi per configurare il servizio su Linux e Windows".

1. Aggiungi la sezione "Optional": se vuoi includere link secondari, clicca su "Aggiungi sezione Optional". Il tool la posizionerà automaticamente come ultima sezione.

1. Genera e verifica: clicca su "Genera llms.txt" per vedere il risultato. Il Generatore mostra una tabella con eventuali errori (come sezioni vuote o URL mancanti) e avvisi (come la sezione "Optional" fuori posto). Se tutto è corretto, puoi copiare il testo o scaricarlo come file.

1. Pubblica il file: carica il file nella root del tuo sito, assicurandoti che sia accessibile all’indirizzo https://iltuosito.it/llms.txt. Non è necessario modificare il nome del file o aggiungere estensioni particolari: basta llms.txt.

Un buon file llms.txt non è solo una lista di link, ma una guida chiara e mirata per chi (o cosa) lo legge. Ecco alcuni suggerimenti per renderlo davvero utile:

• Sii conciso: il sommario dovrebbe riassumere lo scopo del sito in una o due frasi. Ad esempio, per un sito di consulenza fiscale: > Consulenza personalizzata per professionisti e imprese, con focus su regime forfettario e adempimenti IVA. Evita elenchi di servizi o dettagli tecnici: quelli vanno nelle note dei link.

• Scegli pagine stabili e rilevanti: preferisci link a documentazione ufficiale, guide rapide o pagine di riferimento, piuttosto che articoli di blog o contenuti temporanei. Se il tuo sito è un e-commerce, includi la pagina delle FAQ o quella delle spedizioni, ma non le promozioni del momento.

• Usa note descrittive: invece di limitarti al titolo della pagina, aggiungi una nota che spieghi perché quel link è importante. Ad esempio: - [Documentazione API](https://esempio.it/api): Endpoint per l’invio di fatture elettroniche in formato XML, con esempi in C# e Java.

• Mantieni il file aggiornato: se aggiungi una nuova sezione al sito o modifichi la struttura, aggiorna anche llms.txt. Un file obsoleto può confondere gli agenti AI o indirizzarli verso pagine che non esistono più.

• Limita il numero di sezioni: non serve elencare ogni singola pagina. Concentrati su 3-5 sezioni principali (ad esempio "Documentazione", "Guide", "Esempi") e usa la sezione "Optional" per i link secondari. Ricorda che gli LLM hanno una finestra di contesto limitata: meno è meglio.

• Evita contenuti duplicati: se due pagine trattano lo stesso argomento, scegli quella più completa o aggiornata. Il Generatore di llms.txt segnala sezioni con titoli identici, ma non può sapere se il contenuto è ridondante.

• Pensa agli utenti umani: anche se llms.txt è pensato per le macchine, resta un file di testo leggibile. Usa una sintassi chiara e note che abbiano senso anche per una persona che lo consulta manualmente.

llms.txt è una proposta interessante, ma è importante avere aspettative realistiche. Al momento, non esiste alcuna prova che i principali motori di ricerca (Google, Bing, ecc.) lo utilizzino per migliorare il posizionamento di un sito o per influenzare i risultati di ricerca tradizionali. Non è uno strumento SEO nel senso classico del termine, né sostituisce file come robots.txt o sitemap.xml.

Tuttavia, llms.txt può essere utile in contesti specifici:

• Assistenti di programmazione: strumenti come GitHub Copilot o altri LLM orientati allo sviluppo potrebbero utilizzare llms.txt per trovare rapidamente la documentazione di un’API o di una libreria. Se gestisci un progetto open source o un servizio SaaS, includere un link alla documentazione tecnica con una nota chiara può aiutare gli sviluppatori (umani o artificiali) a trovare ciò che serve.

• Agenti AI per la ricerca di informazioni: alcuni strumenti di intelligenza artificiale progettati per rispondere a domande tecniche o per fornire riassunti di documentazione potrebbero consultare llms.txt per identificare le pagine più rilevanti di un sito. Ad esempio, un agente che cerca informazioni su come integrare un servizio di pagamento online potrebbe preferire un sito che fornisce un llms.txt ben strutturato.

• Siti di documentazione e knowledge base: per progetti come librerie software, framework o servizi con API, llms.txt può fungere da indice curato, simile a un sommario di un libro. In questo caso, il vantaggio non è tanto nel posizionamento, quanto nella facilità con cui un agente AI può orientarsi tra le risorse disponibili.

Cosa non aspettarsi da llms.txt:

• Miglioramenti nel ranking SEO: non ci sono evidenze che Google o altri motori di ricerca utilizzino llms.txt come segnale di ranking. Se il tuo obiettivo è migliorare la visibilità nei risultati di ricerca tradizionali, concentrati su contenuti di qualità, ottimizzazione tecnica e link in entrata.

• Garanzie di citazioni da parte degli LLM: anche se un agente AI legge llms.txt, non è detto che utilizzi i link forniti o che li menzioni nelle risposte. Dipende dall’implementazione specifica dello strumento.

• Sostituzione di robots.txt o sitemap.xml: llms.txt è complementare, non alternativo. robots.txt serve per controllare l’accesso dei crawler (come spiegato nel generatore di robots.txt per AI), mentre sitemap.xml elenca tutte le pagine del sito per l’indicizzazione. llms.txt, invece, offre una selezione curata di link con annotazioni.

In sintesi, llms.txt è uno strumento di nicchia, utile soprattutto per chi vuole ottimizzare la visibilità del proprio sito nei confronti di agenti AI e assistenti di programmazione. Non promette miracoli, ma può essere un’aggiunta intelligente per siti tecnici o di documentazione.

llms.txt, robots.txt e sitemap.xml sono tre file che risiedono nella root di un sito, ma hanno scopi e funzionalità molto diverse. Ecco una panoramica delle differenze e dei casi d’uso per ciascuno:

Quando usare llms.txt? - Se gestisci un sito tecnico, una libreria software o un servizio con API e vuoi guidare gli agenti AI verso le pagine più rilevanti. - Se desideri fornire una selezione curata di link con annotazioni utili, invece di lasciare che un LLM analizzi l’intero sito. - Se il tuo obiettivo è migliorare la visibilità del sito nei confronti di assistenti di programmazione o strumenti di ricerca basati su AI.

Quando usare robots.txt? - Se vuoi controllare quali parti del sito i crawler possono o non possono visitare (ad esempio, per bloccare pagine di amministrazione o contenuti duplicati). - Se desideri gestire il budget di scansione dei motori di ricerca, evitando che sprechino risorse su pagine irrilevanti. - Se hai bisogno di specificare regole diverse per crawler diversi (ad esempio, per i bot di Google e Bing). Il generatore di robots.txt per AI può aiutarti a creare regole specifiche per i crawler di intelligenza artificiale.

Quando usare sitemap.xml? - Se il tuo sito ha molte pagine (ad esempio, un e-commerce con migliaia di prodotti) e vuoi assicurarti che i motori di ricerca le trovino tutte. - Se desideri fornire metadati aggiuntivi sulle pagine, come la data dell’ultima modifica o la frequenza di aggiornamento. - Se hai pagine che non sono facilmente raggiungibili tramite link interni (ad esempio, pagine orfane o contenuti generati dinamicamente).

In molti casi, i tre file possono coesistere e completarsi a vicenda. Ad esempio, un sito di documentazione tecnica potrebbe usare: - robots.txt per bloccare l’accesso alle pagine di test o ai log; - sitemap.xml per elencare tutte le guide e le pagine di riferimento; - llms.txt per fornire una selezione curata delle risorse più importanti, con annotazioni utili per gli agenti AI.

Non esiste una soluzione unica: la scelta dipende dagli obiettivi del sito e dal tipo di pubblico che si vuole raggiungere.

Anche se il formato llms.txt è semplice, è facile commettere errori che rendono il file poco utile o addirittura controproducente. Ecco i più comuni e come evitarli:

1. Sommario troppo lungo o assente: il Generatore di llms.txt limita il sommario a 300 caratteri per un motivo. Un riassunto prolisso perde il suo scopo: deve essere una frase o due che spieghino chiaramente lo scopo del sito. Allo stesso tempo, un sommario vuoto lascia il file senza contesto. Ad esempio, per un sito di ricette, evita frasi come "Benvenuti nel nostro sito di cucina, dove troverete tante ricette deliziose per ogni occasione" e preferisci qualcosa di più diretto: > Ricette tradizionali italiane, con varianti regionali e consigli per intolleranze alimentari.

1. Sezioni vuote o con titoli duplicati: il tool segnala se una sezione non contiene link o se due sezioni hanno lo stesso titolo. Ad esempio, se crei due sezioni intitolate "Documentazione", il Generatore mostrerà un avviso. Meglio differenziare: "Documentazione API" e "Documentazione utente".

1. URL non validi o relativi: llms.txt richiede URL completi, con http:// o https://. Se inserisci /guida invece di https://esempio.it/guida, il tool segnala l’errore. Lo stesso vale per URL con errori di battitura o domini inesistenti.

1. Sezione "Optional" fuori posto: questa sezione deve essere l’ultima del file. Se la posizioni prima di altre sezioni, il Generatore mostra un avviso. Ricorda che gli agenti AI potrebbero saltare i link nella sezione "Optional" se lo spazio a disposizione è limitato, quindi è logico che venga per ultima.

1. Note troppo lunghe o generiche: le note dovrebbero essere brevi e descrittive. Evita frasi come "Clicca qui per saperne di più" e preferisci qualcosa di specifico: "Guida all’integrazione con il Sistema di Interscambio per la fatturazione elettronica."

1. Intestazioni nei dettagli: se inserisci una riga come # Requisiti nella casella dei dettagli, il Generatore la converte in testo normale. Il formato llms.txt non ammette intestazioni al di fuori del titolo principale e delle sezioni di link. Se hai bisogno di organizzare le informazioni, usa paragrafi separati da righe vuote.

1. Link a pagine instabili o temporanee: evita di includere link a pagine di promozioni, articoli di blog con data di scadenza o contenuti che cambiano frequentemente. llms.txt dovrebbe puntare a risorse stabili e rilevanti nel tempo, come la documentazione ufficiale o le guide rapide.

1. File non pubblicato correttamente: dopo aver generato llms.txt, assicurati di caricarlo nella root del sito e che sia accessibile all’indirizzo https://iltuosito.it/llms.txt. Un errore comune è salvarlo con un nome diverso (ad esempio llms.txt.txt) o in una sottodirectory. Il file deve essere servito come testo semplice, senza formattazione HTML.

1. Ignorare gli avvisi del Generatore: il tool mostra una tabella con errori e avvisi. Gli errori (come sezioni vuote o URL mancanti) devono essere corretti, mentre gli avvisi (come la sezione "Optional" fuori posto) sono suggerimenti. Anche se puoi generare il file con avvisi, è meglio risolverli per ottenere un risultato più pulito e utile.

1. Non aggiornare il file: llms.txt non è un documento statico. Se aggiungi nuove sezioni al sito, modifichi la struttura o rimuovi pagine, aggiorna anche il file. Un llms.txt obsoleto può indirizzare gli agenti AI verso risorse che non esistono più o che non sono più rilevanti.