mcpField
M
mpstats

mpstats

github.com/mpstats-io数据与数据库12749 次安装22 周前更新
代码仓库

关于 mpstats

mpstats 是一项面向 Agent 的技能，可研究 Wildberries、Ozon 和 Yandex Market 的商品、类目、卖家及销售数据。它提供现成的 Shell 脚本，并指导检查异常和呈现分析结果。

主要功能

  1. 01商品与类目研究
  2. 02卖家及品牌监测
  3. 03SKU 销售、库存和评论数据
  4. 04用于 API 查询的现成脚本
  5. 05异常检查与报告指导

适用场景

  1. 01比较不同周期的市场类目
  2. 02查看 SKU 销售、库存和评论
  3. 03监测卖家或品牌表现

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/mpstats-io/claude-code-skills --skill mpstats

安装后在 Claude Code 中输入/mpstats确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.gitignore
config/
.env.example
README.md
references/
account.md
auth.md
coverage.md
ozon-brands-sellers-sku.md
ozon-categories.md
pagination-filter-sort.md
presentation.md
wb-brands-sellers.md
wb-categories.md
wb-similar-sku.md
ym-categories.md
scripts/
common.sh
README.md
request.sh
scripts/account/
account-limits.sh
scripts/ozon/
ozon-brand.sh
ozon-categories-list.sh
ozon-category.sh
ozon-compare.sh
ozon-seller.sh
ozon-sku.sh
scripts/wb/
wb-analytics.sh
wb-brand.sh
wb-card-content.sh
wb-categories-list.sh
wb-category-stats.sh
wb-category.sh

详细介绍

MPSTATS API

MPSTATS 是一个俄罗斯电商平台分析平台，提供 Wildberries、Ozon 和 Yandex Market 的数据，包括商品调研、品类分析、卖家／品牌监控、SKU 级别的销售额、库存和评论数据。

请使用 scripts/ 中现成的 Shell 脚本，通过 Bash 工具调用，而不要编写 HTTP 代码。references/ 中的文件仅作为 API 契约参考。

令牌设置

脚本会通过 scripts/common.sh 自动从 config/.env 加载令牌。每条命令的 MPSTATS_TOKEN 环境变量会覆盖文件中的令牌。

设置方法和令牌获取方式：config/README.md。

如果缺少令牌，请在继续之前向用户提供且仅提供以下 2 个选项：

  1. 用户在聊天中发送令牌 → Agent 自行创建 config/.env。
  2. 用户在本地运行：cp config/.env.example config/.env，然后将令牌粘贴到 config/.env。

令牌页面：https://mpstats.io/userpanel（API token 区块）。需要有效的 MPSTATS 订阅。

参考资料

API 契约（端点、参数、响应语义）——按需阅读：

  • references/auth.md — 基础 URL、认证标头、响应代码、速率限制
  • references/pagination-filter-sort.md — 所有 POST 端点通用的请求／响应模型
  • references/wb-categories.md、references/wb-brands-sellers.md、references/wb-similar-sku.md — Wildberries
  • references/ozon-categories.md、references/ozon-brands-sellers-sku.md — Ozon
  • references/ym-categories.md — Yandex Market
  • references/account.md — API 限制
  • references/coverage.md — 脚本已封装和仍未覆盖的内容
  • references/presentation.md — 如何格式化分析答复及采用品牌风格的 HTML/PDF 报告

结果格式

先给出简洁的结论，再提供证据。涉及多个实体时使用紧凑的表格，展示趋势／细分／比较时使用图表。除非用户要求，否则不要直接倾倒原始 JSON；应解读数字对决策的意义。HTML/PDF 报告请遵循 references/presentation.md 中的 MPSTATS 品牌风格。

合理性检查——标记异常，切勿不加判断地报告

MPSTATS 数据可能包含离群值、卖家错误、单位不匹配和过时行。将这些数据当作事实报告会误导用户。呈现任何数字之前，都要先检查其量级是否合理。

遇到以下情况时，明确标记：

  • 价格远超品类常见水平——例如，每件纸巾售价 500 000 ₽、手机壳售价 50 ₽、冰箱售价 200 ₽。请与品类中位数比较；如果偏差大约超过 10 倍，几乎可以确定是卖家价格错误、单位不匹配（包装与单件）或占位值。
  • 销量不合常理——小型卖家的月销量突然达到 1 000 000 件；有营收却没有销量；营收 ≠ 大致等于 price × units。
  • 不应为零／空值／负值的地方出现了零／空值／负值——有评论的 SKU 评分为 0、库存 = -5，明显已不活跃的 SKU 却显示“距上次销售 0 天”。
  • 日期／时间段异常——请求的时间段 ≠ 返回的时间段、按日期排列的数据序列存在缺口、数据行日期在未来。
  • 单位不匹配——将每包价格当作每件价格；m² 与件数混淆；升与 ml 混淆。

按以下顺序标记：

  1. 清楚展示异常行，并突出显示数值（例如：“每包 500 000 ₽——看起来像是卖家标价错误”）。
  2. 说明你认为最可能的原因（单位不匹配、卖家错误、数据过时或占位值）。
  3. 从汇总统计中剔除该行（并说明已剔除），或者指出该行会使汇总统计产生偏差。
  4. 使用清理后的数据继续分析。

不要悄悄剔除或“取整”处理异常值。不要把它们当作真实数据报告，让用户自行发现其中的不合理之处。结论必须基于清理后的数据；同时应提及原始离群值，以保证透明度。

脚本

scripts/ 中提供了可直接使用的 Shell 脚本。通过 Bash 工具调用，不要重写 HTTP。完整目录以及每个脚本的适用场景和路由指南见：scripts/README.md。运行任意脚本时，可使用 --help 查看参数。

脚本用途用法
account/account-limits.sh检查剩余 API 配额./scripts/account/account-limits.sh
wb/wb-categories-list.sh完整的 WB 类目树./scripts/wb/wb-categories-list.sh
wb/wb-category.shWB 类目商品./scripts/wb/wb-category.sh "Электроника/Смартфоны" 2024-01-01 2024-03-01
wb/wb-category-stats.shWB 类目细分数据（子类目／品牌／卖家／趋势）./scripts/wb/wb-category-stats.sh "Электроника" subcategories
wb/wb-sku.shWB SKU 分析（完整数据／销售／库存／关键词／评论）./scripts/wb/wb-sku.sh 152490541 sales
wb/wb-card-content.shWB 商品卡片内容（描述、特征、尺寸）——使用 WB CDN，而非 MPSTATS./scripts/wb/wb-card-content.sh 290784358 .description
wb/wb-brand.shWB 品牌商品或分析./scripts/wb/wb-brand.sh "Nike" products
wb/wb-seller.shWB 卖家商品或分析./scripts/wb/wb-seller.sh 123456 products
wb/wb-search.sh用于调研的 WB 主题／细分市场列表./scripts/wb/wb-search.sh
wb/wb-subject.shWB 主题接口（products、categories、brands、sellers、trends、by_date、price_segmentation、keywords、similar、geography、warehouses）./scripts/wb/wb-subject.sh 70 products
wb/wb-similar.shWB 相似商品系列（identical、identical_wb、similar、in_similar）./scripts/wb/wb-similar.sh similar 72124874 products
wb/wb-analytics.shWB AI 预测和季节效应./scripts/wb/wb-analytics.sh category forecast/daily "Женщинам/Платья и сарафаны"
wb/wb-warehouses.shWB 品牌／卖家的仓库分布./scripts/wb/wb-warehouses.sh brand "Mango"
wb/wb-compare.sh对比 WB 类目／品牌／卖家／主题的时段数据./scripts/wb/wb-compare.sh subject 70 2024-01-01 2024-01-15 2024-01-16 2024-01-31
ozon/ozon-categories-list.sh完整的 Ozon 类目树./scripts/ozon/ozon-categories-list.sh
ozon/ozon-category.shOzon 类目商品或统计数据./scripts/ozon/ozon-category.sh "Автотовары" products
ozon/ozon-sku.shOzon SKU 报告（sales、by_day、balance、categories、keywords、full、by_period、search_stats、stores、comments）./scripts/ozon/ozon-sku.sh 123456789 keywords 2023-11-27 2023-12-26
ozon/ozon-brand.shOzon 品牌商品或分析./scripts/ozon/ozon-brand.sh "Samsung" categories
ozon/ozon-seller.sh按卖家 ID 或名称查询 Ozon 卖家商品或分析./scripts/ozon/ozon-seller.sh 987654 products
ozon/ozon-compare.sh对比 Ozon 类目／品牌／卖家的时段数据./scripts/ozon/ozon-compare.sh category "Автотовары/..." 2024-01-01 2024-01-15 2024-01-16 2024-01-31
ym/ym-category.shYandex Market 类目商品或统计数据./scripts/ym/ym-category.sh "Электроника/Смартфоны"
ym/ym-brand.shYandex Market 品牌商品或分析./scripts/ym/ym-brand.sh "Samsung" categories
ym/ym-seller.shYandex Market 卖家商品或分析./scripts/ym/ym-seller.sh "Эльдорадо" products
ym/ym-sku.shYandex Market 商品销售历史，可选日期./scripts/ym/ym-sku.sh 12345678 2024-01-01 2024-01-31
ym/ym-compare.sh对比 Yandex Market 类目／品牌／卖家的时段数据./scripts/ym/ym-compare.sh category "Электроника/Смартфоны" 2024-01-01 2024-01-15 2024-01-16 2024-01-31
request.sh用于调用任意 MPSTATS 方法／路径的通用原始 API 调用脚本./scripts/request.sh POST subject/items 'path=70&d1=2024-01-01&d2=2024-01-31'

评论

支持 Markdown