SuperAPI AI 工具集

ecommerce-ozon-shop-search

营销与增长

查看项目

更新于 10-16 01:36

技能介绍

用途:该技能从 Seerfar 分析数据库按店铺 ID 列出某 Ozon 店铺(卖家)的商品目录,是竞品店铺商品分析、爆款挖掘和卖家目录拆解的起点。数据以商品为单位、限定单个店铺,属于店铺级视图,而非关键词或类目视图。

主要能力:返回每个商品的 30 天销量、价格(俄罗斯卢布 ₽)、评分、重量、履约模式(FBO/FBS)、卖家类型(0 本地 / 1 跨境)以及退货取消率,并附带店铺 30 天总销量 totalSales。店铺 ID 为 Seerfar 卖家标识,负值(如 -2 Ozon Express、-4 Ozon Fresh)为 Ozon 平台自营卖家,正值为第三方卖家。若只有店铺名或商品,需先从商品级 Seerfar Ozon 来源取得 sellerId。

使用方式:必填参数为 id(店铺 ID)和 page(分页对象 {page, pageSize, orders[]})。pageSize 默认 20、最大 20,超出返回 errcode 1002;orders 元素为 {field, direction},常用字段 sales、price、reviewRating、upTime。API 端点为 /seerfar/ozon/shopSearch,也可用脚本 python scripts/ozon_shop_search.py '<JSON params>' [--inline]。脚本默认将完整响应写入 <cwd>/nexscope/<日期>/<会话>/data/ 下的 JSON 文件;响应体不超过 8 KB 时打印完整 JSON,超过则只打印摘要,加 --inline 可强制完整输出。建议先看摘要,再用 jq 或 ConvertFrom-Json 按需提取字段。

限制:id 与 page 均必填,缺一返回 errcode 400;total 是当前页行数而非店铺全量商品数,需用 hasNextPage 判断是否翻页;不支持文本或关键词过滤,只能按店铺筛选;退货取消率对第三方卖家有值,对 Ozon 平台自营卖家(负 ID)常缺失;schema 中的 productPageUrl、monthlySalesRevenue、brand 上游无数据源,不返回。该工具消耗积分,同一会话同一参数组合默认单次调用并本地缓存 24 小时,失败或空结果时不要自动更换关键词、分页或参数重试,继续检索前需告知用户额外积分消耗。认证需设置 NEXSCOPE_API_KEY 环境变量,HTTP 401/402 或提示余额不足时需充值。空店铺(不存在的 ID)返回成功但 total=0,应提示 ID 可能有误。