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

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

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

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

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

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

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

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

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

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

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

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

Расширение позволяет собирать отзывы покупателей — с карточки конкретного товара или сразу с нескольких товаров на странице каталога. Собранные данные отображаются в отдельной таблице отзывов.

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

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

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

1. Отзывы товара (карточка товара)

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

• Скорость: Зависит от количества вариантов товара и числа отзывов по каждому;
• Данные: Полный текст отзыва, оценка, автор, медиафайлы, достоинства и недостатки, ответ продавца — в зависимости от того, что поддерживает платформа (см. Данные отзывов);
• Рекомендация: Используйте этот режим, когда нужно детально изучить обратную связь по конкретной модели.

2. Отзывы товаров (каталог)

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

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

Лимит отзывов

По умолчанию расширение собирает до 50 отзывов на один товар. Вы можете изменить этот лимит или снять его полностью в разделе Настройки пользователя. На бесплатном тарифе лимит фиксирован и не поддаётся настройке.

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

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

• Сортировка: Нажмите на заголовок любой колонки, чтобы отсортировать данные по возрастанию или убыванию;
• Поиск: Используйте поле ввода над таблицей, чтобы отфильтровать товары по названию, бренду или артикулу;
• Копирование: Кнопка Копировать сохраняет все данные из таблицы в буфер обмена (можно сразу вставить в 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;
• Атрибуты работают в режиме Расширенные данные для списков товаров, а также для свех режимов парсинга карточки товара.

Настройки парсинга

В этом разделе настраивается поведение расширения при сборе данных.

Удалять дубликаты

Автоматически скрывает товары, которые повторяются в выдаче поиска или категории. Включена по умолчанию.

Лимит отзывов

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

Выберите «Все отзывы», чтобы снять ограничение и собирать все доступные отзывы. Учтите, что сбор большого количества отзывов значительно увеличивает время парсинга.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ozon

Wildberries

Lamoda

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

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

Скрытые по умолчанию колонки

Для всех режимов парсинга также доступны скрытые по умолчанию колонки:

Скрытые колонки можно в любой момент активировать в интерфейсе управления колонками.

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

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

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

Ozon

Wildberries

Lamoda

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

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

Скрытые по умолчанию колонки

Для всех режимов парсинга также доступны скрытые по умолчанию колонки:

Скрытые колонки можно в любой момент активировать в интерфейсе управления колонками.

Данные отзывов собираются в режимах Отзывы товара и Отзывы товаров. Результаты отображаются в отдельной таблице — каждая строка соответствует одному отзыву.

Набор доступных полей зависит от платформы: разные маркетплейсы предоставляют разный объём информации об отзывах.

Wildberries

Ozon

Lamoda

Скрытые по умолчанию колонки

Для всех платформ также доступна скрытая по умолчанию колонка:

Скрытые колонки можно в любой момент активировать в интерфейсе управления колонками.

Является ли расширение бесплатным?

Да, базовый функционал парсера Market Ninja полностью бесплатен для всех пользователей.

Какие сайты поддерживает парсер?

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

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

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

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

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

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

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

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

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

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

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

Безопасно ли использовать расширение?

Да, расширение работает только в вашем браузере, не собирает личные данные и проходит строгую проверку в Chrome Web Store.

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

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