linkfox-seerfar-ozon-product-detail-search

Seerfar Ozon 商品详情搜索

此技能通过 Seerfar 分析数据库中的 SKU 获取单个 Ozon 商品的完整详情，包括标题、价格（₽）、评分、评论数、问答数、销量（总销量 + 日均销量 + 每日趋势）、营收、库存、类目排名、品牌、卖家、履约方式（FBO/FBS/OZON）、重量和上架时长。适用于单品深度分析、竞品商品拆解、商品信息诊断和销售趋势追踪。

核心概念

数据单位是单个商品，按 sku 查询：传入一个 Ozon SKU，即可获取该商品的完整详情。这是商品级视图（一个 SKU），而非店铺商品目录、关键词或类目视图。

SKU 的来源：sku 是 Ozon 商品 SKU，与其他 Seerfar Ozon 工具（店铺搜索、关键词反向搜索、类目搜索、市场关键词搜索）返回的 sku 相同。如果用户只有商品名称、URL 或店铺信息，请先从上述列表级数据源获取 sku，再调用此技能进行深入分析。

销售时间范围：dateRange 控制销售/指标的时间范围，totalSales、dailySales、totalRevenue 和 salesTrendVOList 均在此范围内计算。默认值为 past_30_days。可选值：past_7_days / past_30_days / past_60_days / past_90_days / past_180_days / past_365_days。

销售额和价格的货币单位：price 的单位为俄罗斯卢布（₽），由 currency 指明。totalSales 是该时间范围内的销量；dailySales 是日均销量；totalRevenue 是该时间范围内的营收。

上架时长：upTime 是上架时间戳（毫秒）；upDays / upMonths 是推算得出的上架天数 / 月数。

参数

参数	类型	必填	描述
sku	string	是	Ozon 商品 SKU（例如 175924376）。与其他 Seerfar Ozon 工具中的 sku 相同。
dateRange	string	否	销售/指标的时间范围。默认值为 past_30_days。可选值：past_7_days、past_30_days、past_60_days、past_90_days、past_180_days、past_365_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]
• 成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

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

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-seerfar-ozon-product-detail-search-<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. 查看商品默认的 30 天详情

{"sku": "175924376"}

2. 最近 7 天（近期走势）

{"sku": "175924376", "dateRange": "past_7_days"}

3. 最近 90 天（季度趋势）

{"sku": "175924376", "dateRange": "past_90_days"}

4. 全年（生命周期视图）

{"sku": "175924376", "dateRange": "past_365_days"}

如何构建查询

1. 先解析 SKU：如果用户提供的是产品名称、URL 或店铺，而不是 SKU，请先从 Seerfar Ozon 的商品列表级数据源（店铺搜索／关键词反查／类目搜索／市场关键词搜索）获取 sku，再调用此技能。
2. 根据意图选择 dateRange：近期趋势和当前库存使用较短时间窗口（past_7_days／past_30_days）；产品生命周期、季节性和排名稳定性使用较长时间窗口（past_90_days／past_180_days／past_365_days）。
3. 先读取汇总数据，再查看趋势：先查看顶层的 totalSales／dailySales／totalRevenue／stock／categoryRanks，了解快照数据，然后深入查看 salesTrendVOList 中的每日数据序列。
4. 每次调用一个 SKU：此端点只接受单个 sku；如需比较产品，请针对每个 SKU 分别调用一次。

显示规则

1. 仅呈现数据：以清晰的布局展示产品指标，不提供主观建议。
2. 先展示身份信息和快照：依次展示 title、sku、price（₽）、reviewRating（reviewCount 条评论，questionsAndAnswers 条问答），然后展示销售快照（totalSales、dailySales、totalRevenue、stock）和时间窗口（startDate–endDate）。
3. 类目排名：categoryRanks 是按月记录的排名历史（{date, rank, count}），其中不含类目名称，因此请同时展示 categoryInfo 中的类目路径（titlePath／cnTitlePath）。
4. 销售趋势：salesTrendVOList 是每日数据序列（{date, sales, revenue, price, stock, reviewCount, reviewRating}）。请总结（峰值日期、趋势方向），不要逐行列出所有数据；提供持久化文件以供查看完整数据序列。某些日期的 sales 可能为 0，应视为无销量，而非缺失数据。
5. 卖家和品牌：展示 sellerName（sellerId 为负数时表示 Ozon 平台卖家）和 brandName（brandId），以便用户追溯卖家和品牌。
6. 配送方式：fulfillment 是一个数组（例如 ["FBO"]，平台销售的商品则为 ["OZON"]）；多个值之间用 / 连接。
7. 上架时长：将 upTime（毫秒时间戳）转换为日期，并与 upDays／upMonths 一同展示。
8. 条件字段：weight（仅适用于实物商品）和 grossMargin 已在架构中定义，但部分产品（例如数字商品／Ozon 平台卖家的商品）可能不包含这些字段；缺失时显示 -，不要报错。monthlySalesUnits／monthlySalesRevenue 与时间窗口内的 totalSales／totalRevenue 相对应，可以直接读取。
9. 结果为空：不存在的 sku 会返回成功响应，total:0 且 products 为空；请告知用户 SKU 可能有误，而不要报告系统错误。
10. 错误处理：当 code 不为 "200"（或 errcode 不为 200）时，请根据 msg／errmsg 说明原因并建议解决方法（检查 SKU、遇到速率限制时重试）。

重要限制

• 必须提供 sku；省略该参数会返回参数错误。
• 单 SKU 端点：仅返回一个产品的详情；不支持批量或列表模式。比较产品时，请针对每个 SKU 分别调用一次。
• dateRange 仅影响销售汇总数据和趋势：产品元数据（标题、价格、评分、品牌、卖家、重量、配送方式）是某个时间点的快照，不受时间窗口影响。
• 条件字段：weight（仅适用于实物商品）和 grossMargin 已在架构中定义，但不一定总会返回；数字商品／Ozon 平台卖家的商品可能不包含这些字段。monthlySalesUnits／monthlySalesRevenue 会返回，且与时间窗口内的 totalSales／totalRevenue 相对应。
• 销售额和收入是 Seerfar 模型对所选时间窗口的估算值，并非 Ozon 官方数据。
• total 表示返回的记录数（找到该 SKU 时为 1），而不是目录中的商品总数。

用户表达与场景快速参考

适用 — 深入分析一个 Ozon 商品：

用户说	场景
“查看这个 Ozon 商品的详情” / “这个 SKU 的数据”	单个商品详情
“这个竞品最近 30 天卖了多少” / “日均销量多少”	销量快照（totalSales / dailySales）
“这个商品销售额多少”	销售额（totalRevenue）
“这个商品库存多少”	库存检查（stock）
“这个商品在类目里排第几”	类目排名（categoryRanks）
“这个商品最近销量趋势” / “哪天卖得最好”	每日销量趋势（salesTrendVOList）
“这个商品是谁家的 / 什么品牌”	卖家 + 品牌（sellerName / brandName）
“这个商品上架多久了”	上架时长（upDays / upMonths）

不适用 — 需求超出单个商品详情：

• 查看店铺的完整商品目录 → 使用 Seerfar Ozon 店铺搜索技能。
• 探索 Ozon 关键词 → 使用市场关键词搜索 / 关键词挖掘 / 关键词反查。
• 浏览类目树 → 使用类目搜索。
• 一次汇总多个商品 → 按 SKU 逐个调用此技能，或使用商品列表级数据源。

判断边界：如果用户已有特定的 Ozon SKU（或通过商品列表级数据源获得 SKU），并希望了解该商品的完整指标——销量、销售额、库存、类目排名、趋势、品牌、卖家——请从此处开始。如果用户想要发现商品、关键词或店铺，则先转到相应的 Seerfar Ozon 技能。

算力消耗规则

消耗 5 算力。

用户会因算力消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。

反馈：

遇到以下任一情况时，通过 Feedback API 自动检测并提交反馈：

1. 此技能描述的功能或用途与实际行为不符
2. 此技能的结果与用户意图不符
3. 用户表达对该技能的不满或赞赏
4. 任何你认为可以改进的地方

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

---

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