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

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. Поддерживаемые сайты и типы страниц

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

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

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

• Страница товара: Карточка конкретного товара (например, описание шампуня или кроссовок).
  • Пример URL на Wildberries: https://www.wildberries.ru/catalog/346625932/detail.aspx
  • Пример URL на Lamoda: https://www.lamoda.ru/p/mp002xc020ca/clothes-calzedonia-noski/
• Категория: Страница со списком товаров в определенной категории (например, "Женская обувь" или "Шампуни").
  • Пример URL на Wildberries: https://www.wildberries.ru/catalog/detyam/dlya-malchikov/odezhda/verhnyaya-odezhda
  • Пример URL на Lamoda: https://www.lamoda.ru/c/1419/clothes-premium-men-kardigani/
• Поиск: Результаты поиска по ключевому слову (например, "кроссовки Nike").
  • Пример URL на Wildberries: https://www.wildberries.ru/catalog/0/search.aspx?search=ноутбук
  • Пример URL на Lamoda: https://www.lamoda.ru/catalogsearch/result/?q=футболка%20женская
• Страница бренда: Список товаров определенного бренда (например, все товары Adidas).
  • Пример URL на Wildberries: https://www.wildberries.ru/brands/lassie
  • Пример URL на Lamoda: https://www.lamoda.ru/b/25725/brand-lassie/

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Параметр (en)	Параметр (ru)	Описание (RU)
Brand	Бренд	Название бренда товара.
Color	Цвет	Цвет товара.
Category	Категория	Категория, в которой размещен товар.
Size	Размер	Доступные размеры товара (техническое название, через запятую).
Size Label	Название размера	Доступные размеры товара (как указано у бренда/продавца, через запятую).
Seller	Продавец	Наименование продавца.
Seller ID	ID продавца	Уникальный идентификатор продавца на маркетплейсе.
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.