用途
本技能针对 Ozon（俄罗斯站）的某一类目进行下钻，返回该类目下全部商品（SKU）的数据视图。资料给出的适用场景包括：类目爆款挖掘、蓝海细分扫描、中价位与快周转筛选、品牌格局预切分（后续在客户端按品牌分组）、类目中损失销售额（lost profit）机会排查。
边界判断：当分析维度是类目路径、且需要该路径下按 SKU 的汇总数据时使用本技能。跨类目比较需多次调用并在 Agent 层融合结果。不适用的情况包括：类目路径未知（应先用 mpstats-ozon-product-search 或商品详情发现准确的俄语路径）、按品牌下钻（mpstats-ozon-brand-products）、按卖家下钻（mpstats-ozon-seller-products）、单 SKU 时间序列（mpstats-ozon-product-trend）、以及 Wildberries 等其他俄罗斯市场平台。
主要能力
- 按俄语完整类目路径返回该类目下商品的完整指标，资料列出的指标包括：销量、销售额、价格、评分、库存、周转、损失销售额等，以及 comments（评价数）、days_in_stock、turnover_days、category_position 等字段。
- 支持多维数值筛选（filters），多个条件以 AND 方式组合。
- 支持排序（sortField / sortDirection）与分页（page / pageSize，每页 1-100，默认 100）。
- 货币换算：默认 RUB，可切换 USD、EUR、CNY 等，并可指定 currencyRate。
- FBO / FBS：includeFbs 为 true 时将 FBS 计入库存 / 销售数字，为 false 则仅 FBO。
- 时间窗口：startDate 与 endDate 为 YYYY-MM-DD，最晚为昨天（T-1）。
使用方式
参数：categoryPath（必填，俄语完整类目路径，以 / 分隔层级）、startDate、endDate、page、pageSize、sortField（snake_case 列名，如 sales、revenue、final_price、balance、rating）、sortDirection（asc / desc）、currency、currencyRate、includeFbs、filters。
筛选条目格式为 {"field": "<snake_case>", "op": "<OP>", "value": <num>, "value2": <num?>}。常用字段包括 sales（月销量）、final_price（价格 RUB）、rating（0-5）、comments（评价数）、balance（库存）、revenue（销售额 RUB）、days_in_stock、turnover_days、lost_profit、category_position。支持的操作符：GTE、LTE、GT、LT、EQ、NOT_EQ、BETWEEN（需要 value2）。
调用方法：
- API 端点：POST /mpstats/ozon/categoryProducts（完整参数、响应与错误码见 references/api.md）。
- Python 脚本：python scripts/mpstats_ozon_category_products.py '<JSON 参数>' [--inline]
成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败或空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时应先向用户说明会产生额外消耗。
输出策略（脚本默认行为）：
- 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-mpstats-ozon-category-products-<timestamp>.json（<cwd> 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；<session> 取自环境变量 SESSION_ID；禁止写入 /tmp，当前目录不可写则报错）。
- 响应体 ≤ 8 KB：落盘后将完整 JSON 打印到 stdout。
- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本）。
- 加 --inline 可强制全量打印到 stdout（同样落盘）。
读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq 或 ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。
认证与算力问题：出现未配置 API Key（环境变量 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY 未配置）、响应 401 或 402、以及提示算力或余额不足（如含 "算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值" 等含义内容）等异常时，按 references/onboarding.md 引导解决。
使用示例
-
女性 T 恤按销量排序： { "categoryPath": "Одежда/Женская одежда/Футболки и топы женские", "sortField": "sales", "sortDirection": "desc", "pageSize": 100 }
-
蓝海筛选（销量 ≥ 50，评分 ≥ 4.5）： { "categoryPath": "Одежда/Женская одежда/Футболки и топы женские", "filters": [ {"field": "sales", "op": "GTE", "value": 50}, {"field": "rating", "op": "GTE", "value": 4.5} ], "sortField": "revenue", "sortDirection": "desc" }
-
中价位 + 强周转： { "categoryPath": "Электроника/Наушники", "filters": [ {"field": "final_price", "op": "BETWEEN", "value": 1500, "value2": 5000}, {"field": "turnover_days", "op": "LTE", "value": 30} ] }
-
美元换算排名用于跨市场比较： { "categoryPath": "Электроника/Смартфоны", "currency": "USD", "sortField": "revenue", "sortDirection": "desc" }
-
高损失销售额类目扫描： { "categoryPath": "Одежда/Мужская одежда/Куртки мужские", "filters": [{"field": "lost_profit", "op": "GTE", "value": 500000}], "sortField": "lost_profit", "sortDirection": "desc" }
展示规则
紧凑类目表格，关键列包括：productId、title、brand、sellerName、price、monthlySalesUnits、monthlySalesRevenue、rating、balance、position、revenueSharePercent。
- 收入占比（revenue share）是在本次类目查询范围内的 0-100%，展示时需说明口径。
- 俄语标题 / 品牌保留原文，按需翻译。
- 标注货币；若为换算结果需注明“已按 USD 换算”。
- 分页需报告总数；对于超大目录（数万 SKU）建议收紧筛选条件，而非盲目翻页。
- 类目排名（categoryPosition）数值越小越好，展示时需说明。
适用场景与限制
适用：类目范围下的 Ozon 商品指标查询，例如“Ozon X 类目爆款”“在某细分找蓝海 SKU”“展示该类目中价位快周转商品”“哪些品牌主导该 Ozon 类目”（先导数据，再在客户端按品牌分组）“X 类目存在大量损失销售额机会”（缺货痛点排查）。
限制：
- 仅支持俄语完整路径；部分路径或翻译后的路径返回空结果。
- 路径发现属于上游步骤；本端点不浏览类目树，需先通过商品详情 / 搜索得到路径。
- 每页最多 100 行。
- T-1 数据：endDate 不能是今天或未来日期。
- 不提供经营建议，仅为数据视图。
算力消耗规则
按动态规则计费：消耗算力 = 12；列表为空返回 0。资料特别提示：本技能的服务按倍数动态计算，可能一次性消耗大量算力，必须提醒用户并由用户决定是否继续。