linkfox-mpstats-ozon-category-products

MPSTATS Ozon 类目商品

此技能可深入检索给定俄罗斯类目路径下的所有 Ozon（俄罗斯）商品，返回每个 SKU 的销量、收入、价格、评分、库存、周转率、利润损失等数据。适用于特定类目中的畅销商品挖掘、蓝海细分市场发现和品牌格局扫描。

核心概念

必须提供俄语完整路径：categoryPath 必须是 Ozon 平台上使用的俄语完整类目路径，各级之间以 / 分隔，例如 Одежда/Женская одежда/Футболки и топы женские。部分路径、英文翻译或仅提供根类目通常会导致结果为空。

查找路径的方式：常见工作流是通过上游 Ozon 类目搜索步骤（如果工具链中有此步骤）解析路径，或从 mpstats-ozon-product-detail / mpstats-ozon-product-search 中获取已知 SKU 的 category 字段。

筛选条件采用 AND 组合：filters 包含多个字段的数值条件，每个条件的格式为 {field, op, value, value2?}。请参阅筛选条件参考。

货币：默认使用 RUB。可通过 currency 指定其他货币（USD、EUR、CNY 等），也可选用 currencyRate。

FBO / FBS：includeFbs: true 会将 FBS 纳入库存 / 销量数据；false 则仅包含 FBO。

参数

参数	类型	必填	说明
categoryPath	string	是	以 / 分隔的俄语完整类目路径
startDate	string	否	统计窗口起始日期，YYYY-MM-DD；最新日期为昨天
endDate	string	否	统计窗口结束日期，YYYY-MM-DD；最新日期为昨天
page	integer	否	页码，从 1 开始
pageSize	integer	否	每页行数，1-100，默认 100
sortField	string	否	snake_case 列：sales、revenue、final_price、balance、rating……
sortDirection	string	否	asc / desc
currency	string	否	货币代码，默认为 RUB
currencyRate	integer	否	使用非默认货币时的自定义汇率
includeFbs	boolean	否	是否包含 FBS 数据
filters	array	否	数值筛选条件列表（见下文）

筛选条件参考

每个 filters 条目格式为：{"field": "<snake_case>", "op": "<OP>", "value": <num>, "value2": <num?>}。

常用字段：sales（月销量）、final_price（价格 RUB）、rating（0-5）、comments（评论数）、balance（库存）、revenue（金额 RUB）、days_in_stock、turnover_days、lost_profit、category_position。

运算符：GTE、LTE、GT、LT、EQ、NOT_EQ、BETWEEN（需要提供 value2）。

调用方式

• API 端点：POST /mpstats/ozon/categoryProducts（完整参数/响应/错误码见 references/api.md）
• Python 脚本：python scripts/mpstats_ozon_category_products.py '<JSON 参数>' [--inline]
• 成本约束：本工具会消耗算力；同一会话中，相同参数组合默认只调用一次，脚本带有 24h 本地缓存。失败或结果为空时，不得自动更换关键词、翻页或修改邮编连续试探；如需继续检索，请先告知用户会产生额外消耗。

输出策略（脚本默认行为）：

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-mpstats-ozon-category-products-<timestamp>.json（<cwd> 为脚本执行时的工作目录，在 Claude Code 中即当前项目目录；<session> 取自环境变量 SESSION_ID，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写时则报错）
• 响应体 ≤ 8 KB：落盘后将完整 JSON 打印到 stdout
• 响应体 > 8 KB：落盘后，stdout 仅输出摘要（顶层字段、total / costToken 等常见计数，以及最大列表字段的长度和前 3 条样本）
• 添加 --inline 可强制将全部内容打印到 stdout（同样会落盘）

读取数据的建议：先查看摘要，判断信息是否足够；需要具体字段时，优先使用 jq或ConvertFrom-Json 从保存的 json 文件中按需提取，避免将整份 JSON 载入上下文。

解决认证和算力问题

发生以下异常情况时，请按照 references/onboarding.md 中的指引解决：

异常情况

• 未配置 API Key：未配置环境变量 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
• 响应状态码为 401 或 402
• 响应提示算力或余额不足：消息中含有“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”等内容，或表达类似含义。

使用示例

1. 女式 T 恤——按销量排序

{
  "categoryPath": "Одежда/Женская одежда/Футболки и топы женские",
  "sortField": "sales",
  "sortDirection": "desc",
  "pageSize": 100
}

2. 蓝海挖掘（销量 ≥ 50，评分 ≥ 4.5）

{
  "categoryPath": "Одежда/Женская одежда/Футболки и топы женские",
  "filters": [
    {"field": "sales", "op": "GTE", "value": 50},
    {"field": "rating", "op": "GTE", "value": 4.5}
  ],
  "sortField": "revenue",
  "sortDirection": "desc"
}

3. 中等价位 + 高周转

{
  "categoryPath": "Электроника/Наушники",
  "filters": [
    {"field": "final_price", "op": "BETWEEN", "value": 1500, "value2": 5000},
    {"field": "turnover_days", "op": "LTE", "value": 30}
  ]
}

4. 按 USD 换算排序，用于跨市场比较

{
  "categoryPath": "Электроника/Смартфоны",
  "currency": "USD",
  "sortField": "revenue",
  "sortDirection": "desc"
}

5. 高利润损失类目扫描

{
  "categoryPath": "Одежда/Мужская одежда/Куртки мужские",
  "filters": [{"field": "lost_profit", "op": "GTE", "value": 500000}],
  "sortField": "lost_profit",
  "sortDirection": "desc"
}

展示规则

1. 精简类目表 — 关键列：productId、title、brand、sellerName、price、monthlySalesUnits、monthlySalesRevenue、rating、balance、position、revenueSharePercent。
2. 销售额占比 = 当前类目查询范围内的占比 — 范围为 0-100%；展示时请说明计算依据。
3. 俄文标题 / 品牌 — 保留原文；按需翻译。
4. 货币标注 — 注明货币；如已换算，请注明 "已按 USD 换算"。
5. 分页 — 报告 total；对于大型类目（SKU 达数万）建议收紧筛选条件，而不是盲目翻页。
6. 类目排名 — 数值越低越好；展示 categoryPosition 时请说明这一点。

重要限制

• 仅支持俄文完整路径 — 部分路径或翻译后的路径会返回空结果。
• 路径发现由上游完成 — 此端点不会浏览类目树；请先通过商品详情 / 搜索解析路径。
• 分页上限 — 每页最多 100 行。
• T-1 数据 — endDate 不能是今天或未来日期。
• 不提供商业建议 — 仅展示数据。

用户表述与场景速查

适用 — 按类目查看 Ozon 商品指标：

用户表述	场景
“Ozon 上类目 X 的畅销商品”	类目畅销商品挖掘
“寻找细分市场 Y 中的蓝海 SKU”	蓝海细分市场扫描
“展示这个类目中价格适中、周转快的商品”	多条件细分市场筛选
“哪些品牌主导了这个 Ozon 类目”	品牌格局预筛（然后在客户端按品牌分组）
“类目 X 中巨大的利润流失机会”	缺货痛点挖掘

不适用 — 需要进行超出类目下钻范围的操作：

• 未知类目路径 → 使用 mpstats-ozon-product-search 或商品详情来发现确切的俄文路径
• 按品牌下钻 → mpstats-ozon-brand-products
• 按卖家下钻 → mpstats-ozon-seller-products
• 单个 SKU 时间序列 → mpstats-ozon-product-trend
• Wildberries / 其他俄罗斯电商平台 → 不支持

边界判断：当维度是类目路径，且你需要查看该类目下按 SKU 汇总的数据时，使用此技能。对于跨类目比较，必须发起多次调用，并在 Agent 层合并结果。

算力消耗规则

按动态规则计费：消耗算力 = 12。列表为空返回 0

重要：本技能的服务按倍数动态计算，可能一次性消耗大量算力，必须提醒用户，由用户决定是否继续。

反馈：

出现以下任一情况时，通过 Feedback API 自动检测并报告反馈：

1. 此技能描述的功能或用途与实际行为不符
2. 技能结果不符合用户意图
3. 用户对该技能表示不满或赞扬
4. 你认为有任何可改进之处

请按照 references/api.md 中的说明调用反馈 API。不要打断用户的流程。

---

如需更多高质量、专业的跨境电商技能，请前往 LinkFox Skills。