File llms.txt

llms.txt è un file Markdown proposto in /llms.txt per guidare i sistemi AI. Google lo ignora, il 97% dei file non riceve alcuna richiesta, e Claude Code è il vero lettore.

Prima pubblicazione: 24 giu 2026 · Ultimo aggiornamento: 13 ago 2026 · Advanced
Lingue
1 segnale di evidenza in questa pagina

llms.txt è una proposta di Jeremy Howard (Answer.AI) per aiutare gli agenti AI a navigare i siti — il 97% dei file pubblicati non riceve alcuna richiesta, Google lo ignora, e Claude Code è il consumatore principale, non i bot di ricerca.

La specifica descrive un riepilogo volontario del sito adatto ai LLM; non stabilisce la conformità dei crawler o il comportamento di indicizzazione. Evidence for this claim llms.txt is a community proposal for a Markdown file at /llms.txt that offers LLM-friendly site information; it is not a web standard. Scope: The proposal's own specification and stated purpose. Confidence: high · Verified: llms.txt proposal OpenAI attualmente documenta bot nominati e impostazioni robots.txt indipendenti. Evidence for this claim OpenAI documents robots.txt controls for its declared crawlers and does not list llms.txt as a crawler control. Scope: OpenAI's published crawler controls; absence is not proof that no internal system ever fetches the file. Confidence: high · Verified: OpenAI: Crawlers

TL;DR — llms.txt è una proposta (Jeremy Howard, Answer.AI, 3 settembre 2024), non uno standard adottato. È un indice Markdown curato in /llms.txt, con un facoltativo /llms-full.txt per il contenuto completo. I bot che la gente spera che lo leggano per la ricerca AI — OAI-SearchBot, PerplexityBot — registrano a malapena; il consumatore dominante è Claude Code e altri agenti di codifica. Google lo ignora (Illyes lo ha confermato; Mueller lo ha paragonato al meta tag delle parole chiave). Nello studio di Ahrefs su 137K siti, il 97% dei file ha ricevuto zero richieste, e SE Ranking ha scoperto che rimuovere llms.txt da un modello di citazione migliorava la sua accuratezza. Vale la pena aggiungerlo per la documentazione per sviluppatori consumata da agenti di codifica; per GEO/AEO su un sito normale, i dati non lo supportano. C’è anche un rischio reale di prompt injection.

Cosa è realmente llms.txt

llms.txt è una proposta — voglio iniziare con quella parola perché è tutta la storia. Non c’è RFC, nessuna benedizione W3C, nessun processo IETF. È un suggerimento ben ragionato di Jeremy Howard (co-fondatore di Answer.AI e fast.ai), pubblicato il 3 settembre 2024, che ha preso piede nel mondo della documentazione per sviluppatori ed è stato innestato nella SEO da una community affamata di una scorciatoia per la visibilità AI.

Il problema di design che affronta è legittimo. Come dice la specifica, “Large language models increasingly rely on website information, but face a critical limitation: context windows are too small to handle most websites in their entirety.” (traduzione) «I modelli linguistici di grandi dimensioni si affidano sempre più alle informazioni dei siti web, ma affrontano una limitazione critica: le finestre di contesto sono troppo piccole per gestire la maggior parte dei siti web nella loro interezza». E convertire HTML in testo pulito e adatto agli LLM è, secondo le parole della specifica, “difficult and imprecise.” (traduzione) «difficile e impreciso». La soluzione di Howard è lasciare che l’autore del sito appiattisca preventivamente il contenuto che vuole che i modelli vedano in Markdown curato.

Il formato

/llms.txt è un documento Markdown ordinato:

  1. H1 (obbligatorio) — nome del progetto o del sito.
  2. Blockquote — un breve riepilogo con le informazioni chiave.
  3. Prosa/elenchi facoltativi — paragrafi o elenchi puntati, ma nessuna intestazione qui.
  4. Elenchi di link delimitati da H2- [name](url): optional notes.
  5. Una sezione ## Optional — link secondari che un modello può saltare quando il contesto è limitato.

Un esempio minimale, dalla specifica:

# FastHTML

> FastHTML is a python library which brings together Starlette, Uvicorn, HTMX,
> and fastcore's FT...

## Docs

- [FastHTML quick start](url): A brief overview of many features

## Optional

- [Starlette documentation](url): A subset useful for FastHTML development.

Esistono due convenzioni complementari:

  • /llms-full.txt — l’intero contenuto del sito appiattito in un unico file Markdown. Anthropic, Perplexity e Stripe pubblicano sia questo che la forma breve.
  • La convenzione URL .md — offrire versioni page.md delle singole pagine così che siano pronte per gli LLM senza il dump completo.

Una variante più recente salta completamente i file statici: Markdown servito al edge tramite content negotiation. Il Markdown for Agents di Cloudflare converte qualsiasi pagina HTML in Markdown pulito al volo quando un client invia Accept: text/markdown — nessun file .md per pagina, nessun /llms-full.txt da rigenerare, nessuna modifica ai template, perché il CDN fa la conversione al edge (Cloudflare cita ~80% di token in meno per l’agente). È una funzionalità a pagamento — piano Pro e superiori, non il livello gratuito — quindi su questo sito è a un aggiornamento Cloudflare dall’essere attivato piuttosto che qualcosa che ho costruito a mano. Se valga la pena attivarlo è la stessa domanda aperta che incombe su llms.txt stesso: servire ai crawler una copia Markdown parallela di ogni pagina è conveniente, ma è un’altra rappresentazione da tenere sincronizzata, e Fabrice Canel di Bing ha segnalato il doppio carico di crawling e il rischio simile al cloaking del contenuto alternativo servito al edge. Controlla i tuoi log per una reale domanda degli agenti prima di attivarlo.

llms.txt vs robots.txt — non sono la stessa cosa

L’equivoco più comune è che llms.txt sia “robots.txt per l’AI”. Non lo è, e confonderli porta a decisioni sbagliate.

robots.txtllms.txt
ScopoControllo degli accessi — cosa possono scaricare i crawlerGuida ai contenuti — cosa è utile leggere
FormatoDirettive (User-agent:, Disallow:)Collegamenti Markdown + descrizioni
Applicato?Sì, dai crawler conformiNo — solo consultivo
TempisticaAl momento della scansione, prima del recuperoAl momento dell’inferenza, assemblando il contesto
Uno standard?Sì, decenni di storia, universaleNo — una proposta
Può bloccare?No

robots.txt è uno standard reale e applicato. llms.txt è una scatola di suggerimenti che la maggior parte dei sistemi non sta ancora leggendo. Se vuoi controllare l’accesso dei crawler AI — che è un obiettivo separato e legittimo — questo vive in robots.txt e crawler AI, non qui.

Chi lo legge davvero

Questa è la sezione che conta, perché è dove i dati divergono più duramente dall’hype. Nello studio di Ahrefs su 137 210 domini (traffico di maggio 2026):

  • Il 97% dei file llms.txt pubblicati non ha ricevuto alcuna richiesta. Solo circa il 3% (circa 1 100 domini) ha visto qualsiasi traffico.
  • Dei file che sono stati richiesti: il 96% delle richieste proveniva da bot, il 4% da esseri umani.
  • Delle richieste dei bot, il 77% proveniva da strumenti non AI — auditor SEO (Ahrefs stesso tra questi), crawler anonimi, bot di profilazione tecnologica. L’ironia SEO si scrive da sola.
  • Solo circa il 19,5% proveniva da strumenti AI, e una volta scomposto, peggiora per la teoria GEO:
    • Agenti AI e infrastruttura (agenti di codifica): circa il 10,5%
    • Crawler di addestramento (GPTBot in testa con il 4,51%): circa il 5,3%
    • Assistenti AI: circa il 2,5%
    • Bot di recupero AI — quelli che costruiscono indici di citazione: 1,1%.

Leggi quell’ultima riga due volte. I bot per cui la maggior parte delle persone aggiunge llms.txt — OAI-SearchBot, PerplexityBot — “barely registered.” (traduzione) «si sono registrati a malapena». Il consumatore AI dominante è Claude Code, l’agente di codifica di Anthropic, che secondo lo studio “outfetched every AI retrieval bot, assistant, and training crawler except GPTBot.” (traduzione) «ha effettuato più richieste di ogni bot di recupero AI, assistente e crawler di addestramento tranne GPTBot». E GPTBot è un crawler di addestramento che scansiona tutto indipendentemente — la sua presenza non è prova di un’analisi intenzionale di llms.txt.

Altre misurazioni indipendenti arrivano allo stesso punto. OtterlyAI ha osservato un sito per 90 giorni: di oltre 62 100 visite di bot AI, esattamente 84 hanno raggiunto /llms.txt — circa lo 0,1%, con risultati “3x worse than average pages.” (traduzione) «tre volte peggiori delle pagine medie». Un’analisi separata di oltre 515 milioni di eventi di bot LLM in 90 giorni ha trovato 408 richieste totali mirate a /llms.txt“statistically negligible.” (traduzione) «statisticamente trascurabili».

Il messaggio è la divisione tra documentazione per sviluppatori e GEO: llms.txt funziona per ciò per cui Howard l’ha costruito (agenti di codifica che navigano nella documentazione API), e in gran parte non viene toccato dai bot di citazione di ricerca che la comunità SEO vuole raggiungere.

Cosa hanno detto i fornitori

Google — no, e nessun piano. Gary Illyes ha confermato al Search Central Live (luglio 2025) che Google non supporta llms.txt e non ha intenzione di farlo. John Mueller, la voce più citata qui, lo ha paragonato al meta tag delle parole chiave (aprile 2025) e lo ha definito una “temporary crutch, perhaps to save some tokens” (traduzione) «stampella temporanea, forse per risparmiare qualche token» per gli strumenti di codifica AI — esplicitamente non un meccanismo di visibilità di ricerca. La guida di Google di maggio 2026 ha dichiarato che file leggibili da macchina come llms.txt non sono necessari per AI Overviews o AI Mode, che “continue to rely on traditional SEO signals.” (traduzione) «continuano a basarsi sui segnali SEO tradizionali». (Google ha brevemente pubblicato un llms.txt sui suoi documenti di sviluppo il 3 dicembre 2025, poi lo ha rimosso lo stesso giorno — successivamente attribuito a un aggiornamento del CMS, non a un cambiamento di strategia.)

OpenAI — niente. Nessun annuncio che ChatGPT, GPTBot o OAI-SearchBot lo analizzino. I log del server contraddicono un uso significativo; OAI-SearchBot “barely registered.” (traduzione) «si è registrato a malapena». OpenAI indirizza le persone a robots.txt per il controllo dei crawler.

Anthropic — il caso interessante. Anthropic pubblica sia llms.txt che llms-full.txt su docs.anthropic.com/llms.txt, e Claude Code dimostrabilmente recupera i file llms.txt di altri siti — è il più grande consumatore di IA nei dati. Ma questa è una storia di strumenti di codifica. Non c’è conferma che la ricerca o il livello di citazione di Claude.ai onori llms.txt. L’agente di codifica di Anthropic che legge il file e l’indice di ricerca di Anthropic che si fida del file sono affermazioni diverse, e solo la prima è supportata.

Perplexity — afferma di sì, i dati dicono raramente. Perplexity ha dichiarato di recuperare llms.txt e di usarlo per “prioritize page selection.” (traduzione) «dare priorità alla selezione delle pagine». Ma il recupero proattivo è il punto critico: PerplexityBot “barely registered” (traduzione) «si è registrato a malapena» nei dati delle richieste, e c’è “almost zero activity from PerplexityBot requesting llms.txt files proactively.” (traduzione) «quasi zero attività da PerplexityBot che richiede file llms.txt in modo proattivo». Incolla un URL llms.txt in Perplexity e lo legge bene; l’uso autonomo e proattivo è il divario tra politica e pratica.

Bing/Microsoft, Apple, Meta — nessuna posizione pubblica. Trattare come non confermato.

Muove le citazioni IA?

Nessun beneficio dimostrato. SE Ranking ha modellato 300 000 domini con una regressione XGBoost

  • analisi SHAP e ha scoperto che rimuovere llms.txt dal modello migliorava la sua accuratezza — la loro conclusione: “LLMs.txt doesn’t seem to directly impact AI citation frequency. At least not yet.” (traduzione) «LLMs.txt non sembra avere un impatto diretto sulla frequenza delle citazioni AI. Almeno non ancora». Uno studio di Search Engine Land su 10 siti e 180 giorni ha visto 8 siti su 10 non mostrare cambiamenti misurabili, e i due “vincitori” avevano cambiamenti confondenti (copertura PR, nuove pagine FAQ, correzioni tecniche) che non puoi separare dall’llms.txt stesso.

Il confronto con meta-keywords — giusto o no?

L’analogia di Mueller con il meta tag keywords regge sui punti che contano: entrambi sono autodescrizioni del proprietario del sito, nessuno dei due è verificato, ed entrambi sono aperti a manipolazione/cloaking — potresti mostrare una cosa in llms.txt e un’altra sulla pagina. Quella manipolabilità è esattamente il motivo per cui un serio prodotto di ricerca IA non si fiderà di un’autodescrizione rispetto alle pagine reali. Il contro-argomento (Carolyn Shelby) è che llms.txt almeno punta a URL reali che devono rispondere — è “a spotlight, not a wish list.” (traduzione) «un riflettore, non una lista dei desideri». Entrambi hanno ragione, e il risultato pratico è lo stesso: i sistemi di ricerca IA non ci fanno affidamento.

Quando vale la pena aggiungerlo — e quando saltarlo

Aggiungilo se gestisci documentazione per sviluppatori o un riferimento API il cui pubblico principale sono gli agenti di codifica IA (Claude Code, Cursor, Copilot, Codeium). Questo è il caso d’uso per cui è stato creato, e funziona.

Saltalo — o almeno non aspettarti ritorni di visibilità IA — per siti di contenuti, media, ecommerce e siti aziendali ordinari. Il costo è di circa 20 minuti; il beneficio GEO oggi è quasi zero; e quei 20 minuti sono meglio spesi sulla struttura dei contenuti, sulla copertura delle FAQ e sui fondamenti dell’ottimizzazione per la ricerca IA che muovono davvero la visibilità IA. I titoli di alta adozione (la cifra di 844K+ di BuiltWith) sono gonfiati dalla distribuzione automatica della piattaforma — Mintlify ha distribuito llms.txt a tutti i suoi siti di documentazione ospitati in una volta. L’adozione non è utilizzo; il 97% dei file riceve zero richieste.

L’angolo della sicurezza

Questo è poco segnalato e reale: poiché gli agenti IA sono progettati per fidarsi di ciò che c’è in llms.txt, il file è una superficie di attacco naturale. Lo studio Ahrefs ha segnalato attori malintenzionati che sondano i file llms.txt per vulnerabilità di prompt-injection. Se pubblichi uno, trattalo come sensibile alla sicurezza: tienilo sotto controllo di versione, avvisa su modifiche non autorizzate e non metterci mai nulla che non mostreresti pubblicamente.

Implementarlo (se decidi di farlo)

  • Posizionamento: /llms.txt alla radice del dominio, servito come text/plain o text/markdown, HTTP 200.
  • Cura, non scaricare: 20–50 dei tuoi link più importanti. Se elenchi tutto, un modello potrebbe anche fare crawling direttamente — la cura è l’intero punto.
  • Opzionalmente servi /llms-full.txt per contesti che vogliono tutti i tuoi contenuti.
  • Valida: carica il file in Claude, ChatGPT o Perplexity e chiedi di riassumere il tuo sito; poi controlla i log del server dopo alcune settimane per richieste reali.
  • Esistono generatori per VitePress (vitepress-plugin-llms), Docusaurus (docusaurus-plugin-llms), WordPress (“Website LLMs.txt”), Drupal, più un CLI Python (llms_txt2ctx).

In conclusione: costo basso, attualmente beneficio GEO quasi nullo, genuinamente utile per il caso d’uso degli agenti di codifica per cui è nato. Controlla i tuoi log del server prima di decidere — se vedi traffico Claude-Code/Cursor, llms.txt potrebbe aiutarli; se stai inseguendo OAI-SearchBot e PerplexityBot, non è la leva giusta.

Add an expert note

Pin an expert quote

New person? Create their unclaimed profile at /admin/experts/ → Pin a quote first.