用途
MPSTATS Ozon Seller Products 用于按指定卖家下钻 Ozon（俄罗斯站）的商品明细，返回该店铺每个 SKU 的多项经营指标。它面向店铺结构审计、店铺内爆款拆解、以及竞争对手店铺之间的对标分析。
主要能力
- 按 sellerId 返回该卖家下全部 SKU 的指标，包括销量（sales）、销售额（revenue）、最终价格（final_price）、评分（rating）、评论数（comments）、库存（balance）、周转天数（turnover_days）、损失销售额（lost_profit）、类目排名（category_position）等。
- 支持多维数值筛选：filters 为数组，每项包含 field、op、value（部分算子需要 value2）。常用字段包括 sales、final_price、rating、comments、balance、revenue、days_in_stock、turnover_days、lost_profit、category_position。算子包括 GTE、LTE、GT、LT、EQ、NOT_EQ、BETWEEN（BETWEEN 需要 value2）。多个筛选条件按 AND 组合。
- 支持排序与分页：sortField 使用 snake_case 列名，sortDirection 可选 asc / desc；page 从 1 开始，pageSize 范围 1–100，默认 100。
- 支持货币换算：默认 RUB，可通过 currency 指定 USD / EUR / CNY，并可用 currencyRate 指定非默认货币的自定义汇率。
- 支持 FBO / FBS 切换：includeFbs 为 true 时把 FBS 数据并入统计，false 则仅保留 FBO。
使用方式
- API 端点：POST /mpstats/ozon/sellerProducts（完整参数、响应与错误码见 references/api.md）。
- Python 脚本：python scripts/mpstats_ozon_seller_products.py '<JSON 参数>' [--inline]。
- 关键参数：sellerId（必填，数字字符串，例如 "3628678"）、startDate / endDate（YYYY-MM-DD，最新为昨天）、page、pageSize、sortField、sortDirection、currency、currencyRate、includeFbs、filters。
- sellerId 必须是数字字符串，不能传品牌名、类目路径或可读的卖家名称；若只有卖家名称，可先通过 mpstats-ozon-product-search（带卖家筛选）解析出 sellerId 再使用。
- 输出策略：脚本会把完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-mpstats-ozon-seller-products-<timestamp>.json（<cwd> 为脚本执行时的工作目录，<session> 取自环境变量 SESSION_ID；禁止写入 /tmp，当前目录不可写则报错）。响应体 ≤ 8 KB 时落盘后把完整 JSON 打印到 stdout；> 8 KB 时 stdout 只输出摘要（顶层字段、total/costToken 等计数、最大列表字段的长度 + 前 3 条样本）；加 --inline 可强制全量打印到 stdout（同样落盘）。建议先看摘要判断是否够用，需要具体字段时用 jq 或 ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。
成本与限流提示
- 本工具会消耗算力，按动态规则计费：消耗算力 = 12，列表为空返回 0。服务按倍数动态计算，可能一次性消耗大量算力，使用前需提醒用户，由用户决定是否继续。
- 同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败或空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。
- 认证与算力异常处理：未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY、响应 401 或 402、或提示算力/余额不足（如 quota exceeded、insufficient balance、套餐到期、需充值等）时，按 references/onboarding.md 引导解决。
适用场景
- 查看某卖家全部在售商品（按销量排序的店铺 SKU 地图）。
- 找出某 Ozon 店铺的高销售额爆款。
- 筛选周转天数较低的商品（例如 turnover_days ≤ 20）评估运营健康度。
- 扫描因缺货造成损失销售额（lost_profit）的商品。
- 对两家 Ozon 店铺做 SKU 数量与销量的对比（需调用两次）。
限制
- 只接受数字型 sellerId，传卖家名称无法解析。
- 单页最多 100 行。
- 数据为 T-1，endDate 不能是今天或未来日期。
- 仅提供数据，不提供商业或选品建议。
- 仅覆盖 Ozon，Wildberries 等其他俄罗斯平台不在范围内；品牌维度下钻用 mpstats-ozon-brand-products，类目维度下钻用 mpstats-ozon-category-products，单 SKU 时间序列用 mpstats-ozon-product-trend。
- 若需要“某类目下的头部卖家”，应使用类目下钻并在客户端按卖家分组。
展示建议
- 提供紧凑店铺表，关键列：productId、title、brand、price、monthlySalesUnits、monthlySalesRevenue、rating、balance、turnoverDays、lostProfit、position。
- 销售额占比 = 在该卖家查询结果内计算，范围 0–100%，需说明统计基数。
- 俄语标题保留原文，按用户要求再翻译。
- 若做了货币换算，标注“已按 USD 换算”等说明。
- 对于 SKU 数千的店铺，建议先收紧筛选条件，再考虑深度翻页。
- 仅展示数据，不提供是否值得跟卖的购买建议。
反馈
当技能描述的功能与实际行为不符、结果不符合用户意图、用户表达不满或称赞、或发现可改进之处时，按 references/api.md 调用 Feedback API 上报，且不打断用户流程。