Парсер цен Яндекс.Маркет

Поддерживаемые форматы заданий:

JSON ( в том числе через API), XLS/CSV, стандартные выгрузки для яндекс-маркета (XLS, XML/YML).


Как отправить задание:

разовые задания

Для отправки файла с заданием любого формата используйте форму отправки либо виджет справа.
В селекторе выберите “Задание по запросу”
Там же находится информация об оставшихся проверках на балансе.
Свяжитесь с нами, если Вам удобнее отправлять файлы с заданиями по почте.

задания по расписанию

Для установки задания по расписанию используйте форму отправки.
В селекторе выберите “Задание по расписанию”
Потребуется прямая ссылка на файл с заданием.
При обновлении файла по ссылке будет, естественно, загружаться обновленная версия.
Облачные ссылки вроде Google-disk или Yandex-disk не поддерживаются.


Какие задачи выполняет сервис parser.market:

Ниже подробнее рассмотрены все варианты, показаны примеры заполнения файла-задания.

Если возникают вопросы по заполнению файла-задания – напишите в поддержку support@parser.market
Приложите к письму прайс-лист, мы составим пример файла-задания на основе ваших данных.

1. автоматический поиск карточки товара по товарной позиции вашего прайс-листа и вывод предложений в карточке:

Поддерживаются 2 типа файлов-заданий:

1-1. Если Вы уже торгуете на Яндекс-маркете, можете просто сделать свою обычную выгрузку в привычном формате.
Это может быть YML или CSV, либо XLS, большие файлы можно упаковать в архив ZIP.
Просто отправьте эту выгрузку через форму на сайте и дождитесь результатов.
достоинства: никаких дополнительных настроек, можно начать мониторинг “здесь и сейчас”.
недостатки: не поддерживает дополнительные возможности

1-2. Составить задание, сгенерировав файл JSON или же заполнив файл EXCEL по образцу (скачать образец файла-задания).
Файл EXCEL может быть формата EXCEL (*.xls или *.xlsx), CSV либо CSV с расширением *.txt – важно сохранение заголовков в файле.
Структура JSON аналогична, пример – на этой странице.
достоинства: поддерживает возможности, описанные в пунктах 2-6
недостатки: требуются дополнительная подготовка выгрузки

Важно:

  • обязательно сохраняйте заголовки в файле-задании – первой строкой и в том же порядке, что и в образце!
  • поле “name” не должно быть пустым!

Если какие-то колонки пустые – в CSV файле должно стоять пустое значение, примеры:

CSV:

category;code;productid;brand;name;linkset;marketid;price;donotsearch;textsearch
;Пример-001;TDA 2320;Bosch;Утюг;;;0;;
;Пример-002;;;Утюг Bosch TDA 2320;;;0;;

EXCEL:

Автоподбор карточки в большинстве случаев сокращает трудозатраты на их ручной поиск, но не дает 100% точности результатов.

Почему это происходит – подробнее на этой странице.

Скорректировать карточку для системы можно, указав правильную карточку в следующем заказе и отправив задание способом 2, 3, 4 или 5.
Однажды скорректированная карточка запоминается системой и будет использована в следующий раз, если не менялось название, код, артикул или бренд.

2. вывод предложений по заданному Вами id карточки:

Если Вам известен id карточки товара, по которой требуется провести мониторинг цен, укажите id карточки в поле marketid:
Система пропустит этап подбора карточек и запомнит указанную в заказе.

Поддерживаются только вариант файла-задания по образу (скачать образец файла-задания):

3. вывод предложений по заданной Вами ссылке на карточку:

Карточку можно также указать ссылкой на нее в поле linkset:

Ссылки могут быть как на страницу с описанием:

https://market.yandex.ru/product–skladnaia-emkost-dlia-letnego-dusha-200-litrov-90-90-35/870860135?cpa=1

так и на страницу с предложениями:

https://market.yandex.ru/product–skladnaia-emkost-dlia-letnego-dusha-200-litrov-90-90-35/870860135/offers?cpa=1&grhow=supplier&how=aprice&local-offers-first=0

4. вывод предложений по нескольким карточкам:

В случае, если для вашего товара на маркете есть несколько карточек – для адекватного представления о ценах может потребоваться мониторить все.

Для того, чтобы получить результаты мониторинга по нескольким карточкам, укажите в поле linkset несколько карточек через пробел:

Обратите внимание, ссылки должны быть именно на карточку товара!
В приведенном примере ссылки, выделенные красным, будут проигнорированы.

Предложения с нескольких карточек будут сведены в один результат и отсортированы по возрастанию цены.

5. уточнение характеристик товара внутри карточки:

Необходимо, когда в одной карточке с фильтрами собран товар с разными характеристиками:

Оба товара на примере – в одной карточке, при этом – естественно, разные позиции прайс-листа.
Для адекватных результатов, очевидно, требуется уточнение.
Подробнее – ниже на странице в разделе “Тонкие настройки

6. уточненный запрос:

Внимание: выбирается первая карточка товара, показанная поиском Яндекс-маркета.

Этот вариант может пригодиться, если поиск карточки осуществляется, например, по штрих-коду и Вы уверены в 100%-м результате.


Поля в заголовках файла задания

(данный раздел относится к варианту EXCEL и CSV, образец задания – скачать)

1. поля идентификации

  • category – категория товара, в случае, если у Вас есть подкатегории – можно использовать удобный Вам разделитель, например “|”.
  • code – уникальный код товара в вашей системе, иногда совпадает с артикулом, дублировать артикул в поле code не нужно.

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

2. поля поиска

productid – общепринятый артикул, не путайте его с кодом!
brand – бренд товара
name – наименование товара, обязательное поле

Поля, отмеченные синим, формируют запрос на поиск карточки товара, например, “Утюг Bosch TDA 2320”.
Если поля productid и brand не заполнены, крайне желательно, чтобы общепринятый артикул и бренд товара присутствовали в названии.
Важно: не путайте code (код товара в вашей системе – зачастую просто порядковый номер) и productid – общепринятый артикул или модель товара!
Если бренд и артикул уже содержатся в наименовании товара, например, Электронная книга PocketBook 632, специально дублировать их в отдельных полях не нужно.
Важно, чтобы бренд и название были как можно ближе к общепринятому написанию, в идеале – к наименованию товара в той карточке, где Вы хотели бы видеть свой товар.

3. уточняющие поля

price – используется для заполнения колонки “позиция цены” в отчете EXCEL.
linkset – ссылка или ссылки на карточку товара, если заполнено – marketid игнорируется
marketid – прямое указание на карточку товара, состоит только из цифр.
donotsearch – если “1” – система не будет искать новую карточку даже при ошибке 404.
textsearch – текстовый запрос для метода “получение результатов из поиска”.
Если название в прайс-листе подходит для поискового запроса – продублируйте название.
Если поле textsearch непустое – linkset и marketid игнорируются.

4. порядок использования полей

  1. textsearch
    Если непустое – система выдает результаты поиска на Яндекс-маркете.
    Поля linkset, marketid, donotsearch при этом игнорируются.
  2. linkset – производится поиск по ссылке/ссылкам, поля marketid, donotsearch при этом игнорируются.
  3. marketid – вывод результатов по заданной карточке товара
    Это несколько ограниченный вариант в сравнении с предыдущим, но у многих в базах накоплен массив id.


Тонкие настройки:

Пояснения по полю marketid:

Поле marketid – это идентификатор карточки товара, состоит только из цифр. Пример id карточки в адресной строке браузера:

https://market.yandex.ru/product–kofemolka-bosch-mkm-6000-6003/116335/offers?cpa=1&how=aprice&grhow=supplier&lr=213&local-offers-first=0

Пример заполнения:

categorycodeproductidbrandnamelinksetmarketidpricedonotsearchtextsearch
МБТ | КофемолкиПример-005MKM 6000BoschКофемолка116335

При заполнении поля в первом заказе система пропускает поиск карточек и собирает данные непосредственно из указанной.
Это ускоряет процесс обработки прайс-листа и уменьшает вероятность ошибок.
Система запоминает id карточки и в дальнейших заказах, даже если он не указан.
Если указано – система перезаписывает имеющийся в базе id карточки и в дальнейшем ориентируется уже на новую.
Таким образом делается корректировка id карточки в системе.

Если новая карточка приводит к ошибке 404 – система начинает поиск карточки, как если бы она не была указана.

Фильтры и сводный отчет по нескольким карточкам – пояснения по полю linkset:

Поле linkset (набор ссылок) незаменимо в сложных случаях, когда поиск карточек, соответствующих вашему товару заведомо приведет к некорректным, либо, как минимум – неполным результатам.

Пример 1 – карточек слишком мало (фильтры)

Товар: Кофе в зернах Lavazza Oro 250 грамм

Система в данном случае находит подходящую карточку с id 168903162 – https://market.yandex.ru/product–kofe-v-zernakh-lavazza-qualita-oro/168903162?cpa=1

В этой карточке 102 предложения, из которых подходящих – всего 20, остальное – кофе в пакетах по 500 и 100 грамм, есть еще предложения упаковок по 2 и 4 штуки.
Результаты по найденной карточке будут содержать излишние данные и неверные данные по минимальной цене (если нужно отследить цены на упаковку 500гр)

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

После чего, скопировать ссылку в адресной строке браузера и вставить ее в поле linkset:

categorycodeproductidbrandnamelinksetmarketidpricedonotsearchtextsearch
     Кофеhttps://market.yandex.ru/product–kofe-v-zernakh-lavazza-qualita-oro/168903162/offers?glfilter=23674510%3A250~250_100419608814&cpa=1&how=aprice&grhow=supplier&local-offers-first=0&sku=100419608814    

В полученных результатах останется только нужный Вам товар,

Если, помимо этого, в Яндекс-маркете присутствую и другие карточки на этот же товар – этот метод можно комбинировать с пунктом “Пример 2”

Пример 2 – карточек слишком много (сводный отчет по нескольким карточкам)

Товар: Мягкий бак для душа EKUD 200 л. На момент написания текста этому товару соответствует как минимум 4 карточки на яндекс-маркете:

ЦенаПродавецСсылка
2285Благодатный мирhttps://market.yandex.ru/product–miagkii-bak-dlia-dusha-ekud-200-l/1458514945?cpa=1
2550Техмосhttps://market.yandex.ru/product–miagkii-bak-ekud-dlia-dusha-200-litrov/2000414863824?cpa=1
2290Умная Техникаhttps://market.yandex.ru/product–emkost-dlia-letnego-dusha-ekud-200-l/101485615730?cpa=1
2290EKUDhttps://market.yandex.ru/product–skladnaia-emkost-dlia-letnego-dusha-200-litrov-90-90-35/870860135?cpa=1

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

Чтобы система выполнила мониторинг всех этих карточек, нужно собрать эти ссылки в поле linkset таким образом:

categorycodeproductidbrandnamelinksetmarketidpricedonotsearchtextsearch
     Товар: Мягкий бак для душа EKUD 200 л.https://market.yandex.ru/product–miagkii-bak-dlia-dusha-ekud-200-l/1458514945?cpa=1 https://market.yandex.ru/product–miagkii-bak-ekud-dlia-dusha-200-litrov/2000414863824?cpa=1 https://market.yandex.ru/product–emkost-dlia-letnego-dusha-ekud-200-l/101485615730?cpa=1 https://market.yandex.ru/product–skladnaia-emkost-dlia-letnego-dusha-200-litrov-90-90-35/870860135?cpa=1    

Для этого открываете нужную страничку карточки (описание товара либо список предложений в карточке), копируете ссылку в адресной строке браузера и вставляете в поле linkset.

Важно: Ссылки должны начинаться с “https://” и отделяться друг от друга пробелами (собрать их из разных ячеек в EXCEL поможет формула вида =F14&” “&F15&” “&F16&” “&F17)
Ссылки должны быть именно на карточки товара (product), а не на предложения (offer), результаты поиска (search) или каталог (catalog).

Результаты будут отсортированы по цене. Неверные (ошибочные) ссылки отбрасываются.

Так же, как и с полем marketid, сведения о фильтрах запоминаются системой и будут использованы в следующем задании, даже если они не указаны.
Это дает возможность один раз подкорректировать фильтры по товару, и в дальнейших заданиях использовать выгрузки XML или EXCEL для яндекс-маркета.
(запоминание ссылок и фильтров пока в стадии открытого тестирования, поэтому замечания и предложения приветствуются, как и всегда)

Как понять, понадобится ли указание ссылок?

Если В прайс-листе много позиций, просматривать сразу все – это слишком долго. Рекомендуется в первый раз запустить поиск в автоматическом режиме.
В отчете EXCEL обратите внимание на графу “Фильтры”

В этой графе отображается информация о фильтрах, присутствующих в карточке товара, а именно: название фильтров и единица измерения (как в карточке товара).
Если фильтры представляются Вам значимыми для результатов (кому-то не важен, например, цвет товара) – это означает, что требуются вышеописанные уточнения.

В карточке подробных сведений тоже есть информация о фильтрах (в квадратных скобках), помимо названия фильтра и единицы измерения есть их значения в предложении магазина:

Некоторые предложения скрыты для компактности

В примере на этой картинке продавец вообще не указал сведения о цвете товара, конфигурация не указана в фильтрах предложений, при этом указана в описаниях и фильтруется.

Если в карточке немного предложений – возможно, стоит задуматься о мониторинге по нескольким карточкам.
Проверить это Вам поможет список дополнительных карточек:

Тут можно посмотреть, найдены ли системой похожие карточки товара (есть название в карточке, id карточки, ссылка на карточку). Если есть – рекомендуется также поискать ссылки вручную, поскольку в списке могут быть не все подходящие карточки.