Validatore llms.txt

Validatore

Inserire un dominio (recuperiamo il suo /llms.txt) o un URL completo del file. Il recupero avviene tramite la nostra funzione edge, quindi le restrizioni CORS del sito di destinazione non si applicano.

Incolla il contenuto del file

Cosa viene verificato

Il validatore implementa le regole di llmstxt.org:

• H1 obbligatorio. Esattamente un'intestazione di livello 1, prima riga non vuota.
• Riepilogo nel blocco di citazione. Consigliato subito dopo l'H1.
• Sezioni H2 con liste di file. Ogni sezione è una lista Markdown di elementi - [nome](url), con : note opzionali.
• URL assoluti. Gli URL relativi vengono contrassegnati come avvertimenti.
• Nessun contenuto fuori dalle sezioni. Dopo il primo H2, sono attese solo liste di file.
• Controllo dimensioni. I file superiori a 50 KB ricevono una nota informativa che suggerisce llms-full.txt.

Ogni diagnostico include un codice regola (es. H1_REQUIRED, URL_RELATIVE) per poterlo trovare nei log CI con grep.

Usare in CI

Lo stesso parser di questa pagina può essere integrato nel processo di build: i codici di regola sono stabili e ricercabili nei log CI. Esempio minimo in Node:

import { readFileSync } from 'node:fs';
import { parseLlmsTxt, summarize } from './validator/validate'; // lo stesso parser di questo validatore

const input = readFileSync('public/llms.txt', 'utf8');
const parsed = parseLlmsTxt(input);
const sum = summarize(parsed);

if (!sum.passes) {
  for (const d of parsed.diagnostics) {
    console.error(`${d.severity.toUpperCase()} [${d.rule}] riga ${d.line}: ${d.message}`);
  }
  process.exit(1);
}
console.log(`OK, ${parsed.sections.length} sezioni, ${parsed.sizeBytes} byte`);