文档

Market Ninja 扩展程序允许您从 Ozon、Wildberries 和 Lamoda 市场收集商品数据。您可以使用它来：

• 监控商品价格（例如，了解哪些卖家在进行低价倾销）；
• 收集商品特征信息（品牌、尺寸、容量、生产国等）；
• 分析类别、搜索查询或品牌中的商品分类；
• 将数据导出为方便在 Excel 或其他程序中使用的格式。

该扩展程序专为希望在无需技术知识的情况下快速简单地获取数据的用户而设计。本指南将解释如何安装、配置和使用该扩展程序，以及如何选择合适的抓取模式并导出数据。

如何安装

1. 打开 Google Chrome 或 Yandex 浏览器；
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. 商品页面： 具体商品的详情页（例如洗发水或运动鞋）。

   • Ozon 上的商品详情页 ALEKON Jacques-Yves Cousteau 瓜皮帽；
   • Wildberries 上的商品详情页 女士无硫酸盐洗发水和护发素套装；
   • Lamoda 上的商品详情页 Converse Chuck Taylor All Star 帆布鞋。

2. 类别： 特定类别的商品列表页面（例如 女鞋）。

   • Ozon 上的类别页面 女士泳衣；
   • Wildberries 上的类别页面 女士泳衣；
   • Lamoda 上的类别页面 女士泳衣。

3. 搜索： 关键字搜索结果（例如 Nike 运动鞋）。

   • Ozon 上 Nike 运动鞋 的搜索结果；
   • Wildberries 上 Nike 运动鞋 的搜索结果；
   • Lamoda 上 Nike 运动鞋 的搜索结果。

4. 品牌页面： 特定品牌的商品列表（例如 Adidas 的所有商品）。

   • Ozon 上的品牌页面 Adidas；
   • Wildberries 上的品牌页面 Adidas；
   • Lamoda 上的品牌页面 Adidas。

商品列表是指类别页面、搜索结果、品牌页面或卖家橱窗。Market Ninja 可以从所有这些页面收集数据。

如何开始收集

1. 前往商品列表页面（例如 Wildberries 上的 女士泳衣 类别）；
2. 打开扩展程序；
3. 在下拉列表中选择抓取模式（见下文）；
4. 点击 收集数据 按钮。

抓取模式

1. 基本数据

扩展程序会遍历目录页面（分页）并收集商品数据。

• 速度： 高（每分钟数百个商品）；
• 数据： 仅基本信息（参见 商品列表 部分）；
• 限制： 此模式下无法获取详细特征（成分、生产国等）。

2. 扩展数据

扩展程序首先收集商品列表，然后“进入”每个商品的详情页以收集完整信息。

• 速度： 不高，因为需要对每个商品单独发出请求；
• 数据： 基本数据中的所有内容，以及详细特征和配置的自定义属性；
• 建议： 当收集尽可能完整的商品数据至关重要时，请使用此模式。

限制

为了防止被电商平台屏蔽，扩展程序在请求之间设置了延迟，以模拟人类行为。

当您需要分析特定商品及其变体时，可以使用此场景。

如何开始收集

1. 打开特定商品的页面；
2. 打开扩展程序；
3. 选择抓取模式；
4. 点击 收集数据 按钮。

抓取模式

1. 仅此商品

即时收集您在屏幕上看到的当前所选颜色/尺寸的商品数据。

2. 所有颜色和变体

收集当前商品及其所有变体（同一页面中的其他颜色、型号）的数据。

• 工作原理： 扩展程序在页面中找到其他颜色的链接，并依次收集每个颜色的数据。
• 结果： 表格中将出现多行数据——每个商品变体一行。这便于分析同一型号的商品系列。

数据收集完成后，将显示在扩展程序内的表格中。

表格管理

• 排序： 点击任意列标题，按升序或降序对数据进行排序；
• 搜索： 使用表格上方的输入框，按名称、品牌或货号筛选商品；
• 复制： 复制按钮将表格中的所有数据保存到剪贴板（可以通过 Ctrl+V 直接粘贴到 Google 表格或 Excel 中）。

导出数据

点击 导出 按钮选择格式：

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 标签）；
   • 用途： 在从 Ozon 收集富内容或描述时很有用，可以获得没有垃圾内容的纯净可读文本。

设置管理

• 保存： 应用更改。仅当您进行了修改且所有字段填写正确时，该按钮才处于活动状态；
• 重置： 将所有设置恢复为默认值（删除您的自定义属性）。

商品列表包括搜索结果页面、商品类别、品牌以及卖家（商家）页面上的商品列表。

扩展程序支持两种商品列表抓取模式：基本数据和扩展数据。这两种模式在收集的数据量和运行速度上有所不同。

抓取模式：基本数据

收集内容： 仅收集显示在商品列表页面上的基本商品数据。

Ozon

Wildberries

Lamoda

抓取模式：扩展数据

收集内容： 包含商品详情页抓取模式 仅此商品 中的所有数据。

默认隐藏列

所有抓取模式还提供以下默认隐藏列：

您可以在列管理界面随时激活隐藏列。

可以以两种模式收集商品详情页数据：仅此商品和所有颜色和变体。

抓取模式：仅此商品

收集内容： 仅收集单个商品的特征和其他数据。

Ozon

Wildberries

Lamoda

抓取模式：所有颜色和变体

收集内容： 仅此商品模式中的所有数据，以及与该商品卡片相关的所有商品数据（例如其他颜色、包装重量等）。

默认隐藏列

所有抓取模式还提供以下默认隐藏列：

您可以在列管理界面随时激活隐藏列。

扩展程序是免费的吗？

是的，Market Ninja 抓取工具的基本功能对所有用户完全免费。

抓取工具支持哪些网站？

目前仅支持 Wildberries、Ozon 和 Lamoda。在其他网站上，扩展程序将显示消息 网站不支持。有关详细信息，请参阅 支持的网站 部分。

为什么抓取速度很慢？

在 扩展数据 模式下，扩展程序会对每个商品发出单独的请求。为了防止电商平台因可疑活动而屏蔽您，我们特意在请求之间添加了随机延迟。这确保了工作的安全性。

数据未收集

这种情况可能会发生，例如，如果电商平台网站请求进行机器人验证（验证码）。

1. 停止抓取；
2. 刷新电商平台页面；
3. 如果出现验证码 — 请手动完成验证；
4. 再次启动扩展程序。

为什么没有收集类别中的所有商品？

电商平台 (Ozon, Wildberries, Lamoda) 在技术上限制了搜索结果或类别中可查看的商品数量。即使网站显示“找到 50,000 个商品”，用户（以及扩展程序）也只能查看前几千个。

这很容易验证，只需转到任何目录的最后一页即可。例如，在 Wildberries 上的 Adidas 品牌部分展示了超过 100,000 种商品，但该类别的最后一页是 第 100 页。

工作时可以关闭扩展程序窗口吗？

不能。数据收集过程在打开的窗口内运行。如果关闭它，抓取将停止。您可以切换到其他窗口 (Alt+Tab)，但不要关闭扩展程序弹出窗口本身。

使用扩展程序安全吗？

是的，扩展程序仅在您的浏览器中运行，不收集个人数据，并且通过了 Chrome 应用商店的严格审核。

反馈

发现了错误或有功能建议？请在 Telegram 上联系我们。