Вставка или загрузка · Диагностика по строкам

валидатор llms.txt

Вставленное содержимое анализируется в браузере. Чтобы проверить общедоступный URL, наша функция Cloudflare получает файл, после чего браузер анализирует его структуру.

Последнее обновление:

Валидатор

Введите домен (мы загрузим его /llms.txt) или полный URL файла. Получение выполняется через нашу edge-функцию, поэтому ограничения CORS целевого сайта не применяются.

Что мы проверяем

Валидатор реализует правила из llmstxt.org:

  • Требуется H1. Ровно один заголовок первого уровня (level-1) после необязательной метки порядка байтов UTF-8.
  • Краткое содержание в цитате. Рекомендуется сразу после H1.
  • Разделы списков файлов H2. Каждый раздел — это список Markdown из - [name](url) элементов, с возможностью : notes.
  • Абсолютные URL. Относительные URL помечаются как предупреждения.
  • Никакого содержимого вне разделов. После первого H2 ожидаются только списки файлов.
  • Нет заголовков преамбулы. Свободный контекст перед первым H2 не может добавлять заголовки H3–H6.
  • Ограничение размера. Файлы размером более 50 KB получают информационную заметку с рекомендацией llms-full.txt.

Каждая диагностика содержит код правила (например, H1_REQUIRED, URL_RELATIVE) чтобы вы могли найти его в журналах CI.

Используйте это из CI

Тот же парсер, который обеспечивает работу этой страницы, можно подключить к вашей сборке: приведённые ниже коды правил стабильны, поэтому скрипт может находить их в журналах CI. Минимальная проверка Node:

import { readFileSync } from 'node:fs';
import { parseLlmsTxt, summarize } from './validator/validate'; // same parser as this validator

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}] line ${d.line}: ${d.message}`);
  }
  process.exit(1);
}
console.log(`OK, ${parsed.sections.length} sections, ${parsed.sizeBytes} bytes`);

Следующие шаги

Валидный файл всё ещё может оказаться не тем файлом. Десять правил лучших практик охватывают то, что не может проверить ни один валидатор: являются ли перечисленные страницы действительно нужными модели, а это редко самые посещаемые страницы. Начинаете с нуля? генератор создаёт корректный файл из вашей карты сайта и как создать llms.txt охватывает стек развёртывания за стеком. Сам синтаксис см. в справка по формату, или прочитайте настоящие файлы опубликованный Anthropic, Cloudflare и Stripe.

Источники