llms.txt: cos'è e se conviene usarlo

llms.txt è un file Markdown che dà agli strumenti AI una breve mappa del tuo sito. Cosa contiene, cosa fa e non fa, e quando vale l'ora di lavoro.

Di Denis Veisllari

llms.txt è un semplice file Markdown nella root del sito (/llms.txt) che dice agli strumenti AI cos'è il tuo sito e quali pagine contano di più, con un link e una riga per ciascuna. È stato proposto nel 2024 come convenzione, non come standard. Aiuta gli agenti di coding e gli assistenti AI a leggere la documentazione. Non è un modo dimostrato per essere citati in ChatGPT, Gemini o nelle AI Overviews di Google, perché nessuno dei principali motori di risposta ha dichiarato di usare il file per scegliere le fonti.

Quindi, in breve: aggiungilo se hai documentazione, un'API o un prodotto che le persone usano tramite agenti AI. Richiede circa un'ora e non costa nulla. Non aspettarti che da solo cambi la tua visibilità AI.

Com'è fatto il file

Il formato proposto è Markdown semplice:

# Your Product

> One or two sentences on what the product is and who it is for.

Optional paragraph with context an AI tool needs, such as pricing model or key terms.

## Docs

- [Getting started](https://example.com/docs/start): install and first project
- [API reference](https://example.com/docs/api): every endpoint with examples

## Optional

- [Changelog](https://example.com/changelog)

Gli elementi:

  • Un H1 con il nome. L'unica parte obbligatoria.
  • Un riepilogo in blockquote. Cos'è, in una o due frasi.
  • Sezioni di link, ciascuno con una breve nota su cosa tratta la pagina.
  • Una sezione "Optional" per le pagine che uno strumento può saltare quando ha poco spazio.

Alcuni siti pubblicano anche llms-full.txt, un unico file con il testo completo della documentazione, così uno strumento può caricare tutto con una sola richiesta.

Cosa fa

  • Dà agli agenti una mappa di partenza. Quando un agente di coding o un assistente con navigazione web viene indirizzato al tuo sito, un elenco pulito delle pagine giuste è meglio che scorrere menu di navigazione e banner dei cookie.
  • Risparmia contesto. Link Markdown con una riga ciascuno sono molto più corti delle pagine HTML, quindi un agente può leggere più cose che contano.
  • Ti fa scegliere cosa è canonico. Decidi tu quali pagine descrivono il prodotto, invece di lasciare che uno strumento indovini partendo da vecchi articoli del blog.

Cosa non fa

  • Non è un fattore di ranking. Google ha detto che le sue funzioni AI si basano sui normali sistemi della Ricerca e che non servono file speciali. OpenAI, Anthropic e Perplexity non hanno detto che i loro motori di risposta leggono llms.txt quando scelgono cosa citare.
  • Non sostituisce l'accesso. Se robots.txt blocca OAI-SearchBot, GPTBot, PerplexityBot o Googlebot, un elenco di link non servirà.
  • Non sostituisce le pagine. Una risposta AI cita la pagina che risponde alla domanda. Se quella pagina non esiste, non puoi linkarla.

Potresti leggere che una grossa fetta di siti ormai usa llms.txt, o che ha fatto crescere il traffico AI di qualcuno. Prendile con cautela. I conteggi sull'adozione variano a seconda di chi ha fatto il crawl, e un cambiamento di traffico dopo l'aggiunta del file di solito ha altre cause.

Dovresti aggiungerlo?

Il tuo sitoNe vale la pena?
Documentazione per sviluppatori, API, SDK o server MCPSì. Gli agenti li leggono direttamente e ne beneficiano di più.
Prodotto SaaS con documentazione o help centerSì, costa poco. Fallo puntare a configurazione, prezzi e documentazione.
Sito di contenuti o blogFacoltativo. Da solo non cambierà le citazioni.
Attività locale o piccolo sito vetrinaBassa priorità. Dedica il tempo al Profilo dell'attività su Google e alle pagine.

zaDojo pubblica il proprio llms.txt, perché le persone lo configurano tramite agenti AI e quegli agenti devono trovare i passaggi di configurazione.

Come scriverlo in un'ora

  1. Elenca le 10-30 pagine che manderesti a un nuovo cliente: cos'è il prodotto, prezzi, configurazione, la documentazione principale e i confronti.
  2. Scrivi una riga per ciascuna, dicendo cosa troverà il lettore. Fatti semplici, niente slogan.
  3. Raggruppale sotto pochi titoli H2 e metti le pagine non essenziali sotto "Optional".
  4. Salvalo come llms.txt nella root del dominio, servito come testo semplice.
  5. Aprilo in un browser e verifica che ogni link funzioni. Aggiornalo quando aggiungi o rimuovi pagine chiave.

Sii onesto. Se il file dice una cosa e le pagine un'altra, lo strumento legge le pagine.

Cosa sposta davvero la visibilità AI

Se il tuo vero obiettivo è essere nominato nelle risposte AI, questi elementi contano più del file:

  • Pagine che rispondono alle domande degli acquirenti, con la risposta nel primo paragrafo.
  • Pagine di terze parti (liste, recensioni, confronti) che i motori citano già per il tuo argomento.
  • Accesso ai crawler per i bot dietro ogni motore.
  • Misurarla. Monitora le domande a cadenza regolare e guarda chi viene nominato e quali pagine vengono citate. La guida al monitoraggio del tuo brand su ChatGPT spiega come fare.

Domande frequenti

Google usa llms.txt? Google ha detto che AI Overviews e AI Mode lavorano sul suo indice normale e che non serve alcun file AI speciale. Lì conta la SEO normale; vedi come posizionarsi in AI Overviews e AI Mode.

llms.txt è uguale a robots.txt? No. robots.txt dice ai crawler cosa possono scaricare. llms.txt suggerisce cosa vale la pena leggere. Non può consentire né bloccare nulla.

Deve stare nella cartella root? La proposta lo mette in /llms.txt. Alcuni strumenti provano anche altri percorsi, ma la root è il primo posto in cui guardano.

Per il quadro generale, leggi cos'è la GEO e GEO vs SEO vs AEO. zaDojo costa 10 € al mese con 10 € di utilizzo inclusi, e i nuovi account ricevono 0,10 € di crediti di prova senza carta.