用途:按 Ozon 店铺前台显示的品牌名(俄文或拉丁文)下钻该品牌全部在售商品,逐 SKU 返回销量、营收、价格、评分、评论数、库存、周转天数、损失利润等指标,用于品牌竞品审计、品牌 SKU 结构与畅销品分析。
主要能力:brandName 必填,须与 Ozon 前台显示一致,不能填类目路径、卖家 ID 或内部品牌代码;不确定拼写时先用 ecommerce-ozon-product-search 解析。filters 数组支持多个数值条件按 AND 组合,每项为 {field, op, value, value2?},常用字段含 sales、final_price、rating、comments、balance、revenue、days_in_stock、turnover_days、lost_profit、category_position,操作符含 GTE、LTE、GT、LT、EQ、NOT_EQ、BETWEEN(需 value2 作上界)。支持 startDate/endDate(最新为昨天)、page、pageSize(1-100,默认 100)、sortField(snake_case 列名)、sortDirection、currency(默认 RUB,可设 USD 等由服务端换算)、currencyRate、includeFbs(true 时并入 FBS 库存与销量)。
使用方式:API 端点 /mpstats/ozon/brandProducts;脚本 python scripts/ozon_brand_products.py '<JSON params>' [--inline]。脚本默认将完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/ecommerce-ozon-brand-products-<timestamp>.json,响应体不超过 8 KB 时打印完整 JSON,超过则只打印摘要;加 --inline 强制完整输出。读取时先看摘要,再用 jq 或 ConvertFrom-Json 按需提取字段。需配置 NEXSCOPE_API_KEY;出现 401/402 或额度不足时按提示充值。
限制:品牌名精确匹配,无模糊搜索,拼写错误返回空结果;每页最多 100 行,大品牌需分页;endDate 不能为今天或未来(T-1 数据);货币换算在服务端完成,历史汇率可能与参考汇率略有差异;商品标题为俄文,仅在用户要求时翻译;该工具消耗额度,同一会话同一参数组合默认单次调用并本地缓存 24 小时,失败或空结果时不要自动更换关键词、分页或参数重试,继续检索前须告知用户额外消耗。仅覆盖 Ozon,不含 Wildberries 等其他俄罗斯平台;类目级跨品牌比较、卖家维度分析、单 SKU 时间序列需改用对应技能。