документация

Быстрый старт ​

Цель — за несколько шагов получить рабочий фид и подключённый проект.

Шаг 1. Минимальный рабочий фид ​

Ниже — самый маленький фид, который сервис примет и проиндексирует. Он содержит шесть данных, покрывающих все обязательные роли (см. «Сопоставление полей»): идентификатор, название, цену, ссылку, категорию и изображение.

xml
<?xml version="1.0" encoding="utf-8"?>
<yml_catalog date="2026-07-13 09:43">
  <shop>
    <name>Мой магазин</name>
    <url>https://example.com</url>
    <currencies>
      <currency id="RUB" rate="1"/>
    </currencies>
    <categories>
      <category id="1">Одежда</category>
      <category id="2" parentId="1">Платья</category>
    </categories>
    <offers>
      <offer id="1001" available="true">
        <name>Платье миди «Ривьера»</name>
        <url>https://example.com/product/riviera/</url>
        <price>7990</price>
        <currencyId>RUB</currencyId>
        <categoryId>2</categoryId>
        <picture>https://example.com/img/riviera.jpg</picture>
        <vendor>Мой бренд</vendor>
      </offer>
    </offers>
  </shop>
</yml_catalog>

Этого достаточно для запуска. Всё остальное — характеристики, группировка вариантов, дополнительные поля — опционально и улучшает качество поиска и фильтров.

TIP

Скорее всего, такой файл (или богаче) уже генерирует ваша CMS для товарных площадок. Проверьте выгрузку «YML для Яндекс.Маркета» — как правило, она подходит без изменений.

Шаг 2. Проверьте фид перед подключением ​

Пройдитесь по чек-листу (полная версия — в «Требованиях»):

  • Файл отдаётся по прямой HTTPS-ссылке без редиректов. Закрытый фид тоже подойдёт — доступ указывается в ЛК, см. «Закрытый фид».
  • Не заархивирован, не под паролем.
  • Кодировка utf-8 (допускается windows-1251 — сервис сконвертирует сам).
  • Корень — <yml_catalog>, внутри <shop>, внутри — <categories> и <offers>.
  • У каждого <offer> есть непустой атрибут id.
  • Товар привязан к листовой (самой глубокой) категории через <categoryId> (если товар в нескольких разделах — несколько тегов, первым основной).
  • Размер файла — до 2 ГБ.

Быстрая локальная проверка структуры:

bash
# HTTP-код, размер, тип
curl -sI "https://example.com/feed.xml"

# Корневые теги и число офферов
curl -s "https://example.com/feed.xml" | head -c 500
curl -s "https://example.com/feed.xml" | grep -c "<offer "

Шаг 3. Создайте проект ​

В личном кабинете: Проекты → Создать. Мастер из трёх шагов:

  1. Источник фида — название проекта, ссылка на фид, язык поиска (ru), интервал обновления (часы, минимум 1), опция семантического поиска. После нажатия «Далее» сервис сразу скачивает и анализирует фид.
  2. Анализ фида — для каждой из шести обязательных ролей мастер предлагает найденное поле; рядом показывает % заполненности и примеры значений. Проверьте автоподбор и при необходимости поправьте.
  3. Подтверждение — сводка. По завершении сервис создаёт проект, строит схему индекса и запускает первый импорт в фоне.

Данные появятся в выдаче, когда первый импорт закончится: небольшой каталог — за несколько минут, каталог в десятки тысяч товаров — до часа. За прогрессом можно следить на карточке проекта.

Мастер:  [1] Источник ──▶ анализ фида ──▶ [2] Роли ──▶ [3] Подтверждение
                                                              │
                                                              ▼
                                          создание проекта + схема + импорт

Что дальше ​