YML-фид: обзор

Поисковый сервис работает поверх вашего товарного каталога. Единственный источник данных о товарах — YML-фид: XML-файл в формате Yandex Market Language, доступный по прямой ссылке. Сервис периодически скачивает фид, разбирает его, строит поисковый индекс и отдаёт результаты в виджет витрины и в API.

Формат намеренно совпадает с YML/«Яндекс.Маркет»: скорее всего, ваша CMS (1С-Битрикс, InSales, Tilda, CS-Cart, самописная витрина и т. д.) уже умеет его выгружать. Отдельный фид «под нас» готовить не нужно — подходит тот же файл, что вы отдаёте в товарные площадки.

Что делает сервис с фидом

Ваш сайт                    Searchforce
──────────                  ─────────────────────────────────────────────
feed.xml  ──(HTTP GET)──▶   1. Скачивание фида по ссылке из проекта
   ▲                        2. Разбор XML (категории + офферы)
   │                        3. Сопоставление тегов фида с полями индекса
   └── обновляется          4. Индексация документов в поисковый движок
       по расписанию        5. Поиск, фасеты, автоподсказки ──▶ витрина/API

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

Ключевые понятия

Термин	Что это
Проект	Ваш каталог в сервисе. Хранит ссылку на фид, расписание обновления, настройки полей и поиска. У каждого проекта — свой изолированный индекс.
Оффер (<offer>)	Одно товарное предложение из фида — как правило, конкретный SKU (размер/цвет). Становится одним документом в индексе.
Поле (field)	Стандартный тег оффера (name, price, url, picture…) либо любой нестандартный тег. Сопоставляется с полем поискового документа.
Характеристика (<param>)	Произвольный атрибут товара (Цвет, Размер, Материал…). Используется для фасетов/фильтров и полнотекстового поиска.
Вид в фильтре	Картинка (образец цвета, ткани, принта) или код цвета, который фильтр показывает рядом со значением характеристики. Задаётся в фиде атрибутом picture у <param> — см. «Вид значений в фильтре».
Каноническая роль	Семантическая метка поля: Название, Цена, Ссылка, Категория, Изображение, Идентификатор. Через роли сервис понимает, «что есть что» в вашем фиде.
Группа SKU (group_id)	Объединяет варианты одного товара (разные размеры/цвета) в одну карточку в выдаче.

С чего начать

• Клиенту / контент-менеджеру — «Быстрый старт»: минимальный рабочий фид и подключение проекта за несколько шагов.
• Разработчику интеграции — «Каркас YML» и «Оффер»: точный контракт полей и атрибутов, которые читает парсер.
• Backend/фронтенд, работающему с выдачей — «Итоговый документ»: какие поля возвращает поиск.

Пример

В качестве наглядного примера в документации используется обезличенный фид интернет-магазина одежды (~2400 офферов, 24 категории, 16 характеристик). Полный разбор — в справочнике.