用途
本技能用于按 Ozon 商品 SKU 从 Seerfar 分析数据库拉取单个商品的完整详情，是单品深度分析、竞品商品拆解、商品链接诊断和销量趋势追踪的起点。
主要能力
- 返回商品基本信息：标题、价格（卢布 ₽，由 currency 标识）、评分、评论数、QA 数。
- 返回销量与营收指标：统计窗口内的总销量（totalSales）、日均销量（dailySales）、销售额（totalRevenue）以及每日销量趋势（salesTrendVOList）。
- 返回库存、类目排名历史（categoryRanks，按月，含 date、rank、count）、品牌、卖家、配送方式（FBO/FBS/OZON）、重量、上架时间（upTime 毫秒时间戳）及上架天数/月数（upDays / upMonths）。
- 支持通过 dateRange 控制销量与指标窗口，默认 past_30_days，可选 past_7_days / past_30_days / past_60_days / past_90_days / past_180_days / past_365_days。
使用方式
参数：
- sku（string，必填）：Ozon 商品 SKU，例如 175924376。
- dateRange（string，选填）：销量/指标窗口，默认 past_30_days。
- uId（string，选填）：用户 ID。
- memberId（string，选填）：成员 ID（数据归属）。
仅 sku 为必填项。
调用方式：
- API 端点：POST /seerfar/ozon/productDetailSearch（完整参数/响应/错误码见 references/api.md）。
- Python 脚本：python scripts/seerfar_ozon_product_detail_search.py '<JSON 参数>' [--inline]。
输出策略：始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-seerfar-ozon-product-detail-search-<timestamp>.json；响应体 ≤ 8 KB 时打印完整 JSON 到 stdout，> 8 KB 时只输出摘要，加 --inline 强制全量打印。建议先用摘要判断，再用 jq 或 ConvertFrom-Json 从保存的 json 按需抽取字段。
认证与算力问题：未配置 API Key（环境变量 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY）、响应 401/402、算力或余额不足等情况，参照 references/onboarding.md 引导解决。
适用场景
- 查看某个 Ozon 商品的详情与数据快照。
- 了解某竞品最近一段时间的总销量与日均销量。
- 查询某商品销售额、库存、类目排名。
- 查看某商品每日销量趋势，判断哪天卖得最好。
- 识别某商品的卖家与品牌、上架时长。
使用限制
- sku 必填，缺省会返回参数错误。
- 单 SKU 端点：一次只返回一个商品详情，无批量/列表模式；对比商品需按 SKU 逐个调用。
- dateRange 仅影响销量聚合与趋势；商品元数据（标题、价格、评分、品牌、卖家、重量、配送方式）为某一时点快照，不受窗口影响。
- 条件字段：weight（仅实物商品）与 grossMargin 为 schema 定义，但部分商品不返回（如数字商品 / Ozon 平台卖家）；monthlySalesUnits / monthlySalesRevenue 会返回，且反映所选窗口的 totalSales / totalRevenue。
- 销量/销售额为 Seerfar 模型在所选窗口内的估算值，并非 Ozon 官方数据。
- total 反映返回记录数（找到 SKU 时为 1），并非目录总数。
- 空结果：不存在的 sku 会以 total:0 和空 products 返回成功，应提示 SKU 可能有误。
- 错误处理：code 非 200（或 errcode 非 200）时依据 msg / errmsg 说明并给出修复建议。
- 成本约束：本工具消耗 5 算力，用户会因算力消耗支付费用；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存；失败/空结果不得自动换关键词、翻页或改邮编连续试探。
查询构建建议
- 先解析 SKU：若用户给出的是商品名、URL 或店铺而非 SKU，需先用 Seerfar Ozon 的列表级来源（店铺搜索 / 关键词反查 / 类目搜索 / 市场关键词搜索）获取 sku，再调用本技能。
- 按意图选择 dateRange：短窗口（近 7 天 / 近 30 天）看近期动能与当前库存；长窗口（近 90/180/365 天）看生命周期、季节性与排名稳定性。
- 先读聚合再看趋势：先看顶层 totalSales / dailySales / totalRevenue / stock / categoryRanks 获取快照，再深入 salesTrendVOList 查看日序列。
- 每次调用一个 SKU。
展示规则
- 仅呈现数据：以清晰布局展示商品指标，不加入主观建议。
- 先身份与快照：标题、sku、价格（₽）、reviewRating（reviewCount 条评论、questionsAndAnswers 条 QA），再展示销量快照（totalSales、dailySales、totalRevenue、stock）与窗口（startDate–endDate）。
- 类目排名：categoryRanks 为按月排名历史（{date, rank, count}），不含类目名称，需配合 categoryInfo（titlePath / cnTitlePath）展示类目路径。
- 销量趋势：salesTrendVOList 为日序列（{date, sales, revenue, price, stock, reviewCount, reviewRating}），应总结（峰值日、趋势方向）而非逐行罗列，完整序列可提供保存文件。sales: 0 视为无销量，而非数据缺失。
- 卖家与品牌：展示 sellerName（sellerId，负值表示 Ozon 平台卖家）与 brandName（brandId）。
- 配送方式：fulfillment 为数组（如 ["FBO"]，平台自营为 ["OZON"]），多值以 / 连接。
- 上架时长：upTime 以日期（毫秒时间戳）形式展示，并配合 upDays / upMonths。
- 条件字段缺失时以 - 展示，不视为失败。