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

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
недостатки: требуются дополнительная подготовка выгрузки

Если какие-то колонки пустые — в 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

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

При заполнении поля в первом заказе система пропускает поиск карточек и собирает данные непосредственно из указанной.
Это ускоряет процесс обработки прайс-листа и уменьшает вероятность ошибок.
Система запоминает 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:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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