Перейти к содержимому
Выберите тему

Как создать llms.txt

Как создать llms.txt по второй редакции proposal - выбрать главные страницы, написать файл, разместить его в корне сайта, проверить ответ сервера и не забыть об обновлении

Если ещё не решено, нужен ли файл вообще: Что такое llms.txt.

  1. Выбери главные страницы.

    Представь человека, который впервые пришёл на сайт с вопросом. Какие пять-двадцать страниц ответят на большинство вопросов? Это и есть содержимое файла.

    Не подходят: страницы входа и корзины, результаты поиска, служебные и закрытые разделы, дубли.

  2. Сгруппируй их по смыслу.

    Двух-пяти разделов хватает почти любому сайту: документация и примеры, каталог и условия, статьи и справка.

  3. Напиши файл.

    Название сайта, одна-две фразы о нём, затем разделы со ссылками. К каждой ссылке - пояснение, что по ней находится.

  4. Положи файл в корень сайта.

    Он должен открываться по адресу https://твой-сайт/llms.txt и отдаваться как текст.

  5. Проверь ответ сервера.

    Код 200, текстовый тип, первая строка начинается с решётки. Частая ошибка - сайт отдаёт вместо файла HTML-страницу.

  6. Реши, как файл будет обновляться.

    Файл, который не меняется вместе с сайтом, через полгода ведёт на несуществующие страницы.

llms.txtФайл небольшого сайта документации
  1. # Колос API

    Названиеобязательно

    Заголовок первого уровня. Единственная обязательная часть

  2. > Сервис доставки для интернет-магазинов: расчёт стоимости, создание заказов, отслеживание.

    Описаниепо желанию

    Что это за сайт, в одной-двух фразах

  3. Все запросы требуют ключа. Тестовая среда: sandbox.kolos.example

    Подробностипо желанию

    Необязательный текст без заголовков: то, что важно знать заранее

  4. ## Документация
    - [Быстрый старт](https://kolos.example/docs/start.md): ключ, первый запрос, первый заказ
    - [Справочник API](https://kolos.example/docs/api.md): методы, параметры, коды ошибок

    Разделпо желанию

    Заголовок второго уровня и список ссылок с пояснениями

  5. ## Optional
    - [История изменений](https://kolos.example/changelog.md): версии и даты

    Второстепенноепо желанию

    По соглашению сюда кладут то, что можно пропустить

Тот же файл целиком:

# Колос API
> Сервис доставки для интернет-магазинов: расчёт стоимости, создание заказов, отслеживание.
Все запросы требуют ключа. Тестовая среда: sandbox.kolos.example
## Документация
- [Быстрый старт](https://kolos.example/docs/start.md): ключ, первый запрос, первый заказ
- [Справочник API](https://kolos.example/docs/api.md): методы, параметры, коды ошибок
## Optional
- [История изменений](https://kolos.example/changelog.md): версии и даты

Точные правила: формат файла, секции. Больше образцов: базовые примеры.

Файл кладут в корень сайта, рядом с robots.txt. Для статического сайта это папка с публичными файлами. Для сайта на системе управления файл обычно отдаёт расширение, и на диске его нет.

Вторая редакция proposal разрешает и файл в разделе сайта. Тогда он описывает только адреса внутри этого раздела:

/llms.txt весь сайт
/docs/llms.txt только раздел /docs/
Окно терминала
curl -sI https://example.ru/llms.txt
curl -s https://example.ru/llms.txt | head -n 3
  1. Код ответа 200.
  2. Тип содержимого text/plain или text/markdown.
  3. Первая строка начинается с # .
  4. Ссылки абсолютные и открываются.
  5. robots.txt не закрывает файл.

Полный список проверок: Проверка файлов и разметки.

Вторая редакция добавила связь, по которой страница сама сообщает, какой llms.txt её описывает:

<link rel="describedby" href="/llms.txt">

Это необязательный шаг. Подробно: Обнаружение файла и Markdown-версий.

Если сайт работает на системе управления, писать файл руками незачем: его соберёт расширение из уже существующих страниц.

Сайт на Что почитать
WordPress llms.txt в WordPress
Webasyst, Shop-Script llms.txt и JSON-LD в Webasyst, готовые расширения
Starlight, Docusaurus, MkDocs, VitePress Настройка в генераторах документации
Другое Генераторы и инструменты

Автоматически собранный файл проверяют так же, как написанный вручную. И его стоит просмотреть глазами: расширение знает структуру сайта, но не знает, что на нём главное.

  • Не копируй карту сайта. Полный список адресов уже есть в sitemap.xml. Здесь нужен отбор.
  • Не пиши запреты. Файл ничего не закрывает. Доступ роботам настраивают в robots.txt.
  • Не добавляй закрытое. Файл публичный: в нём не должно быть адресов панели управления и черновиков.
  • Не жди роста позиций. Поисковые системы файл для ранжирования не используют: Работает ли llms.txt.