Documentation

The Market Ninja extension allows you to collect product data from the Ozon, Wildberries, and Lamoda marketplaces. You can use it for:

• Monitoring product prices (for example, to find out which sellers are dumping prices);
• Collecting information about product characteristics (brand, sizes, volume, country of production, etc.);
• Analyzing the assortment in categories, search queries, or brands;
• Exporting data into convenient formats for working in Excel or other programs.

The extension is created for users who want to quickly and simply get data without technical knowledge. This guide will explain how to install, configure, and use the extension, as well as how to choose the appropriate parsing mode and export data.

How to install

1. Open Google Chrome or Yandex Browser;
2. Go to the Chrome Web Store;
3. Click the Add to Chrome button;
4. In the window that appears, confirm the installation by clicking Add extension;
5. Wait for the extension to install. You will see the extension icon in the upper right corner of the browser (usually a puzzle piece where you can pin the extension).

Verifying installation

1. Click on the extensions icon in Chrome (puzzle piece in the upper right corner);
2. In the list that appears, find the Market Ninja extension;
3. Pin it for quick access by clicking the pin icon next to it.

When you open the extension, you will see a window with several main elements:

• Header: Contains the logo and extension name, as well as the Settings and Help buttons.
• Page Information: Shows the page title, URL, marketplace icon, as well as the number of pages and products available for parsing. The magnifying glass button allows you to quickly return to the tab where the extension window was opened.
• Control Panel:
  • Dropdown menu for selecting the parsing mode:
    • Basic Data and Extended Data for product catalogs, search results, as well as lists of products on seller and brand pages;
    • Only this SKU and All colors and variants for a specific product card page;
  • Collect Data button to start data collection (or Stop if the process is running);
  • Delete button to delete collected data;
  • Copy button to copy data to the clipboard;
  • Export button with a dropdown menu to export data in Excel, CSV, or JSON format.
• Progress Bar: Appears during the parsing process, shows how many products have been processed.
• Data Table: Displays all collected data in a tabular format.

The extension works only on the following websites:

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

You can collect data from four types of pages:

1. Product Pages: A card for a specific product (e.g., shampoo or sneakers).

   • Product card ALEKON Jacques-Yves Cousteau Docker Hat on Ozon;
   • Product card Sulfate-free women's shampoo and hair balm set on Wildberries;
   • Product card Converse Chuck Taylor All Star Sneakers on Lamoda.

2. Category: A page with a list of products in a specific category (e.g., Women's Shoes).

   • Category page Women's Swimwear on Ozon;
   • Category page Women's Swimwear on Wildberries;
   • Category page Women's Swimwear on Lamoda.

3. Search: Search results for a keyword (e.g., Nike sneakers).

   • Search results for query Nike sneakers on Ozon;
   • Search results for query Nike sneakers on Wildberries;
   • Search results for query Nike sneakers on Lamoda.

4. Brand Page: A list of products of a specific brand (e.g., all Adidas products).

   • Brand page Adidas on Ozon;
   • Brand page Adidas on Wildberries;
   • Brand page Adidas on Lamoda.

Product lists are category pages, search results, brand pages, or seller storefronts. Market Ninja can collect data from all these pages.

How to Start Collection

1. Go to a product list page (for example, the Women's Swimwear category on Wildberries);
2. Open the extension;
3. Select the parsing mode from the dropdown list (see below);
4. Click the Collect Data button.

Parsing Modes

1. Basic Data

The extension iterates through catalog pages (pagination) and collects product data.

• Speed: High (hundreds of products per minute);
• Data: Only basic information (see the Product Lists section);
• Limitations: Detailed characteristics (composition, country of production, etc.) are not available in this mode.

2. Extended Data

The extension first collects the list of products, and then "drills down" into each product card to collect full information.

• Speed: Low, as a separate request is made for each product;
• Data: Everything in Basic Data, as well as detailed characteristics and configured custom attributes;
• Recommendation: Use this mode when it is critically important to collect the most complete data about products.

Limitations

To protect against blocking by marketplaces, the extension has a delay between requests that simulates human behavior.

This scenario is used when you need to analyze a specific product and its variants.

How to Start Collecting

1. Open a specific product page;
2. Launch the extension;
3. Select a parsing mode;
4. Click the Collect Data button.

Parsing Modes

1. Only This SKU

Instantly collects data only about the currently selected color/size of the product that you see on the screen.

2. All Colors and Variants

Collects data about the current product, as well as all its variations (other colors, models in the same card).

• How it works: The extension finds links to other colors in the card and collects data about each of them one by one.
• Result: Several rows will appear in the table — one for each product variant. This is convenient for analyzing the assortment of a single model.

After the data is collected, it is displayed in a table inside the extension.

Table Management

• Sorting: Click on the header of any column to sort data in ascending or descending order;
• Search: Use the input field above the table to filter products by name, brand, or SKU;
• Copying: The Copy button saves all data from the table to the clipboard (you can paste it directly into Google Sheets or Excel via Ctrl+V).

Data Export

Click the Export button to select a format:

1. XLSX (Excel) — the best choice for most tasks. The file is immediately ready for work, numbers and prices have the correct format;
2. CSV — a universal text format. Suitable for importing into databases or third-party programs;
3. JSON — a format for developers and integrations.

The Market Ninja extension allows you to flexibly configure the collected data and export format. To access settings, click the Settings button at the top of the extension window or right-click on the extension icon and select Options.

The settings screen is divided into two sections: Attributes and Export.

Custom Attributes

By default, the extension collects a standard set of data (price, brand, rating, etc.). However, products on marketplaces have thousands of different characteristics (for example, Package weight, Sole material, Leather type, and many others).

You can add your own columns to the data table by specifying which characteristics need to be collected on the product card.

How to add an attribute:

1. Click the Add Attribute button;
2. Column Name: Enter the name that will be displayed in the header of your table (for example, Country);
3. Marketplace Keys: For each site, specify the exact name of the characteristic as it is written on the product card on the site.

Configuration Example:

Suppose you want to collect information about clothing composition.

1. Column Name: Enter Composition;
2. Wildberries: Enter Состав;
3. Ozon: Enter Состав материала (this is how this field is often named on Ozon);
4. Lamoda: Enter Состав or Состав, %.

Limitations

• Maximum number of custom attributes: 3;
• Attributes work in Extended Data mode for product lists, as well as for all product card parsing modes.

Export Settings

In this section, you can control how the data will look in the exported files (Excel, CSV, JSON).

Text Cleaning

When collecting data, product descriptions or reviews often contain extra characters. You can enable the following automatic cleaning options:

1. Remove line breaks

   • What it does: Replaces all line breaks (Enter) with spaces;
   • Why it's needed: Important for CSV and Excel files so that a single cell with a long description does not break lines and disrupt the table structure.

2. Remove HTML tags

   • What it does: Completely removes code (HTML tags) from the text;
   • Why it's needed: Useful when collecting Rich content or descriptions from Ozon to get clean, readable text without junk.

Managing Settings

• Save: Applies changes. The button is active only if you have made edits and all fields are filled in correctly;
• Reset: Returns all settings to default values (removes your custom attributes).

Product lists include search result pages, product categories, brands, and product lists on the seller's page.

The extension supports two parsing modes for product lists: Basic Data and Extended Data. The modes differ in the amount of collected data and operating speed.

Parsing Mode: Basic Data

What it collects: Only basic data about products that are displayed on product list pages.

Ozon

Wildberries

Lamoda

Parsing Mode: Extended Data

What it collects: All data from the product card parsing mode Current SKU Only.

Columns Hidden by Default

For all parsing modes, columns hidden by default are also available:

Hidden columns can be activated at any time in the column management interface.

Data from the product page can be collected in two modes: Current SKU Only and All Colors and Variants.

Parsing Mode: Current SKU Only

What it collects: Product characteristics and other data for only one SKU.

Ozon

Wildberries

Lamoda

Parsing Mode: All Colors and Variants

What it collects: All data from the mode Current SKU Only, as well as data on all products related to this card (e.g., other colors, package weights, etc.).

Columns Hidden by Default

For all parsing modes, columns hidden by default are also available:

Hidden columns can be activated at any time in the column management interface.

Is the extension free?

Yes, the basic functionality of the Market Ninja parser is completely free for all users.

Which websites does the parser support?

Currently, only Wildberries, Ozon, and Lamoda are supported. On other websites, the extension will show a Website not supported message. Read more about this in the Supported Websites section.

Why is parsing slow?

In Extended Data mode, the extension makes a separate request for each product. To prevent the marketplace from blocking you for suspicious activity, we intentionally add random delays between requests. This ensures safe operation.

Data is not being collected

This can happen, for example, if the marketplace website requests a robot check (captcha).

1. Stop parsing;
2. Refresh the marketplace page;
3. If a captcha appears, solve it manually;
4. Start the extension again.

Why are not all products from the category collected?

Marketplaces (Ozon, Wildberries, Lamoda) technically limit the number of products available for viewing in search results or categories. Even if the site says "Found 50,000 products", only the first few thousand are available for the user (and the extension) to view.

This is easy to verify by going to the last page in any catalog. For example, in the Adidas brand section on Wildberries, there are over 100,000 products, but the last page in the category is the 100th.

Can I close the extension window while it is running?

No. The data collection process runs inside the open window. If you close it, parsing will stop. You can switch to other windows (Alt+Tab), but do not close the extension popup window itself.

Is it safe to use the extension?

Yes, the extension works only in your browser, does not collect personal data, and undergoes strict verification in the Chrome Web Store.

Feedback

Found a bug or have an idea for a feature? Write to us on Telegram.