Структурированные данные и JSON-LD

В обиходе всё это называют микроразметкой. Слово привычное, но неточное: микроданные - лишь один из трёх форматов.

Блок JSON-LD лежит в коде страницы и на экране не виден:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Чайник электрический Volna 1,7 л",
  "sku": "VLN-17-W",
  "brand": { "@type": "Brand", "name": "Volna" },
  "offers": {
    "@type": "Offer",
    "price": "2490",
    "priceCurrency": "RUB",
    "availability": "https://schema.org/InStock"
  }
}
</script>

@context называет словарь, @type - тип сущности. Остальное - свойства этого типа. Регистр букв важен: Product и product - разные слова.

llms.txt и структурированные данные работают в паре, но на разных шагах. Первый подсказывает, куда идти. Вторые объясняют, куда машина пришла. Один слой другого не заменяет: Сайт, готовый к AI.

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

Тип выбирают по тому, что на самом деле находится на странице.

QAPage и FAQPage легко спутать. Первый тип - для страницы, где вопрос задал один человек, а отвечают другие. Второй - для списка вопросов, на которые отвечает сам владелец сайта.

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

• Цена в разметке равна цене на странице. Не «от», не старая, не цена для другого региона.
• Валюта записывается трёхбуквенным кодом. Знак «₽» машина не разберёт.
• Наличие берётся из складского учёта, а не ставится InStock всем товарам сразу.
• Товар без цены не получает Offer. Пустое или нулевое предложение хуже отсутствующего.

Если у товара есть размеры или цвета, у каждого варианта своя цена, свой артикул и своё наличие. Для этого в Schema.org есть ProductGroup: общие сведения лежат на группе, отличия - на вариантах.

AggregateOffer для вариантов одного товара не подходит. Этот тип описывает предложения разных продавцов, и Google для карточек продавца требует именно Offer.

gtin - международный штрихкод, mpn - код детали у производителя. По ним системы сопоставляют один и тот же товар в разных магазинах.

Выдумывать их нельзя. У штрихкода есть контрольная цифра, и неверное значение хуже пустого поля. Артикул магазина - это sku, а не mpn.

Крупные площадки получают данные о товаре двумя путями: из фида и со страницы. Если пути расходятся, площадка замечает.

• Google Merchant Center сверяет фид со страницей и может сам обновить цену и наличие по разметке. Google отдельно оговаривает, что это страховка, а не замена обновлению фида.
• Яндекс даёт данным из разметки товарной страницы максимальный приоритет перед другими источниками.

Практический вывод: бренд, штрихкод, цвет и размер должны браться в разметку и в фид из одной характеристики товара.

Если магазина ещё нет, проще начать с конструктора, где каталог сам передаётся в товарный поиск Яндекса без отдельного фида: так устроен Яндекс KIT.

• Разметка описывает то, что видит человек. Отзыв, цена или автор в разметке есть и на странице.
• Ничего не выдумывается. Нет данных - нет свойства.
• Тип соответствует странице. Страница категории - не Product, страница «О компании» - не Article.
• Сущности связаны. Статья ссылается на автора и издателя, товар - на продавца, страница - на сайт. Для связей служит @id.
• Один источник. Если разметку выводят и тема сайта, и расширение, машина получает два противоречивых описания.
• Разметка обновляется вместе с содержимым. Изменилась цена - изменилась и разметка.

Адреса инструментов и разбор ошибок: Проверка файлов и разметки.

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

Вручную остаётся решить, какие характеристики считать брендом и штрихкодом, заполнить карточку компании и проверить результат.

Как это устроено в одной системе: llms.txt и JSON-LD в Webasyst. Все расширения собраны на странице разработчика в магазине Webasyst.