linkfox-mpstats-ozon-brand-products

MPSTATS Ozon 品牌商品

此技能可深入分析指定品牌展示名称下销售的所有 Ozon（俄罗斯）商品，返回每个 SKU 的销量、销售额、价格、评分、库存、周转天数、损失利润等数据。适用于品牌竞品审查、品牌 SKU 结构分析和畅销商品拆解。

核心概念

品牌展示名称：brandName 必须与 Ozon 店铺页面上显示的名称一致，通常为俄语（西里尔字母）或拉丁字母（adidas、Xiaomi）。请勿在此处填写类目路径、卖家 ID 或内部品牌代码。如果不确定准确拼写，请先通过 mpstats-ozon-product-search 查询。

筛选条件采用 AND 组合：filters 数组支持多个数值条件，并以 AND 方式组合。每个筛选条件的格式为 {field, op, value, value2?}。常用字段和运算符见下方的筛选参考。

货币和汇率：默认货币为 RUB。设置 currency: "USD"（或其他代码）即可由服务端转换货币字段；如有需要，可通过 currencyRate 覆盖默认汇率。

FBO / FBS 组合：includeFbs: true 会将 FBS（卖家发货）的库存和销量计入数据；false 则仅统计 FBO 数据。

参数

参数	类型	必填	描述
brandName	string	是	Ozon 品牌展示名称（俄语或拉丁字母）
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；例如 USD、EUR、CNY
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/brandProducts（完整参数/响应/错误码见 references/api.md）
• Python 脚本：python scripts/mpstats_ozon_brand_products.py '<JSON 参数>' [--inline]
• 成本约束：本工具会消耗算力；同一会话中的相同参数组合默认只调用一次，脚本带有 24h 本地缓存。不得因失败或结果为空而自动更换关键词、翻页或修改邮编连续试探；如需继续检索，请先告知用户会产生额外消耗。

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

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-mpstats-ozon-brand-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. 查询品牌 adidas 的销量前 50 名

{
  "brandName": "adidas",
  "sortField": "sales",
  "sortDirection": "desc",
  "pageSize": 50
}

2. 高评分、中等价格筛选

{
  "brandName": "Xiaomi",
  "filters": [
    {"field": "rating", "op": "GTE", "value": 4.5},
    {"field": "final_price", "op": "BETWEEN", "value": 1000, "value2": 5000}
  ],
  "sortField": "revenue",
  "sortDirection": "desc"
}

3. 输出转换为 USD

{
  "brandName": "Nike",
  "currency": "USD",
  "sortField": "revenue"
}

4. 包含 FBS 且仅显示有库存的商品

{
  "brandName": "adidas",
  "includeFbs": true,
  "filters": [{"field": "balance", "op": "GT", "value": 0}]
}

5. 查找损失利润较高的商品（缺货影响）

{
  "brandName": "Nike",
  "filters": [{"field": "lost_profit", "op": "GTE", "value": 100000}],
  "sortField": "lost_profit",
  "sortDirection": "desc"
}

展示规则

1. 紧凑品牌表格 — 关键列：productId、title、price、monthlySalesUnits、monthlySalesRevenue、rating、reviewCount、balance、turnoverDays、lostProfit。
2. 营收占比说明 — revenueSharePercent 表示该 SKU 在当前品牌结果集内所占的份额，范围为 0–100；展示时请说明计算基数。
3. 货币标注 — 表格标题中始终注明货币；如果覆盖了 currency，请注明“已按 USD 换算”。
4. 俄语标题 — 保留原文；用户要求时再翻译。
5. 分页 — 报告总数；如果总数超过当前返回页数，请引导用户查看下一页或缩小筛选范围。
6. 不提供商业建议 — 仅展示数据；不要根据快照预测未来销量。

重要限制

• 品牌名称精确匹配 — 不支持模糊搜索；拼写错误会返回空结果。不确定时，请通过 mpstats-ozon-product-search 核实。
• 分页上限 — 每页最多 100 行；品牌产品更多时请分页查询。
• 日期范围 — endDate 不能是今天或未来日期（数据截至 T-1）。
• 货币换算 — 在服务端进行；历史汇率可能与用户参考汇率略有差异。
• 仅支持俄语标题 — 仅在用户要求时翻译。

用户表达与场景速查

适用 — 按品牌筛选的 Ozon 产品指标：

用户表达	场景
“显示 adidas 在 Ozon 上销量最高的 SKU”	品牌畅销产品分析
“Xiaomi 在 Ozon 上卖什么，按营收排序”	品牌营收结构
“品牌 X 中哪些 SKU 的评分 ≥4.5 且库存 >0”	品牌质量筛选
“品牌 X 的缺货是否导致大量利润损失”	利润损失分析
“将品牌 X 在 Ozon 上的销售额换算为 USD”	统一货币口径审计

不适用 — 需要超出品牌下钻范围的分析：

• 不确定品牌名称是否完全匹配 → 先使用 mpstats-ozon-product-search
• 跨品牌的品类级比较 → 使用 mpstats-ozon-category-products
• 按卖家筛选的分析 → 使用 mpstats-ozon-seller-products
• 单个 SKU 的时间序列 → 使用 mpstats-ozon-product-trend
• Wildberries / 其他俄罗斯电商平台 → 不支持

适用范围判断：当问题聚焦于单个品牌，且需要查看该品牌下按 SKU 汇总的数据时，使用此技能。对于“哪个品牌在品类 X 中占主导地位”，请使用品类下钻，并在服务端比较品牌数据行。

算力消耗规则

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

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

反馈：

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

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

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

---

如需更多优质、专业的跨境电商技能，请访问 LinkFox Skills。