用途:按俄语类目全路径钻取 Ozon(俄罗斯)类目下全部商品,返回每个 SKU 的销量、营收、价格、评分、库存、周转、损失利润等指标,用于类目爆款挖掘、蓝海细分发现和品牌格局扫描。
主要能力:支持分页(每页 1-100,默认 100)、排序(sales、revenue、final_price、balance、rating 等 snake_case 字段,asc/desc)、货币切换(默认 RUB,可设 USD、EUR、CNY 及 currencyRate)、includeFbs 控制是否并入 FBS 数据;filters 为多字段数值条件,AND 组合,操作符含 GTE、LTE、GT、LT、EQ、NOT_EQ、BETWEEN(需 value2),常用字段有 sales、final_price、rating、comments、balance、revenue、days_in_stock、turnover_days、lost_profit、category_position。
使用方式:API 端点 /mpstats/ozon/categoryProducts;脚本 python scripts/ozon_category_products.py '<JSON params>' [--inline]。categoryPath 必须为 Ozon 平台使用的俄语全路径,层级以 / 分隔,例如 Одежда/Женская одежда/Футболки и топы женские;部分路径、英文翻译或仅根级通常返回空。路径需通过上游类目搜索或从 ecommerce-ozon-product-detail / ecommerce-ozon-product-search 的类目字段获取。脚本默认将完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/ecommerce-ozon-category-products-<timestamp>.json;响应 ≤8 KB 时写盘并打印完整 JSON,>8 KB 时仅打印摘要,加 --inline 可强制完整输出。
限制:仅支持俄语全路径;本端点不浏览类目树;每页最多 100 行;数据为 T-1,endDate 不能为今天或未来;工具消耗积分,同一会话同一参数组合默认单次调用并本地缓存 24 小时,失败或空结果时不要自动更换关键词、分页或参数重试,继续检索前需告知用户额外积分消耗;需配置 NEXSCOPE_API_KEY,401/402 或余额不足时按提示处理;仅提供数据视图,不提供业务建议。