查询单个 Ozon 商品分日走势（销量/价格/库存/评分/搜…

当需要看某个 Ozon（俄罗斯站）SKU 按天变化的时间序列时使用，用于判断增长趋势、季节性、断货或价格异动。

适用场景

解决思路

1. 确认分析对象是单个 Ozon SKU（productId，数字），每次调用只分析一个商品；若要批量快照多个 SKU，改用 mpstats-ozon-product-detail。
2. 调用 API 端点 POST /mpstats/ozon/productTrend，或运行 Python 脚本 python scripts/mpstats_ozon_product_trend.py '<JSON 参数>' [--inline]。
3. 传入必填参数 productId（整数，Ozon SKU 数字）。
4. 按需传入 startDate 和 endDate（格式 YYYY-MM-DD），窗口最晚只能到昨天（数据有 T-1 延迟），今天或未来日期会被拒绝。
5. 如需同时包含 FBS 数据（与 FBO 并列），设置 includeFbs=true。
6. 如需附加搜索位次/可见性信号，设置 includeSearchStats=true；注意小类目可能没有搜索数据覆盖，字段可能部分为空或整体为空。
7. 读取响应顶层字段 data，它是 [startDate, endDate] 窗口内逐日数据点的数组，每个点含 hasData 布尔值：hasData=false 表示当天无观测，不能当作销量为 0（hasData=true 且 sales=0 才是真零销量）。
8. 脚本默认始终把完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-mpstats-ozon-product-trend-<timestamp>.json（<cwd> 为脚本执行时的工作目录，<session> 取自环境变量 SESSION_ID），禁止写入 /tmp，当前目录不可写则报错。
9. 响应体 ≤ 8 KB 时，落盘后把完整 JSON 打印到 stdout；> 8 KB 时只输出摘要（顶层字段、total/costToken 等常见计数、最大列表字段长度 + 前 3 条样本）；加 --inline 可强制全量打印到 stdout（同样落盘）。
10. 读数据时先看摘要判断是否够用；需要具体字段时优先用 jq 或 ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。
11. 遵守成本约束：本工具消耗算力，同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存；失败或空结果不得自动换关键词、翻页或改邮编连续试探，需要继续检索时先向用户说明会产生额外消耗。
12. 遇到未配置 API Key（环境变量 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY 未设置）、响应 401/402、或提示算力/余额不足（如“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”）时，按 references/onboarding.md 引导解决。
13. 展示时优先用简单表格或适合 sparkline 的输出，每行一个日期，包含 date、price、sales、balance、rating、comments，不要把 90 个点的序列硬塞成一段话。
14. 用 hasData 区分数据缺口与零销量：hasData=false 是当天无观测，不要报告为零销量日。
15. 对异常要如实标注：单日大幅尖峰，或 hasData=true 期间出现 balance=0 的连续断货，应客观指出，而不是给出购买建议。
16. 价格默认货币为 RUB（每个数据点的 currency 字段带符号，如 ₽），展示价格变动时说明币种。
17. 接口不返回每日营收；若用户要每日营收，用 sales * price 估算并注明这是估算值。
18. 当 includeSearchStats 没有返回搜索可见性字段时，注明“搜索位次数据在该赛道暂不可用”，不要静默省略。
19. 只呈现走势形态，不提供商业建议（是否该买这个 listing 交给用户判断）。
20. 与其他 Ozon 技能串联：先用 mpstats-ozon-product-search 发现 SKU，再用本技能验证增长/波动；用 mpstats-ozon-product-detail 看周期聚合值，用本技能看其背后的逐日形态；在 brand-products / category-products / seller-products 发现热门 SKU 后，用本技能验证热度是近期、季节性还是持续的。
21. 当技能功能与实际行为不符、结果与用户意图不符、用户表达不满或称赞、或发现可改进之处时，按 references/api.md 调用 Feedback API 上报反馈，不要打断用户流程。

适用边界 · 注意事项

• 需要多个 SKU 的批量快照或周期聚合时，改用 mpstats-ozon-product-detail。
• 需要品牌/类目/卖家维度的下钻分析时，改用对应的 *-products 技能。
• 需要先做无 ID 的商品发现时，改用 mpstats-ozon-product-search。
• 非 Ozon 平台（如 Wildberries 及其他俄罗斯市场平台）不覆盖。