用途：在 Nexscope 分析数据库中搜索 Ozon（俄罗斯）商品，是 Ozon 商品发现与竞品反查的入口；后续品牌、类目、卖家、详情、趋势等下钻通常都从本技能返回的 ID 开始。
主要能力：
- 按俄语关键词搜索商品；
- 按 Ozon SKU 列表批量反查；
- 支持 startDate、endDate 指定统计窗口（默认一年前至今）。
返回字段固定为 10 个身份字段：productId、title、productPageUrl、imageUrl、brand、brandId、sellerName、sellerId、sourceType、sourceTool。不含价格、销量、评分、库存、周转、排名等业务指标，这些需转 ecommerce.ozon-product-detail（单/批 36 字段）或品牌/类目/卖家下钻技能（39 字段）。
使用方式：
- API 端点：/mpstats/ozon/productSearch；
- 脚本：python scripts/ozon_product_search.py '<JSON params>' [--inline]；
- 示例：{"keyword": "кроссовки"}；{"productIds": [1786874757, 151623766, 142257239]}；{"keyword": "футболка", "startDate": "2025-02-01", "endDate": "2025-02-28"}。
限制：
- keyword / productIds 至少需提供一个（业务规则要求，即便 schema 标为可选）；
- 关键词须为俄语（西里尔字母）或 Ozon 前台实际使用的拉丁写法，英/中文关键词需先翻译；
- endDate 不能为今天或未来，数据为 T-1；
- 单次调用最多约 36 条记录，无分页/排序/过滤，超限只能收窄关键词、SKU 或日期窗口；
- 该端点不返回任何业务指标，不要用身份字段估算；
- 消耗 credits，同一会话同一参数组合默认单次调用并本地缓存 24 小时，失败或空结果不要自动换词重试；
- 需设置 NEXSCOPE_API_KEY，遇 401/402 或额度不足需充值，参见官方帮助与定价页面。
适用场景：Ozon 商品关键词发现、批量 SKU 反查名称、跨语言关键词翻译后检索；不适用于需要单 SKU 销量/收入/库存/评分、品牌或卖家维度商品列表、单品时间序列趋势、Wildberries 等其他俄罗斯平台、类目路径导航等需求。