Enver Dzheparov

Генератор LLMs.txt с ИИ

Версия генератора с описаниями от ИИ

$55 · разработка · IP5 Agency

Рис. 1 — Общий вид модуля IP5 Agency — ИИ-генератор llms.txt в административной панели CS-Cart.

Модуль доступен на 2 языках: русском, английском.

Покупатели всё чаще спрашивают у ИИ-ассистента, а не у поисковика. Чтобы попасть в его ответ, магазин должен быть понятен машине: что продаётся, как устроена структура, где что искать. Модуль генерирует три машиночитаемых формата вашего магазина — llms.txt, llms-full.txt и постраничный Markdown — и держит их в актуальном состоянии автоматически. В отличие от шаблонных генераторов, основной файл пишет настоящая языковая модель (Claude или любой провайдер, совместимый с Anthropic Messages API, включая OpenRouter) — поэтому текст связный и читаемый, а не механическая выгрузка полей из базы данных.

Как работает модуль

В основе модуля — три сущности:

Каждая генерация сначала создаёт черновик. Черновик не виден по публичному URL, пока администратор не проверит его в админ-панели и не нажмёт Опубликовать. Это исключает ситуацию, когда неудачный или некачественный ответ ИИ сразу же попадает на живой файл.

Соответствие стандарту llms.txt

Формат llms.txt, который генерирует модуль, построен не произвольно, а строго по официальной спецификации проекта llmstxt.org: заголовок первого уровня, краткое описание в виде цитаты (blockquote), тематические разделы второго уровня со списками markdown-гиперссылок, и отдельный раздел Optional для второстепенных материалов — именно так, как описано в спецификации. Каждая ссылка на категорию, товар, страницу или статью блога оформлена как настоящая markdown-ссылка [Название](адрес), а не просто упомянута рядом текстом — это прямое требование стандарта, и мы проверили его построчным сравнением с эталонным примером.

Модуль также учитывает рекомендации официальной документации CS-Cart по разделу Оптимизация вашего сайта с помощью LLM: краткий файл llms.txt остаётся навигационным (оптимальное количество ссылок — 20–50, без полного каталога), а весь объём товаров и категорий с описаниями выносится в отдельный файл llms-full.txt — ровно то разделение, которое советует сама платформа.

1. Установка и первичная настройка

Перейдите в Add-ons → Manage Add-ons → Install add-on, загрузите архив модуля и активируйте его. После установки модуль появится в разделе Marketing → IP5 Agency — ИИ-генератор llms.txt.

Откройте собственную вкладку Settings модуля и заполните API-ключ и эндпоинт до начала генерации — без ключа доступны только ручное редактирование и не требующий ИИ файл llms-full.txt.

Рис. 2 — Верхняя часть настроек модуля на вкладке Settings.

Рис. 3 — Продолжение списка настроек модуля.

Рис. 4 — Нижняя часть списка настроек модуля.

2. Справочник общих настроек

Таблица ниже перечисляет все настройки на вкладке Settings модуля.

Настройка Что делает
API ключ Ключ для доступа к API языковой модели. Работает с Anthropic (console.anthropic.com) или любым провайдером, совместимым с Anthropic Messages API, включая OpenRouter или собственный прокси.
Базовый URL API Адрес эндпоинта, куда модуль отправляет запрос на генерацию. По умолчанию — эндпоинт Anthropic; можно указать совместимый прокси.
Модель AI Точное имя модели, как оно указано у провайдера.
Таймаут Сколько ждать ответ от API, прежде чем считать запрос неудавшимся.
CRON ключ Секрет для внешнего URL-эндпоинта генерации, чтобы запустить её мог только тот, кто знает ключ.
Включать категории / товары / страницы / статьи Четыре независимых чекбокса, определяющих, какие типы контента вообще собираются.
Лимит товаров / категорий / страниц / статей Верхняя граница количества объектов каждого типа в автоматическом режиме.
Исключать товары не в наличии и без цены Фильтрует товары без цены или без остатка.
Генерировать llms-full.txt Включает второй файл — полный экспорт без обращения к ИИ.
Описание магазина Свободный текст, который ИИ использует как основу вступительного раздела вместо того, чтобы придумывать его самостоятельно.
Внешние ссылки Дополнительные URL (PDF, соцсети, лендинги), добавляются в оба файла, по одной ссылке на строку.
Ручной отбор Переключает с лимитов по количеству на точный список выбранных вручную объектов.
Markdown-версия страницы Включает роут /название.md для отдельных страниц.
Автообновление по расписанию + время Автоматически перегенерирует и публикует файл раз в сутки в заданное время, без доступа к серверному cron.
Максимум токенов Верхняя граница длины ответа, сгенерированного ИИ.

3. Генерация и публикация контента

Откройте собственную страницу управления модулем (Marketing → IP5 Agency — ИИ-генератор llms.txt). На странице доступны основные инструменты для формирования, проверки и публикации файлов.

Рис. 5 — Страница управления модулем с основными элементами управления.

Рис. 6 — Состояние файлов и информация о генерации на странице управления.

Нажмите Оценить объём, чтобы увидеть, сколько категорий, товаров, страниц и статей попадёт в файл, и примерное количество входных токенов — до того, как тратить бюджет API.

Рис. 7 — Исходное состояние страницы управления перед генерацией и публикацией нового содержимого.

Нажмите Сгенерировать llms.txt с помощью ИИ. Это создаёт новый черновик — публичный файл пока не затрагивается.

Рис. 8 — Состояние страницы во время генерации llms.txt.

После завершения генерации появляется блок черновика с новым текстом и возможностью проверить его перед публикацией.

Рис. 9 — Созданный черновик llms.txt перед публикацией.

После проверки черновик можно опубликовать. Публикация обновляет публичный URL llms.txt.

Рис. 10 — Состояние страницы после генерации и публикации содержимого.

4. Ручной отбор контента

Включите Ручной отбор в настройках, чтобы перейти от лимитов по количеству к точному выбору конкретных объектов. На странице управления можно выбирать категории, товары, страницы и статьи блога, которые должны попасть в генерируемые файлы.

Рис. 11 — Ручной отбор категорий, товаров, страниц и статей для включения в файл.

5. Ручное редактирование

Оба файла можно также редактировать напрямую как обычный текст и сохранить вручную. При таком способе изменения публикуются сразу, минуя этап создания черновика.

Рис. 12 — Ручное редактирование содержимого llms.txt и llms-full.txt.

6. Постраничный Markdown

При включённой настройке любой товар, категория или CMS-страница также доступны в чистом Markdown по своему обычному адресу с добавленным .md — например, example.com/nazvanie-tovara.md. Формируется по запросу, в реальном времени, без дополнительных шагов в админ-панели.

Рис. 13 — Пример страницы товара, открытой в Markdown-формате.

7. Расписание

Два независимых способа держать файл актуальным без ручных действий:

8. Лог генераций

Каждая попытка генерации, успешная или нет, логируется с меткой времени, статусом, количеством токенов и текстом ошибки, если она была. Лог позволяет отслеживать историю работы генератора и выявлять проблемы при обращении к API.

Рис. 14 — Лог генераций с информацией о выполненных попытках, статусах и количестве использованных токенов.