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

Расширение Market Ninja позволяет собирать данные о товарах с маркетплейсов Ozon, Wildberries и Lamoda. Вы можете использовать его для:

• Мониторинга цен на товары (например, чтобы узнать, кто из продавцов демпингует);
• Сбора информации о характеристиках товаров (бренд, размеры, объем, страна производства и т.д.);
• Анализа ассортимента в категориях, поисковых запросах или брендах;
• Экспорта данных в удобные форматы для работы в Excel или других программах.

Расширение создано для пользователей, которые хотят быстро и просто получить данные без технических знаний. Это руководство объяснит, как установить, настроить и использовать расширение, а также как выбрать подходящий режим парсинга и экспортировать данные.

Как установить#

1. Откройте браузер Google Chrome или Ядекс Браузер;
2. Перейдите в интернет-магазин Chrome по ссылке на расширение;
3. Нажмите кнопку Добавить в Chrome;
4. В появившемся окне подтвердите установку, нажав Добавить расширение;
5. Дождитесь, пока расширение установится. Вы увидите значок расширения в правом верхнем углу браузера (обычно это пазл, где можно закрепить расширение).

Проверка установки#

1. Нажмите на значок расширений в Chrome (пазл в правом верхнем углу);
2. В появившемся списке найдите расширение Market Ninja;
3. Закрепите его для быстрого доступа, нажав на значок булавки рядом с ним.

Когда вы откроете расширение, вы увидите окно с несколькими основными элементами:

• Заголовок: Содержит логотип и название расширения, а также кнопки Настройки и Помощь.
• Информация о странице: Показывает название страницы, URL, иконку маркетплейса, а также количество доступных для парсинга страниц и товаров. Кнопка с лупой позволяет быстро вернуться к вкладке, на которой было открыто окно расширения.
• Панель управления:
  • Выпадающее меню для выбора режима парсинга:
    • Основные данные и Расширенные данные каталогов товаров, результатов поиска, а также списков товаров на странице продавца и бренда;
    • Только этот артикул и Все цвета и варианты для страницы с карточкой конкретного товара;
  • Кнопка Собрать данные для запуска сбора данных (или Остановить, если процесс идет);
  • Кнопка Удалить для удаления собранных данных;
  • Кнопка Копировать для копирования данных в буфер обмена;
  • Кнопка Экспорт с выпадающим меню для экспорта данных в формате Excel,CSV или JSON.
• Полоса прогресса: Появляется во время процесса парсинга, показывает сколько товаров обработано.
• Таблица данных: Отображает все собранные данные в табличном виде.

Расширение работает только на сайтах:

• Ozon (ozon.ru)
• Wildberries (wildberries.ru)
• Lamoda (lamoda.ru)

Вы можете собирать данные с четырех типов страниц:

1. Страницы товара: Карточка конкретного товара (например, шампуня или кроссовок).

   • Карточка товара Шапка докер ALEKON Жак-Ив Кусто на Ozon;
   • Карточка товара Набор шампунь и бальзам для волос женский бессульфатный на Wildberries;
   • Карточка товара Кеды Converse Chuck Taylor All Star на Lamoda.

2. Категория: Страница со списком товаров в определенной категории (например, Женская обувь).

   • Страница категории Женские купальники на Ozon;
   • Страница категории Женские купальники на Wildberries;
   • Страница категории Женские купальники на Lamoda.

3. Поиск: Результаты поиска по ключевому слову (например, кроссовки Nike).

   • Результаты поиска по запросу кроссовки Nike на Ozon;
   • Результаты поиска по запросу кроссовки Nike на Wildberries;
   • Результаты поиска по запросу кроссовки Nike на Lamoda.

4. Страница бренда: Список товаров определенного бренда (например, все товары Adidas).

   • Страница бренда Adidas на Ozon;
   • Страница бренда Adidas на Wildberries;
   • Страница бренда Adidas на Lamoda.

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

Как запустить сбор#

1. Перейдите на страницу списка товаров (например, в категорию Женские купальники на Wildberries);
2. Откройте расширение;
3. В выпадающем списке выберите режим парсинга (см. ниже);
4. Нажмите кнопку Собрать данные.

Режимы парсинга#

1. Основные данные#

Расширение проходит по страницам каталога (пагинации) и собирает данные о товарах.

• Скорость: Высокая (сотни товаров в минуту);
• Данные: только основная информация (см. в разделе Списки товаров);
• Ограничения: В этом режиме недоступны детальные характеристики (состав, страна производства и прочие).

2. Расширенные данные#

Расширение сначала собирает список товаров, а затем "проваливается" в карточку каждого товара, чтобы собраться полную информацию.

• Скорость: Не высокая, так как делается отдельный запрос на каждый товар;
• Данные: Всё, что есть в Основных данных, а также детальные характеристики и настроенные кастомные атрибуты;
• Рекомендация: Используйте этот режим, когда критически важно собрать максимально полные данные о товарах.

Ограничения#

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

Этот сценарий используется, когда вам нужно проанализировать конкретный товар и его варианты.

Как запустить сбор#

1. Откройте страницу конкретного товара;
2. Запустите расширение;
3. Выберите режим парсинга;
4. Нажмите кнопку Собрать данные.

Режимы парсинга#

1. Только этот артикул#

Моментально собирает данные только о текущем выбранном цвете/размере товара, который вы видите на экране.

2. Все цвета и варианты#

Собирает данные о текущем товаре, а также обо всех его вариациях (другие цвета, модели в этой же карточке).

• Как это работает: Расширение находит ссылки на другие цвета в карточке и по очереди собирает данные о каждом из них.
• Результат: В таблице появится несколько строк — по одной на каждый вариант товара. Это удобно для анализа ассортимента одной модели.

После того как данные собраны, они отображаются в таблице внутри расширения.

Управление таблицей#

• Сортировка: Нажмите на заголовок любой колонки, чтобы отсортировать данные по возрастанию или убыванию;
• Поиск: Используйте поле ввода над таблицей, чтобы отфильтровать товары по названию, бренду или артикулу;
• Копирование: Кнопка Копировать сохраняет все данные из таблицы в буфер обмена (можно сразу вставить в Google Таблицы или Excel через Ctrl+V).

Экспорт данных#

Нажмите кнопку Экспорт, чтобы выбрать формат:

1. XLSX (Excel) — лучший выбор для большинства задач. Файл сразу готов к работе, числа и цены имеют правильный формат;
2. CSV — универсальный текстовый формат. Подходит для импорта в базы данных или сторонние программы;
3. JSON — формат для разработчиков и интеграций.

Расширение Market Ninja позволяет гибко настроить собираемые данные и формат выгрузки. Чтобы попасть в настройки, нажмите на кнопку Настройки в верхней части окна расширения или кликните правой кнопкой мыши по иконке расширения и выберите Параметры.

Экран настроек разделен на две секции: Атрибуты и Экспорт.

Настраиваемые атрибуты#

По умолчанию расширение собирает стандартный набор данных (цена, бренд, рейтинг и т.д.). Однако у товаров на маркетплейсах тысячи различных характеристик (например, Вес упаковки, Материал подошвы, Тип кожи и мноие другие).

Вы можете добавить свои собственные колонки в таблицу данных, указав, какие характеристики необходимо собирать на карточке товара.

Как добавить атрибут:#

1. Нажмите кнопку Добавить атрибут;
2. Название колонки: Введите название, которое будет отображаться в шапке вашей таблицы (например, Страна);
3. Ключи для маркетплейсов: Для каждого сайта укажите точное название характеристики, как она написана в карточке товара на сайте.

Пример настройки:#

Допустим, вы хотите собрать информацию о составе одежды.

1. Название колонки: Введите Состав;
2. Wildberries: Введите Состав;
3. Ozon: Введите Состав материала (так это поле часто называется на Ozon);
4. Lamoda: Введите Состав или Состав, %.

Ограничения#

• Максимальное количество кастомных атрибутов: 3;
• Атрибуты работают в режиме Расширенные данные для списков товаров, а также для свех режимов парсинга карточки товара.

Настройки экспорта#

В этом разделе вы можете управлять тем, как данные будут выглядеть в выгруженных файлах (Excel, CSV, JSON).

Очистка текста#

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

1. Удалять переносы строк

   • Что делает: Заменяет все переносы строк (Enter) на пробелы;
   • Зачем нужно: Важно для CSV и Excel файлов, чтобы одна ячейка с длинным описанием не разрывала строки и не ломала структуру таблицы.

2. Удалять HTML теги

   • Что делает: Полностью удаляет программный код (HTML-теги) из текста;
   • Зачем нужно: Полезно при сборе Rich-контента или описаний с Ozon, чтобы получить чистый читаемый текст без мусора.

Управление настройками#

• Сохранить: Применяет изменения. Кнопка активна только если вы внесли правки и все поля заполнены корректно;
• Сбросить: Возвращает все настройки к значениям по умолчанию (удаляет ваши кастомные атрибуты).

К спискам товаров относятся страницы результатов поиска, категорий товаров, брендов и списки товаров на странице продавца (селлера).

Расширение поддерживает два режима парсинга списков товаров: Основные данные и Расширенные данные. Режимы отличаются по объему собираемых данных и скорости работы.

Режим парсинга: Основные данные#

Что собирает: Только основные данные о товарах, которые, отображаются на страницах списков товаров.

Ozon#

Wildberries#

Lamoda#

Режим парсинга: Расширенные данные#

Что собирает: Все данные из режима парсинга карточки товара Только этот артикул.

Данные с карточки товара можно собирать в двух режимах: Только этот артикул и Все цвета и варианты.

Режим парсинга: Только этот артикул#

Что собирает: Характеристики товара и другие данные только для одного артикула.

Ozon#

Wildberries#

Lamoda#

Режим парсинга: Все цвета и варианты#

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

Почему парсинг идет медленно?#

В режиме Расширенные данные расширение делает отдельный запрос к каждому товару. Чтобы маркетплейс не заблокировал вас за подозрительную активность, мы намеренно добавляем случайные задержки между запросами. Это обеспечивает безопасность работы.

Данные не собираются#

Это может произойти, например, если сайт маркетплейса запросил проверку на робота (капчу).

1. Остановите парсинг;
2. Обновите страницу маркетплейса;
3. Если появится капча — пройдите её вручную;
4. Запустите расширение снова.

Почему собираются не все товары из категории?#

Маркетплейсы (Ozon, Wildberries, Lamoda) технически ограничивают количество товаров, доступных для просмотра в поисковой выдаче или категории. Даже если сайт пишет, что Найдено 50 000 товаров, пользователю (и расширению) для просмотра доступны только первые несколько тысяч.

Это легко проверить, перейдя на последнюю страницу в каком-либо каталоге. Например, в разделе бренда Adidas на Wildberries представлено более 100 000 товаров, но последней страницей в категории является 100-ая.

Можно ли закрыть окно расширения во время работы?#

Нет. Процесс сбора данных работает внутри открытого окна. Если его закрыть, парсинг остановится. Вы можете переключаться на другие окна (Alt+Tab), но не закрывайте само всплывающее окно расширения.

Поддерживаются ли другие сайты?#

На данный момент поддерживаются только Wildberries, Ozon и Lamoda. На других сайтах расширение покажет сообщение Сайт не поддерживается. Подробнее об этом читайте в разделе Поддерживаемые сайты.

Обратная связь#

Нашли ошибку или есть идея для функции? Напишите нам в Telegram.