SuperAPI AI 工具集

linkfox-seerfar-ozon-product-report-search

营销与增长

查看项目

更新于 10-15 17:34

技能介绍

用途:搜索 Seerfar Ozon 商品数据库,按丰富指标筛选商品,返回商品级(每个 SKU 一行)报表记录,是 Ozon 选品、竞品商品分析、畅销品挖掘和价格/转化带筛选的起点。数据单位为商品而非关键词。

主要能力:支持按销量、销售额及其增长率、购物车转化率、下单转化率、价格(卢布)、评分、评论数、QA 数、变体数、浏览量、毛利率、退货取消率、广告费用份额、重量/体积、上架时间、品牌、卖家、配送方式、标签等指标以 {min,max} 范围筛选,并可排序、分页。sourceType 固定为 ozon;配送方式取值为 OZON、FBO、FBS、RFBS、FBP。响应中 data 与 products 为相同的商品数组,total 为匹配总数(无筛选可达数千万)。六个字段存在同值的原始/统一别名对:sku/productId、sales/monthlySalesUnits、revenue/monthlySalesRevenue、reviewRating/rating、brandName/brand、productUrl/productPageUrl。searchDate 选择数据月份,传 2026-04-01 表示 2026 年 3 月,省略则默认近 30 天,销售/销售额随所选周期变化。

使用方式:API 端点为 POST /seerfar/ozon/productReportSearch(完整参数、响应与错误码见 references/api.md);Python 脚本调用:python scripts/seerfar_ozon_product_report_search.py '<JSON 参数>' [--inline]。page 为必填,包含分页与排序 {page, pageSize, orders[]},page 从 1 开始,pageSize 默认 20,orders 为 {field, direction}(DESC/ASC)。脚本总是将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/…json(禁止写 /tmp),响应体 ≤8KB 时打印完整 JSON,>8KB 时仅输出摘要,加 --inline 强制全量打印。建议先看摘要,再用 jq 或 ConvertFrom-Json 从保存文件按需抽取字段。常见组合:按 sales DESC 挖掘畅销品;monthlySales 下限加 price 上限找低价高销;categoryIds + fulfillment + labels 查类目爆款;creationDate=1 配合 salesRate DESC 找新上架增长品;用 skus 查指定商品报表。

限制:page 必填;skus 每次最多 10 个;categoryIds 需 Seerfar 类目 ID 而非名称;total 为全量匹配数,应排序分页而非盲目遍历;errcode 1003 表示请求过于频繁需等待重试;排序字段需使用响应中的指标字段。调用消耗 15 算力,用户需为算力付费,高频调用前应提醒用户确认。需配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY;401/402 或余额不足时按 references/onboarding.md 处理。非 Ozon 平台、关键词市场数据、单店商品目录、类目聚合等场景不在本技能覆盖范围。

展示规则:仅呈现数据、不做主观建议;优先展示标题、SKU、价格(₽)、销量、销售额、评分、评论数,其次品牌/卖家/配送方式;统一字段与原始别名为同值,不应作为独立字段重复展示。