SuperAPI AI 工具集

ecommerce-ozon-category-search

数据与分析

查看项目

更新于 10-16 01:36

技能介绍

用途:从 Seerfar 分析数据库列出指定 Ozon 类目的商品,用于类目容量评估、类目内爆款挖掘和价格带分析。数据以商品为单位,范围限定单个类目,不是店铺或关键词视图。

主要能力:返回类目级汇总(totalSales、totalRevenue、avgPrice、rating、seasonalityAmplitude、seasonalityCoef、startDate/endDate)与分页商品列表(data/products),商品含销量、价格、评分、评论数、品牌、卖家。销量为件数,价格与收入为俄罗斯卢布(₽)。默认覆盖最近 30 天,可用 date 传 yyyy-MM 查询历史月份快照。

使用方式:必填 categoryId 与 page。categoryId 为 Ozon 类目标识,层级用 _ 连接(如 15621032_15621049_115951147);若只有类目名称,需先从上游 Seerfar Ozon 来源解析出 ID。page 为 {page, pageSize, orders[]},pageSize 默认 20、最大 20,超出返回 errcode 1002;orders 元素为 {field, direction},常用字段 sales、price、revenue、reviewRating。可选 fulfillment 为单个字符串(FBO/FBS/RFBS/FBP/OZON),date 为 yyyy-MM。调用入口:API /seerfar/ozon/categorySearch;脚本 python scripts/ozon_category_search.py '<JSON params>' [--inline]。

输出与限制:脚本默认将完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/ 下的 JSON 文件,响应体 ≤8 KB 时同时打印完整 JSON,>8 KB 时仅打印摘要;--inline 可强制完整输出。该工具消耗 credits,同一会话同一参数组合默认单次调用并本地缓存 24 小时,失败或空结果时不要自动更换关键词、分页或参数重试,继续检索前需告知用户额外消耗。需配置 NEXSCOPE_API_KEY,401/402 或余额不足时按提示处理。类目内不支持文本/关键词过滤;total 为当前页行数而非类目商品总数,用 hasNextPage 判断是否还有更多页;sellerType 实为履约方式分布,不含本地/跨境信息。不存在的 categoryId 返回成功但 total=0,应提示 ID 可能有误。店铺目录、关键词发现、关键词挖掘或单个商品详情需使用对应的其他 Seerfar Ozon 技能。