用途：在 MPSTATS 分析数据库中检索 Ozon（俄罗斯最大综合类电商平台）商品，支持俄语关键词搜索或 SKU 批量反查，是 Ozon 商品发现与竞品查找的入口，后续的品牌/类目/卖家/详情/趋势下钻通常从本技能返回的 ID 开始。
主要能力：返回商品身份卡，仅含 10 个字段——productId、title、productPageUrl、imageUrl、brand、brandId、sellerName、sellerId 以及 sourceType、sourceTool。单 SKU 的价格、销量、评分、库存、周转、排名等指标不在此返回，需改用 ecommerce-ozon-product-detail（批量完整卡，36 字段）或品牌/类目/卖家下钻技能（39 字段）。
使用方式：参数包括 keyword（俄语关键词，如 кроссовки）、productIds（Ozon SKU 列表）、startDate、endDate（YYYY-MM-DD，默认一年前至昨天，不能为今天或未来）。keyword 与 productIds 至少提供一个，可组合缩小范围。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"}。
输出与计费：脚本默认将完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/ 下的 JSON 文件；响应体不超过 8 KB 时打印完整 JSON，超过则只打印摘要，加 --inline 可强制完整输出。该工具消耗积分，同一会话同一参数组合默认只调用一次并本地缓存 24 小时，失败或空结果时不要自动换关键词或翻页重试，继续检索前需告知用户额外积分消耗。
限制：关键词须为俄语（西里尔字母）或 Ozon 前台实际使用的拉丁形式，非俄语关键词通常返回空结果；endDate 不能为今天或未来，数据为 T-1；单次调用最多约 36 条记录，无分页、排序、筛选参数，只能通过缩小关键词/SKU 或日期窗口来收窄；响应中完全没有价格、销量、评分、库存、周转、排名等业务指标，这是硬性契约，不能靠换日期重调补齐。认证问题需设置 NEXSCOPE_API_KEY 环境变量；积分不足可访问 https://www.nexscope.ai/pricing?co-from=skillNS 充值，设置指引见 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS。品牌范围商品列表用 ecommerce-ozon-brand-products，卖家范围用 ecommerce-ozon-seller-products，单 SKU 时间序列用 ecommerce-ozon-product-trend，类目路径用 ecommerce-ozon-category-products；Wildberries 等非 Ozon 平台不在覆盖范围内。