openclaw-voc-skill/dist/skills/category-tree/SKILL.md

---

name: category-tree description: 获取 Amazon 完整类目层级树结构，用于定位目标品类的 NodeId。适用于品类定位、竞品所在子类目发现、BSR 类目分析起点。 version: 1.3.0

author: nkkj-BrainHack

category-tree

功能用途

获取 Amazon 类目层级树，找到目标品类的 NodeId 以支持后续品类分析。

核心业务场景：

• 品类定位（找到 'Reed Diffusers' 或 'Candle Warmers' 的精确 NodeId）
• 竞品子类目发现（确认竞品 BSR 所在的二级/三级类目）
• 类目层级关系梳理（报告品类结构 Slide）

调用链（Workflow）

本步: category-tree() → 获取全类目树 → 找到目标品类 NodeId
下游: category-products(NodeId) → 获取该类目下 Top 产品列表

入参规则

参数	类型	必填	说明
domain	integer	❌	站点 ID: 1=amazon.com 2=amazon.co.uk 3=amazon.de（默认 1）

接口调用方式

• 请求方法: POST

• 接口地址: https://server.fmode.cn/api/voc-ecom/forward

  {
  "path": "/api/CategoryTree",
  "method": "POST",
  "query": { "domain": 1 },
  "body": {}
  }
  

关键响应字段

字段	业务用途
NodeId	类目节点 ID → 传入 category-products 的 NodeId
Name	类目名称 → 定位目标品类
Children	子类目列表 → 递归查找精确子类目

依赖要求

• 通过 https://server.fmode.cn/api/voc-ecom/forward 统一转发，认证已内置
• 返回完整类目树，需在结果中查找目标类目名称对应的 NodeId