Informazioni sulla convalida di llms.txt
Cosa convalidare
Il formato llms.txt è breve: un H1 con il nome del sito, un blocco di citazione facoltativo, quindi sezioni H2 i cui contenuti sono elenchi di link in Markdown scritti come nome, URL e descrizione.
Poiché è richiesto così poco in senso stretto, un file può essere perfettamente valido e tuttavia valere quasi nulla: un’intestazione e un semplice link superano ogni test strutturale, ma non forniscono alcuna informazione a un assistente.
Per questo, questo strumento separa le due questioni. Gli errori sono ciò che compromette il formato; i suggerimenti sono ciò che impedisce al file di essere utile.
Cosa compromette il formato
- Nessuna intestazione H1, l’unica riga realmente obbligatoria.
- Più di un’intestazione H1, rendendo ambiguo il nome del sito.
- Elementi di elenco che non sono link Markdown.
- Link senza testo tra le parentesi quadre.
- Percorsi relativi, che diventano ambigui quando il file viene letto al di fuori del tuo sito.
Cosa lo rende utile
- Una riga di riepilogo, così il lettore sa cos’è il sito prima di leggere i link.
- Intestazioni di sezione, così ogni link appartiene a una parte del sito.
- Una descrizione per ogni link che indichi cosa si trova nella pagina, invece di ripeterne il nome.
- Moderazione. Un file con centinaia di link è una sitemap, mentre l’obiettivo era la selezione curata.
Le descrizioni fanno gran parte del lavoro. Sono ciò che rende una pagina selezionabile per una determinata domanda, invece di essere semplicemente elencata.
Cosa controlla questo strumento
Inserisci il tuo dominio: verrà recuperato il file /llms.txt, che sarà analizzato per segnalare separatamente gli errori strutturali e i suggerimenti sulla qualità, insieme a un riepilogo dei contenuti del file.
Rileva anche il caso di soft 404, in cui un server restituisce un codice 200 con la propria pagina normale invece del file: nel browser sembra un’operazione riuscita ed è il falso positivo più comune.
Legge il file così come è stato pubblicato, invece di recuperare ogni link, quindi una pagina elencata che nel frattempo è stata spostata non verrà segnalata qui.
Cosa fare dopo
Se non esiste ancora alcun file, il nostro
Generatore di llms.txt ne creerà uno utilizzando i dati del tuo sito. Il
Verificatore llms.txt risponde alla domanda più semplice, ovvero se esista effettivamente un file, mentre il verificatore
Crawler per l’IA conferma che le pagine a cui rimanda possano essere effettivamente sottoposte a scansione.