用途
本技能用于把 Ozon 俄罗斯站的商品数据转化为可核验的选品与竞品研究结果。整体链路为：先按俄语关键词或 Ozon SKU 找到商品，再按 SKU、品牌、类目或卖家查看价格、销量、销售额、评分、库存、周转、排名和时间走势。
使用前需安装 LinkFox MCP 连接器：在 WorkBuddy 左侧找到“专家·技能·连接器”→“连接器”，搜索“LinkFox”并安装（注意是 linkfox，不是 linkfox-product-selection），按指引完成登录授权后返回 WorkBuddy 重试。未安装时技能无法调用。
主要能力
技能覆盖 6 个业务子能力，通过 WorkBuddy 的 LinkFox.proxy_call 调用 6 个精确 endpoint toolName：
- 商品发现与身份解析（mpstats/ozon/productSearch）：用俄语关键词或 Ozon SKU 列表检索商品，返回 productId、俄语标题、商品页、主图、品牌和卖家等身份字段，作为后续详情、趋势或维度分析的入口。
- SKU 商品卡核验（mpstats/ozon/productDetail）：对已有 SKU 批量查询商品详情，单次最多 100 个，返回价格、折扣、Ozon Card 价、评分、评论数、库存、配送方案、统计期销量/销售额、上期对比、潜在销售额和缺货损失等字段；服务端逐 SKU 并发并对失败项自动重试一次，允许部分成功。
- 单 SKU 分日走势（mpstats/ozon/productTrend）：围绕一个 productId 查看指定日期窗口的每日价格、销量、库存、评分、评论数以及畅销/新品标记；includeSearchStats 可请求搜索可见性扩展，但以实际返回 schema 为准。
- 品牌维度商品洞察（mpstats/ozon/brandProducts）：按 Ozon 前台展示的品牌名查询该品牌 SKU，支持数值筛选、排序、分页、货币换算和 FBO/FBS 口径切换，用于品牌商品结构、爆款和销售额占比观察。
- 类目维度商品洞察（mpstats/ozon/categoryProducts）：按 Ozon 使用的俄语完整类目路径查询商品，支持销量、价格、评分、库存、周转、损失销售额等多条件筛选和类目内排名，用于类目爆款与细分机会扫描。
- 卖家维度商品洞察（mpstats/ozon/sellerProducts）：按数字型 sellerId 查询店铺 SKU，支持与品牌/类目维度相同的筛选、排序、分页、货币和 FBO/FBS 选项，用于店铺结构、卖家爆款和竞店对标。
统一研究链路中，发现结果里的 productId、brand、brandId、sellerId 和 category 可继续用于 SKU 详情、趋势或品牌/类目/卖家下钻；各查询结果中的 costToken、costTime 和日期字段用于审计调用成本与数据时点。
使用方式
MCP Server 为 LinkFox，统一工具为 proxy_call。proxy_call 的 toolName 必须使用上表中的精确值，大小写敏感且不带前导 /；业务参数直接放在 arguments，不要再包一层 body、params 或 data。WorkBuddy 自动注入授权上下文，禁止在 arguments 中传 headers、Authorization、API Key、token、JWT 或手机号，也不读取本地环境变量补充认证。proxy_call 的结果若是 JSON 字符串，只解析一次；解析后按各子能力的响应字段表处理，先区分 MCP 传输/配置错误，再处理下游业务 code/errcode 与 msg/errmsg。
工具选择建议：没有 ID 就先做商品发现；已有 SKU 且问汇总指标就做详情；问“随时间如何变化”才做趋势；已有品牌名、完整类目路径或卖家 ID 时直接使用对应维度下钻。多个候选都能满足时，优先选择能直接回答问题且请求条数最少的 operation。
示例（关键词发现）：以 toolName="mpstats/ozon/productSearch" 调用 proxy_call，参数 {"keyword":"кроссовки","startDate":"2025-03-01","endDate":"2025-03-31"}。出参重点看 products[].productId/title/brand/sellerId/sellerName/productPageUrl/imageUrl、total 和 costToken。
示例（批量 SKU 商品卡）：以 toolName="mpstats/ozon/productDetail" 调用，参数包含 productIds、startDate、endDate、includeFbs。出参看 products[] 的 price/monthlySalesUnits/monthlySalesRevenue/rating/reviewCount/balance/deliveryScheme，需要缺货影响时再看 revenuePotential/lostProfit/lostProfitPercent，并将 previousSalesUnits/previousRevenue 与当期并列。
示例（单 SKU 趋势）：以 toolName="mpstats/ozon/productTrend" 调用，出参是顶层 data[]，逐日读取 date/hasData/price/sales/balance/rating/comments/isBestseller/isNew。
示例（品牌下钻）：以 toolName="mpstats/ozon/brandProducts" 调用，brandName 需为精确展示名，filters 按 AND 处理，BETWEEN 必须提供 value2。
示例（类目扫描）：以 toolName="mpstats/ozon/categoryProducts" 调用，categoryPath 必须是 Ozon 俄语完整路径，可用 total 判断是否还有下一页。
示例（卖家拆解）：以 toolName="mpstats/ozon/sellerProducts" 调用，sellerId 必须是数字字符串；只有卖家名称时先用商品搜索解析数字 sellerId。
适用场景
- 按俄语关键词或 SKU 在 Ozon 发现商品并获取身份信息。
- 批量核验竞品商品卡的价格、销量、评分、库存与配送方案。
- 观察单个 SKU 的每日价格、销量、库存变化及畅销/新品标记。
- 分析某品牌在 Ozon 的商品结构、爆款和销售额占比。
- 扫描某俄语类目下的爆款与细分机会，按销量、价格、周转等条件筛选。
- 拆解某卖家店铺的 SKU 结构、销售额和缺货损失，进行竞店对标。
限制
- 站点范围：只覆盖 MPSTATS 的 Ozon 俄罗斯站数据，不覆盖 Wildberries 或其他俄罗斯/全球电商平台。
- 数据时点：统计接口的 endDate 最晚为昨日（T-1），不能传今天或未来日期。
- 输入匹配维度：搜索至少提供 keyword 或 productIds；详情必须提供 SKU 列表；趋势每次只能提供一个数字型 productId；品牌必须是精确的 Ozon 展示名，不支持模糊匹配；类目必须是俄语完整路径；卖家必须是数字字符串 sellerId。
- 搜索不是指标接口：productSearch 固定返回约 10 个身份字段，不返回价格、销量、评分、库存、周转或排名；需要这些指标时必须转到详情或相应维度下钻。
- 容量限制：商品详情单次最多 100 个 SKU；品牌、类目、卖家每页最多 100 行；商品搜索没有分页、排序和筛选参数，单次结果有上游约 36 条的硬上限；趋势单次只支持一个 SKU。
- 口径限制：品牌/类目/卖家结果的 revenueSharePercent 是当前查询维度结果集内占比，不是全站占比；position 也对应当前查询维度。includeFbs 是整批或整次查询共享的口径开关，不能按单个 SKU 设置。
- 语言与名称：关键词、类目路径和品牌名应优先使用 Ozon 实际使用的俄语或拉丁形式；英文/中文关键词应先转成俄语并标明转换。
- 时间序列缺口：趋势点的 hasData=false 表示没有观测，不等于零销量；缺失字段也不应当成零。趋势接口当前 schema 不保证额外的独立搜索位次字段。
- 数据用途：结果是市场数据与查询结果，不是采购承诺、销量保证或财务/经营结论；不包含评论文本、Listing 文案优化、广告投放、订单、物流、供应链和利润核算建议。
- 积分消耗：用户会因积分消耗而支付费用；高频调用或用户对积分消耗预期不足时应先提醒。
失败与费用处理
禁止回退旧 HTTP 网关、旧 Python 脚本或其他未声明工具。失败、空结果或部分成功不得自动换关键词、翻页、换品牌拼写或连续改日期探测，也不得为“确认结果”重复发起计费调用。确需重试、扩大 page/列表或切换 includeFbs 时，先向用户说明可能产生的额外积分消耗并取得同意。
遇到 401 / authorized error 属 WorkBuddy 自动授权上下文异常，应提示刷新会话或检查连接，不要在参数中补传任何凭证。遇到 402 / 积分或余额不足时，由用户决定是否购买，不要自动下单；可引导用户访问 https://agent.linkfox.com/ 自助处理。403 为无权限，不归入认证/计费问题。