# llms.txt и JSON-LD в Webasyst и Shop-Script

> Как в Webasyst и Shop-Script получить llms.txt и структурированные данные: что делает каждое приложение, как обновляются файлы и разметка и что проверить после установки

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

В Webasyst оба машинных слоя собираются из данных, которые уже есть в приложениях: товары, страницы, статьи, обсуждения, вопросы и ответы, фотографии.

Слоя два, и они независимы. Расширение `llms.txt` строит карту материалов сайта. Расширение JSON-LD добавляет на каждую страницу описание того, что на ней находится. Ставить можно любое из двух, но вместе они закрывают оба шага: куда идти и куда пришёл.

У каждого приложения своё расширение, потому что данные у приложений разные.

## Два слоя на одном сайте

- Что откуда берётся
- Карта
- Данные приложения
- категории, товары, страницы, статьи
- Сборка по расписанию
- или кнопкой в настройках
- llms.txt и llms-full.txt
- по адресу в корне домена
- Смысл
- Данные страницы
- товар, статья, тема, вопрос, фото
- Сборка при показе
- с кэшем на час
- Блок JSON-LD
- в коде каждой страницы

## Что делает каждое приложение

| Приложение | Что попадает в `llms.txt` | Что описывает JSON-LD |
|---|---|---|
| Shop-Script | категории, товары, бренды, информационные страницы, контакты; цены и наличие по желанию | `Product`, `Offer`, `Brand`, рейтинг и отзывы, хлебные крошки, магазин |
| Сайт | опубликованные страницы, название и контакты | `WebPage` с датами, `Organization`, `WebSite`, хлебные крошки |
| Блог | статьи, рубрики и теги | `BlogPosting` с автором и датами, `Person`, лента и рубрики как коллекции |
| Хаб | публичные разделы и опубликованные темы | `DiscussionForumPosting`, комментарии, голоса, `QAPage` при отмеченном решении |
| Поддержка | публичные вопросы и ответы и страницы | `FAQPage` с вопросом и ответом, хлебные крошки |
| Фото | публичные альбомы и страницы | `ImageObject` с подписью и размерами, `ImageGallery` |

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

## Слой llms.txt

- **Файлы строятся заранее.** Расширение собирает `llms.txt` и `llms-full.txt` и хранит их в данных установки. По адресу `/llms.txt` готовый файл отдаёт маршрутизация. Файла в корне сайта на диске нет.
- **Пересборка идёт по расписанию.** Изменение товара или страницы ставит отметку «есть изменения». Сам файл пересобирает задание планировщика или кнопка в настройках. Расписание владелец сайта добавляет один раз: ночная полная сборка и частая проверка отметки.
- **У «Поддержки» событий изменения нет.** Приложение не сообщает расширениям о правках, поэтому её карта обновляется только по расписанию.
- **Большой каталог делится на части.** Когда полный файл превышает заданный размер, разделы выносятся в отдельные файлы вида `llms-full-<раздел>.txt`.
- **Один корневой файл на домен.** Если на домене несколько приложений, карту ведёт то, что стоит в корне, а остальные в неё включаются.
- **Цены в файле - по выбору.** В магазине можно включить цену, старую цену и наличие или оставить только названия и адреса.
- **Срок годности виден.** Настройки предупреждают, когда файл давно не пересобирался.

Формат получается обычный: заголовок с названием, краткое описание, секции со ссылками. Проверять его нужно так же, как написанный вручную: [Проверка файлов и разметки](https://llms-full-txt.ru/guides/validation/).

## Слой JSON-LD

- **Блок выводится в коде страницы.** Правок темы не требуется.
- **Разметка собирается при показе страницы** и кэшируется на час. Изменение цены или текста меняет ключ кэша сразу. Изменение, которого ключ не видит, доходит до разметки в пределах часа.
- **Сущности связаны.** Страница ссылается на сайт, сайт - на организацию, статья - на автора, комментарий - на тему.
- **Карточка компании заполняется в настройках.** Телефон и адрес берутся из Shop-Script, если он установлен на том же домене.
- **Закрытые от индексации страницы не размечаются.**

### Что получает страница товара

В Shop-Script разметка товара есть в двух редакциях.

| Что | Базовая редакция | Расширенная редакция |
|---|---|---|
| Товар и предложение | `Product`, `Offer`: название, артикул, цена, валюта, наличие | то же |
| Бренд | из характеристики, которую указал владелец | плюс производитель отдельным свойством |
| Рейтинг и отзывы | `AggregateRating`, до 20 отзывов с ответами | то же |
| Изображения | до 20, с размерами | плюс видео |
| Хлебные крошки | да | плюс цепочка категорий и страницы категорий |
| Варианты | один товар для выбранного артикула | `ProductGroup` с отдельной ценой, артикулом и наличием у каждого варианта |
| Штрихкод и код производителя | нет | `gtin` с проверкой контрольной цифры, `mpn` |
| Магазин | название, адрес сайта, логотип | контакты, адрес, часы работы, пункты выдачи, доставка, возврат, способы оплаты |
| Витрины | один домен | все витрины |

Несколько вещей расширение делает строго:

- **Наличие** принимает три значения: в наличии, нет в наличии, под заказ. Третье появляется, только если в магазине разрешена продажа без остатка.
- **Цена** публикуется в валюте витрины, а не в валюте, которую выбрал посетитель.
- **Товар без цены** не получает предложения.
- **`AggregateOffer` не используется.** Варианты одного товара описываются отдельными предложениями.
- **Бренд и штрихкод не угадываются.** Нет назначенной характеристики - нет свойства.
- **Группа вариантов** строится, когда варианты различаются цветом, размером, материалом или рисунком. Артикулы, которые отличаются чем-то другим, дают один товар.

### Разметка и фид из одного источника

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

Зачем это нужно: [Разметка и товарный фид](https://llms-full-txt.ru/guides/json-ld/#разметка-и-товарный-фид).

## Что остаётся сделать самому

1. Добавь задания планировщика для пересборки `llms.txt`: без них файл не обновится сам.
2. Укажи в настройках разметки, какая характеристика товара - бренд, а какая - штрихкод.
3. Заполни карточку компании: название, логотип, телефон, адрес.
4. Проверь, что тема сайта не выводит собственную разметку того же типа.
5. Открой `/llms.txt` и убедись, что ответ `200` и это текст, а не HTML.
6. Проверь две-три страницы в валидаторах [Google](https://search.google.com/test/rich-results) и [Яндекса](https://webmaster.yandex.ru/site/tools/microtest/).
7. Убедись, что `robots.txt` не закрывает файлы от нужных роботов.

## Чего ждать не стоит

**Подтверждено**

- Файлы и разметка собираются из данных приложения и обновляются без ручной правки.
- В оба слоя попадает только публичное содержимое.
- Разметку товаров читают Google и Яндекс: это записано в их документации.

**Не доказано**

- Что `llms.txt` повлияет на позиции или число цитирований.
- Что конкретная нейросеть прочитает разметку магазина напрямую.

**Чего это не означает**

- Разметка не обновляется мгновенно при любом изменении: кэш живёт до часа.
- `llms.txt` не обновляется сам: нужен планировщик.
- Расширение не исправит цену или описание, которые неверны в самом каталоге.

## Расширения для llms.txt

## Расширения для структурированных данных

## Что читать дальше

- [Сайт, готовый к AI](https://llms-full-txt.ru/guides/ai-ready-site/) - все слои по порядку
- [Структурированные данные и JSON-LD](https://llms-full-txt.ru/guides/json-ld/) - какая разметка нужна какому сайту
- [Что такое llms.txt](https://llms-full-txt.ru/guides/what-is-llms-txt/) - зачем нужна карта
- [Проверка файлов и разметки](https://llms-full-txt.ru/guides/validation/) - как убедиться, что всё работает