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

Руководство по использованию расширения Market Ninja

Напишите нам

1. Введение

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

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

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

⚠️ По любым вопросам, предложениям и жалобам — используйте форму обратной связи.

2. Установка расширения

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

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

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

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

3. Интерфейс расширения

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

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

Если вы открыли расширение на неподдерживаемом сайте (например, не Wildberries или Lamoda), вы увидите сообщение: "Этот сайт не поддерживается". Если возникла ошибка (например, слишком много запросов к сайту), появится сообщение с описанием проблемы.

4. Поддерживаемые сайты и типы страниц

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

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

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

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

Быстрый сбор данных (Quick Parsing)

Что собирает: Основные данные о товарах, такие как:

Быстрый сбор данных Ozon

Параметр (En) Параметр (Ru) Описание
SKUАртикулАртикул товара (уникальный идентификатор на маркетплейсе).
NameНазваниеПолное наименование товара.
Old PriceСтарая ценаЦена до применения скидок (перечеркнутая).
PriceЦенаТекущая цена товара.
Special PriceСпец. ценаЦена с дополнительной скидкой (например, скидка за оплату по карте Ozon).
RatingРейтингСредний рейтинг товара по отзывам (1-5).
ReviewsОтзывыКоличество отзывов о товаре.
ThumbnailКартинкаURL основного (превью) изображения товара.
URLURLПолный URL карточки товара.

Быстрый сбор данных Wildberries

Параметр (En) Параметр (Ru) Описание (RU)
SKUАртикулАртикул товара (уникальный идентификатор на маркетплейсе).
BrandБрендНазвание бренда товара.
NameНазваниеПолное наименование товара.
Old PriceСтарая ценаЦена до применения скидок (перечеркнутая).
PriceЦенаТекущая цена товара (со скидкой СПП).
Special PriceСпец. ценаЦена с дополнительной скидкой (WB Кошелек для неавторизованного пользователя).
ColorЦветЦвет товара.
PromoАкцияТекст рекламной акции.
RatingРейтингСредний рейтинг товара по отзывам (1-5).
ReviewsОтзывыКоличество отзывов о товаре.
ImagesКол-во картинокКоличество изображений в карточке товара.
SellerПродавецНаименование продавца.
Seller IDID продавцаУникальный идентификатор продавца на маркетплейсе.
Seller RatingРейтинг продавцаРейтинг продавца.
FulfillmentСхемаСхема работы продавца (FBO - со склада маркетплейса, FBS - со склада продавца).
QuantityКоличествоОбщее количество товара на складах.
ViewsПросмотрыПросмотры карточки товара.
ThumbnailКартинкаURL основного (превью) изображения товара.
URLURLПолный URL карточки товара.
SizeРазмерДоступные размеры товара (техническое название, через запятую).
Size LabelНазвание размераДоступные размеры товара (как указано у бренда/продавца, через запятую).

Быстрый сбор данных Lamoda

Параметр (En) Параметр (Ru) Описание
SKUАртикулАртикул товара (уникальный идентификатор на маркетплейсе).
BrandБрендНазвание бренда товара.
NameНазваниеПолное наименование товара.
CategoryКатегорияКатегория, в которой размещен товар.
ColorЦветЦвет товара.
Old PriceСтарая ценаЦена до применения скидок (перечеркнутая).
PriceЦенаТекущая цена товара.
Special PriceСпец. ценаЦена с дополнительной скидкой (например, скидка за лояльность для неавторизованного пользователя).
RatingРейтингСредний рейтинг товара по отзывам (1-5).
ReviewsОтзывыКоличество отзывов о товаре.
Seller IDID продавцаУникальный идентификатор продавца на маркетплейсе.
FulfillmentСхемаСхема работы продавца (FBO - со склада маркетплейса, FBS - со склада продавца).
ImagesКол-во картинокКоличество изображений в карточке товара.
QuantityКоличествоОбщее количество товара на складах (максимальное значение остатков, которое указывает Lamoda — 20).
ThumbnailКартинкаURL основного (превью) изображения товара.
URLURLПолный URL карточки товара.
SizeРазмерДоступные размеры товара (техническое название, через запятую).
Size LabelНазвание размераДоступные размеры товара (как указано у бренда/продавца, через запятую).

☝ Если вам необходимо выгружать дополнительные характеристики — заполните форму обратной связи.

Скорость: Быстрее, так как собирает только базовую информацию.

Когда использовать:

  • Если вам нужны основные данные для быстрого анализа.
  • Если вы парсите большие категории с сотнями товаров.
  • Если вы хотите сэкономить время.

Пример: Вы хотите узнать текущие цены на все кроссовки в категории на Wildberries.

Детальный сбор данных (Deep Parsing)

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

Детальный сбор данных Ozon

Параметр (en) Параметр (ru) Описание (RU)
BrandБрендНазвание бренда товара.
ColorЦветЦвет товара.
CategoryКатегорияКатегория, в которой размещен товар.
SizeРазмерДоступные размеры товара (техническое название, через запятую).
Size LabelНазвание размераДоступные размеры товара (как указано у бренда/продавца, через запятую).
SellerПродавецНаименование продавца.
Seller IDID продавцаУникальный идентификатор продавца на маркетплейсе.
QuestionsВопросыКоличество вопросов о товаре.
CollectionКоллекцияНазвание коллекции товара.
VolumeОбъемОбъем товара (например, для жидкостей).
SeasonСезонСезон товара.
FabricСоставСостав товара.
OriginСтрана производительСтрана производства товара.
ImagesКол-во картинокКоличество изображений в карточке товара.
VideosКол-во видеоКоличество видео в карточке товара.
Video CoverВидеообложкаСсылка на видеообложку.

Детальный сбор данных Wildberries

Параметр (En) Параметр (Ru) Описание (RU)
DescriptionОписаниеОписание товара.
Seller SKUАртикул поставщикаАртикул товара поставщика.
SeasonСезонСезон товара.
FabricСоставСостав товара.
OriginСтрана производительСтрана производства товара.
VolumeОбъемОбъем товара (например, для жидкостей).
CategoryКатегорияКатегория, в которой размещен товар.

Детальный сбор данных Lamoda

Параметр (en) Параметр (ru) Описание (RU)
Seller SKUАртикул поставщикаАртикул товара поставщика.
CollectionКоллекцияНазвание коллекции товара.
DescriptionОписаниеОписание товара.
QuestionsВопросыКоличество вопросов о товаре.
VolumeОбъемОбъем товара (например, для жидкостей).
SeasonСезонСезон товара.
FabricСоставСостав товара.
OriginСтрана производительСтрана производства товара.

☝ Если вам необходимо выгружать дополнительные характеристики — заполните форму обратной связи.

Скорость: Медленнее, так как делает дополнительные запросы к сайту для получения детальной информации.

Когда использовать:

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

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

Рекомендации:

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

6. Инструкция по использованию расширения

Шаг 1: Открытие расширения

  1. Откройте Google Chrome и перейдите на страницу Wildberries или Lamoda, которую хотите спарсить (например, карточку товара, категорию, поиск или бренд).
  2. Нажмите на значок расширения в правом верхнем углу браузера (если вы закрепили расширение, это будет его иконка; иначе найдите его через значок пазла).
  3. В открывшемся окне вы увидите информацию о текущей странице:
    • Название страницы (например, "Кроссовки Nike Air Max").
    • URL страницы.
    • Количество доступных для парсинга страниц и товаров.

☝ Wildberries позволяет собирать данные только с 50 страниц в любой категории.

⚠️ Если вы видите сообщение "Этот сайт не поддерживается", значит, вы находитесь не на Wildberries или Lamoda. Перейдите на правильный сайт.

Шаг 2: Выбор режима парсинга

  1. В панели управления найдите выпадающее меню (оно показывает "Быстрый сбор данных" или "Детальный сбор данных").
  2. Выберите нужный режим:
    • Быстрый сбор данных для базовых данных.
    • Детальный сбор данных для полной информации.
  3. Если парсинг уже идет, меню будет заблокировано. Дождитесь завершения или остановите процесс.

Шаг 3: Запуск парсинга

  1. Нажмите кнопку "Собрать данные" в панели управления.
  2. Если кнопка неактивна, проверьте:
    • Находитесь ли вы на поддерживаемой странице (Wildberries или Lamoda).
  3. После запуска вы увидите полосу прогресса, показывающую, сколько товаров обработано.
  4. Для категорий или поиска расширение автоматически обработает все доступные страницы (например, все товары в категории).

Шаг 4: Остановка парсинга

  1. Если вы хотите прервать процесс (например, собрали достаточно данных), нажмите кнопку "Остановить".
  2. Парсинг остановится, и вы увидите данные, собранные до этого момента.
  3. Полоса прогресса исчезнет, и кнопка снова станет "Собрать данные".

Шаг 5: Просмотр результатов

  1. После завершения парсинга (или его остановки) данные появятся в таблице внизу окна.
  2. Прокрутите таблицу вправо или вниз, чтобы увидеть все столбцы и товары.

Шаг 6: Экспорт данных

Вы можете сохранить собранные данные в трех форматах: JSON, CSV или скопировать в буфер обмена.

Экспорт в JSON

  1. Нажмите кнопку "Экспорт" в панели управления.
  2. В выпадающем меню выберите "JSON".
  3. Браузер начнет загрузку файла products.json.
  4. Найдите файл в папке загрузок на вашем компьютере.

JSON подходит для разработчиков или программ, которые работают с данными в этом формате.

Экспорт в CSV

  1. Нажмите кнопку "Экспорт" и выберите "CSV".
  2. Браузер загрузит файл products.csv.
  3. Откройте файл в Excel, Google Таблицах или другой программе для работы с таблицами.

CSV удобен для анализа данных, создания отчетов или фильтрации в таблицах.

Копирование в буфер обмена

  1. Нажмите кнопку "Экспорт" и выберите "Копировать".
  2. Данные будут скопированы в буфер обмена в формате TSV (таблица, разделенная табуляцией).
  3. Вставьте данные (Ctrl+V) в Excel, Google Таблицы или текстовый редактор.

Этот способ удобен, если вы хотите быстро вставить данные без сохранения файла.

Примечание:

  • Если в таблице нет данных, кнопка "Экспорт" будет неактивна.
  • Экспортируются только те столбцы, которые видны в таблице (пустые столбцы автоматически скрываются).

7. Примеры использования

Пример 1: Парсинг карточки товара на Wildberries в стандартном режиме

  1. Откройте страницу товара, например: https://www.wildberries.ru/catalog/196048385/detail.aspx.
  2. Нажмите на значок расширения.
  3. В выпадающем меню выберите "Быстрый сбор данных".
  4. Нажмите "Собрать данные".
  5. Через несколько секунд в таблице появится строка с данными: бренд, цена, размеры, рейтинг и т.д.
  6. Нажмите "Экспорт" → "Копировать" и вставьте данные в Excel для анализа.

Пример 2: Парсинг категории на Lamoda в детальном режиме

  1. Перейдите в категорию, например: https://www.lamoda.ru/c/277/shoes-sandalii-dlya-malchikov/.
  2. Откройте расширение.
  3. Выберите "Детальный сбор данных" в меню.
  4. Нажмите "Собрать данные".
  5. Следите за полосой прогресса. Это может занять несколько минут.
  6. После завершения в таблице появятся данные, включая объем, страну производства и описание.
  7. Нажмите "Экспорт" → "CSV", чтобы сохранить файл для работы в Excel.

Пример 3: Экспорт данных в CSV для анализа в Excel

  1. После парсинга (например, категории на Wildberries) убедитесь, что таблица заполнена.
  2. Нажмите "Экспорт" → "CSV".
  3. Откройте файл products.csv в Excel.
  4. Используйте фильтры Excel, чтобы найти товары с низкой ценой или определенным брендом.
  5. Сохраните отфильтрованные данные для отчета.

8. Частые вопросы и устранение неполадок

Почему расширение не работает на сайте?

  • Убедитесь, что вы открываете окно расширения на сайте Wildberries (wildberries.ru) или Lamoda (lamoda.ru). Другие сайты не поддерживаются.
  • Проверьте URL: он должен соответствовать одному из типов страниц (товар, категория, поиск, бренд).

Что делать, если появляется ошибка "Too many requests" (429)?

  • Это значит, что сайт временно ограничил доступ из-за большого количества запросов.
  • Подождите 5-30 минут и попробуйте снова.
  • Используйте стандартный режим, так как он делает меньше запросов.

Куда обращаться за помощью?

Если у вас есть вопросы или проблемы — используйте форму обратной связи.

9. Полезные советы

  • Организация данных: Сохраняйте CSV-файлы с указанием даты и типа страницы (например, krossovki_2025-04-29.csv), чтобы не запутаться.
  • Мониторинг цен: Парсите одну и ту же страницу раз в неделю, чтобы отслеживать изменения цен. Сравнивайте CSV-файлы в Excel.