SuperAPI AI 工具集

ecommerce-ozon-product-detail-search

数据与分析

查看项目

更新于 10-16 01:36

技能介绍

用途:按 Ozon 商品 SKU 从 Seerfar 分析数据库获取单个商品的完整详情,是单品深度分析、竞品拆解、Listing 诊断和销售趋势跟踪的起点。数据单位为单个商品(一个 SKU),不是店铺目录、关键词或类目视图。

主要能力:返回标题、价格(卢布)、评分、评论数、QA 数、销量(totalSales 总量 + dailySales 日均 + salesTrendVOList 日趋势)、营收(totalRevenue)、库存、类目排名(categoryRanks,月度排名历史)、品牌(brandName/brandId)、卖家(sellerName/sellerId,sellerId 为负表示 Ozon 平台卖家)、履约(FBO/FBS/OZON 数组)、重量(仅实体商品)与上架时长(upTime/upDays/upMonths)。

使用方式:接口 /seerfar/ozon/productDetailSearch;脚本 python scripts/ozon_product_detail_search.py '<JSON params>' [--inline]。唯一必填参数 sku;dateRange 控制销售指标窗口,默认 past_30_days,可选 past_7_days、past_30_days、past_60_days、past_90_days、past_180_days、past_365_days;uId、memberId 可选。若只有商品名、URL 或店铺,需先用 Seerfar Ozon 店铺搜索/关键词反查/类目搜索/市场关键词搜索等列表级工具取得 sku。脚本默认把完整响应写入工作目录 nexscope/<日期>/<session>/data/ 下的 JSON 文件,响应体超过 8KB 时 stdout 只打印摘要,可用 --inline 强制完整输出,再用 jq 等按需提取字段。

限制:sku 必填;单 SKU 接口,无批量/列表模式,比较商品需逐 SKU 调用;dateRange 只影响销售聚合与趋势,商品元数据为瞬时快照;重量与 grossMargin 为条件字段,数字商品或 Ozon 平台卖家可能不返回;销量与营收是 Seerfar 模型估算值,非 Ozon 官方数据;total 反映返回记录数(找到时为 1)。该工具消耗积分,同一会话同一参数组合默认单次调用并有 24 小时本地缓存,失败或空结果时不要自动更换关键词、分页或参数重试。认证需设置 NEXSCOPE_API_KEY 环境变量,HTTP 401/402 或余额不足时需补充密钥或前往 https://www.nexscope.ai/pricing?co-from=skillNS 充值,入门指引见 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS。不存在的 SKU 返回 success、total:0 与空 products,应提示 SKU 可能有误而非系统错误。