openclaw-voc-skill/voc/category-products/api-config.json

{
  "name": "category_products",
  "displayName": "Amazon 类目产品查询",
  "description": "根据类目 ID 获取该类目下的产品列表。用于获取品类 Top 产品、分析品类竞争格局、统计品牌分布和中国卖家占比。",
  "category": "voc",
  "version": "1.0.0",
  "endpoint": {
    "method": "POST",
    "url": "https://server-msq.fmode.cn/api/sorftime/forward",
    "headers": {
      "Content-Type": "application/json"
    }
  },
  "parameters": {
    "type": "object",
    "required": ["NodeId"],
    "properties": {
      "NodeId": {
        "type": "string",
        "description": "Amazon 类目节点 ID，可通过 category_tree 接口获取"
      },
      "domain": {
        "type": "integer",
        "description": "Amazon 站点 ID: 1=amazon.com",
        "default": 1
      }
    }
  },
  "requestTransform": {
    "template": {
      "path": "/api/CategoryProducts",
      "method": "POST",
      "query": { "domain": "{{domain}}" },
      "body": {
        "NodeId": "{{NodeId}}"
      }
    }
  },
  "response": {
    "type": "array",
    "description": "类目下的产品列表",
    "items": {
      "type": "object",
      "properties": {
        "Asin": { "type": "string", "description": "产品 ASIN" },
        "Title": { "type": "string", "description": "产品标题" },
        "Price": { "type": "number", "description": "售价" },
        "Rating": { "type": "number", "description": "评分" },
        "RatingsCount": { "type": "integer", "description": "评论数" },
        "BSR": { "type": "integer", "description": "BSR 排名" },
        "Brand": { "type": "string", "description": "品牌" }
      }
    }
  },
  "relatedSkills": ["category_tree"],
  "usageExamples": [
    {
      "name": "获取类目产品列表",
      "input": { "NodeId": "3734931", "domain": 1 },
      "description": "获取指定类目下的产品列表"
    }
  ],
  "reportMapping": {
    "slides": ["市场全景(Slide3)"],
    "dataPoints": ["品类产品列表", "品牌分布", "价格带分析"]
  }
}