Как добавить магазин

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

Написать о магазине

С чего начать

Напишите нам через форму обратной связи с темой «Магазин» и оставьте контакт для ответа. В сообщении укажите:

название магазина и ссылку на раздел винила;
ссылку на YML, Excel или CSV, если выгрузка уже есть;
примерное число позиций и как часто обновляются цены и наличие;
ограничения на частоту обхода или использование фотографий.

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

Три способа подключиться

Лучший вариант

Фид YML

Файл в формате Яндекс Маркета по постоянной ссылке. Если в нём есть все данные, обновляем цены и наличие без обхода карточек товаров. Обычно читаем раз в сутки.

Если фида нет

Выгрузка файлом

Excel или CSV по постоянной ссылке с понятными названиями колонок. Разберём вашу выгрузку при подключении. Через Excel подключён «Звуковой барьер».

Если нет выгрузки

Обход сайта

Бот читает страницы каталога по одной, с паузами. Скорость зависит от размера каталога и интервала запросов, а точность — от полноты данных на страницах.

Какие данные нужны

Обязательно

название позиции — артист и альбом
текущая цена в рублях
наличие: на складе, предзаказ, распродано или нужно уточнить
ссылка, по которой можно открыть именно эту позицию в магазине

Для точного издания и деталей предложения

штрихкод
каталожный номер и лейбл
страна и год издания
формат: LP, 2LP, 7", цвет винила
состояние пластинки и конверта, новое или б/у
фото товара, в том числе оборот и детали экземпляра

Штрихкод, каталожный номер вместе с лейблом и другие атрибуты помогают найти конкретное издание. Если данных для уверенного сопоставления недостаточно, предложение показывается на странице альбома с пометкой «издание не уточнено». Неизвестные поля можно оставить пустыми.

YML: рекомендуемые поля

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

Скачать пример YML — полный файл с новой пластинкой, проданным б/у экземпляром и предзаказом. Данные в нём вымышлены.

Поля и правила для разработчика

Используйте обычную структуру YML: yml_catalog, shop, валюты, категории и offers. В offer нужны стабильный id, url, name, price, currencyId со значением RUB и categoryId. В available укажите true, если товар на складе, и false, если его нет.

ID сохраняется при изменении цены и пополнении остатков. Разным изданиям и отдельно продаваемым б/у экземплярам нужны разные ID. Цена — за указанную позицию, с учётом скидки, без доставки. В выгрузке по постоянной ссылке должен быть полный ассортимент, который вы передаёте vyndex, а дата формирования файла должна обновляться вместе с данными.

Дополнительные параметры для vyndex
Имя param	Что передавать
Исполнитель	Артист отдельно от названия альбома
Альбом	Название альбома без артиста, цены и состояния
Лейбл	Лейбл этого издания
Каталожный номер	Номер издания на обложке или лейбле; не внутренний артикул магазина
Страна издания	Страна этого издания
Год издания	Год конкретного тиража; не год первого выхода альбома
Формат	LP, 2LP, 7", 12"; для комплекта, например, 2LP+CD
Новая	true — новая, false — б/у; пропустите, если неизвестно
Состояние пластинки	Грейд носителя: M, NM, EX+, EX, EX-, VG+, VG, VG-, G+, G, F или P
Состояние конверта	Грейд конверта по той же шкале; если неизвестен — пропустите
Наличие	in_stock, preorder, out_of_stock или unknown; уточняет атрибут available для vyndex

<param name="Исполнитель">Пример ансамбля</param>
<param name="Альбом">Первый альбом</param>
<param name="Формат">LP</param>
<param name="Новая">true</param>

Штрихкод передавайте обычным тегом barcode, сохраняя ведущие нули. Если его нет, пропустите поле. Фотографии передавайте отдельными picture с абсолютными ссылками: первая — основная, следующие — галерея этой позиции. Принимаем до 40 разных снимков.

Для предзаказа добавьте <param name="Наличие">preorder</param>. Если наличие нужно уточнять — unknown. Этот параметр имеет приоритет над available. При распродаже поставьте available="false" и уберите прежнее уточнение наличия либо замените его на out_of_stock. Для наличия и предзаказа обязательна текущая цена больше нуля.

Старую запись <param name="Состояние">NM/EX+</param> тоже понимаем: сначала пластинка, затем конверт. Отдельное состояние конверта имеет приоритет над второй частью этой строки. Признак Новая независим от грейда: новая пластинка не обязана иметь оценку M. Неизвестные значения пропускайте.

Названия дополнительных параметров в таблице — рекомендации vyndex. Сам механизм param предусмотрен в документации YML.

Как работает бот

При обходе сайта бот представляется VyndexBot/0.1 (+https://vyndex.ru/bot), уважает robots.txt, включая Crawl-delay, и делает запросы к одному сайту последовательно, с паузой — обычно две секунды, а если магазин просит реже, то реже. Обычно обновление запускается раз в сутки; большие каталоги с длинными паузами могут обновляться реже. Карточки для уточнения издания и фото дочитываются порциями в течение дня. При сборе каталога сохраняем ссылки на фотографии.

Из карточки берём только факты о товаре: название, цену, наличие, атрибуты издания и ссылку на позицию. Описания не копируем. Фотографии показываем рядом с предложением и в его галерее с указанием магазина. Фото товара также может стать обложкой альбома, если её нет в открытых источниках. Изображения могут загружаться при показе посетителю и для обложки. Если вы против использования фото, напишите нам.

Изменить частоту или отключить

Напишите нам — поднимем интервал, перейдём на фид или уберём магазин из каталога. Остановить бота можно и без обращения — правилом в robots.txt:

User-agent: VyndexBot
Disallow: /

Перед новым обходом проверяем правила; сохранённую копию robots.txt используем до суток. Уже начатый обход использует правила с момента запуска. Если нужно остановить его срочно, напишите нам.