# Как создать файл llms.txt: пошаговая инструкция

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

Страница: https://llms-full-txt.ru/guides/getting-started/
Указатель сайта: https://llms-full-txt.ru/llms.txt

Чтобы создать `llms.txt`, нужно выбрать главные страницы сайта, записать их списком ссылок с пояснениями и положить файл в корень сайта.

Вручную это занимает полчаса. Для сайта на системе управления файл обычно собирает расширение.

Сложность не в формате, а в отборе: файл полезен, когда в нём главное, а не всё подряд.

Если ещё не решено, нужен ли файл вообще: [Что такое llms.txt](https://llms-full-txt.ru/guides/what-is-llms-txt/).

## Путь вручную

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

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

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

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

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

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

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

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

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

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

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

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

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

## Как выглядит файл

- llms.txt
- Файл небольшого сайта документации
- Название

```
# Колос API
```

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

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

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

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

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

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

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

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

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

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

```markdown
# Колос API

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

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

## Документация

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

## Optional

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

Точные правила: [формат файла](https://llms-full-txt.ru/specification/format/), [секции](https://llms-full-txt.ru/specification/sections/). Больше образцов: [базовые примеры](https://llms-full-txt.ru/examples/basic/).

## Где разместить

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

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

```text
/llms.txt        весь сайт
/docs/llms.txt   только раздел /docs/
```

## Проверка

```bash
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` не закрывает файл.

Полный список проверок: [Проверка файлов и разметки](https://llms-full-txt.ru/guides/validation/).

## Как помочь агенту найти файл

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

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

Это необязательный шаг. Подробно: [Обнаружение файла и Markdown-версий](https://llms-full-txt.ru/specification/discovery/).

## Готовый путь

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

| Сайт на | Что почитать |
|---|---|
| WordPress | [llms.txt в WordPress](https://llms-full-txt.ru/guides/wordpress/) |
| Webasyst, Shop-Script | [llms.txt и JSON-LD в Webasyst](https://llms-full-txt.ru/guides/webasyst/), готовые расширения |
| Starlight, Docusaurus, MkDocs, VitePress | [Настройка в генераторах документации](https://llms-full-txt.ru/reference/configuration/) |
| Другое | [Генераторы и инструменты](https://llms-full-txt.ru/tools/generators/) |

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

## Чего не делать

- **Не копируй карту сайта.** Полный список адресов уже есть в `sitemap.xml`. Здесь нужен отбор.
- **Не пиши запреты.** Файл ничего не закрывает. Доступ роботам настраивают в `robots.txt`.
- **Не добавляй закрытое.** Файл публичный: в нём не должно быть адресов панели управления и черновиков.
- **Не жди роста позиций.** Поисковые системы файл для ранжирования не используют: [Работает ли llms.txt](https://llms-full-txt.ru/guides/does-llms-txt-work/).

## Что дальше

- [Лучшие практики](https://llms-full-txt.ru/guides/best-practices/) - как сделать файл полезным
- [Сайт, готовый к AI](https://llms-full-txt.ru/guides/ai-ready-site/) - остальные слои: доступ, разметка, содержание
- [Что такое llms-full.txt](https://llms-full-txt.ru/guides/llms-full-txt/) - нужен ли второй файл
- [Промпт для генерации](https://llms-full-txt.ru/prompts/generate-llms-txt/) - черновик файла с помощью нейросети