openclaw-voc-skill/competitor-analysis/competitor-bsr-tracking/api-config.json

{
  "name": "competitor-bsr-tracking",
  "displayName": "竞品BSR排名追踪",
  "description": "追踪竞品BSR/销量/价格变化趋势，生成增长路径分析和风险预警汇总",
  "category": "competitor-analysis",
  "version": "1.1.0",
  "type": "orchestration",
  "parameters": {
    "competitorAsins": {
      "type": "array",
      "items": { "type": "string" },
      "required": true,
      "description": "竞品ASIN列表"
    },
    "domain": {
      "type": "integer",
      "required": false,
      "default": 1,
      "description": "Amazon站点（1=美国）"
    }
  },
  "pipeline": [
    {
      "step": 1,
      "name": "批量获取竞品监控数据",
      "forEach": "competitorAsins",
      "api": {
        "service": "SorftimeApiService.getMonitorData",
        "endpoint": "/api/MonitorQuery",
        "method": "POST",
        "forwardUrl": "https://server.fmode.cn/api/voc/forward",
        "headers": { "Authorization": "Bearer r:858b3ee92314d5447d1fc3cdc10462d7" },
        "requestBody": { "ASIN": "${asin}" },
        "queryParams": { "domain": "${domain}" }
      },
      "output": "monitorData",
      "responseExtract": "{ PriceHistory, RankHistory, RatingHistory, ReviewCountHistory, SellerCount }"
    },
    {
      "step": 2,
      "name": "批量获取竞品当前状态",
      "forEach": "competitorAsins",
      "api": {
        "service": "SorftimeApiService.getProductDetail",
        "endpoint": "/api/ProductRequest",
        "method": "POST",
        "forwardUrl": "https://server.fmode.cn/api/voc/forward",
        "headers": { "Authorization": "Bearer r:858b3ee92314d5447d1fc3cdc10462d7" },
        "requestBody": { "ASIN": "${asin}", "Trend": 1, "QueryTrendStartDt": "", "QueryTrendEndDt": "" },
        "queryParams": { "domain": "${domain}" }
      },
      "output": "competitorDetails",
      "responseExtract": "{ Title, Brand, SalesPrice, Ratings, RatingsCount, BSR, MonthlySales, Category }"
    },
    {
      "step": 3,
      "name": "BSR/销量/价格趋势分析",
      "type": "compute",
      "logic": "analyzeTrends(monitorData, competitorDetails)",
      "algorithm": {
        "bsrTrend": "近7/14/30天BSR变化方向和幅度百分比",
        "salesTrend": "日销量/月销量趋势，环比增减百分比",
        "priceChange": "价格调整记录，是否在做促销",
        "ratingChange": "评分和评论数的变化趋势",
        "alerts": "识别异常变化: BSR大幅下降=销量暴涨, 突然降价=促销战"
      },
      "output": "tracking"
    },
    {
      "step": 4,
      "name": "增长路径分析",
      "type": "compute",
      "logic": "analyzeGrowthPath(tracking, competitorDetails)",
      "algorithm": {
        "tierClassification": "头部(Top10%)/腰部(10-40%)/尾部(40%+)",
        "dailySalesGap": "距上一层级门槛还差多少日销",
        "skuAdvice": "聚焦核心SKU打爆款建议",
        "keywordAdvice": "主攻长尾词提升排名建议"
      },
      "output": "growthPath"
    },
    {
      "step": 5,
      "name": "风险预警汇总",
      "type": "compute",
      "logic": "generateRiskAlerts(tracking, competitorDetails)",
      "algorithm": {
        "bsrRisk": "BSR连续下降检测",
        "ratingRisk": "评分下滑检测",
        "priceWarRisk": "价格战风险检测",
        "inventoryRisk": "库存风险推断",
        "complianceRisk": "合规风险检测"
      },
      "output": "riskAlerts"
    }
  ],
  "response": {
    "type": "object",
    "properties": {
      "tracking": {
        "type": "array",
        "description": "竞品追踪数据列表",
        "items": {
          "type": "object",
          "properties": {
            "asin": { "type": "string" },
            "brand": { "type": "string" },
            "currentBsr": { "type": "integer" },
            "bsrTrend": { "type": "object", "properties": { "7d": { "type": "number" }, "14d": { "type": "number" }, "30d": { "type": "number" } } },
            "salesTrend": { "type": "object", "properties": { "7d": { "type": "number" }, "14d": { "type": "number" }, "30d": { "type": "number" } } },
            "priceChange": { "type": "object", "properties": { "current": { "type": "number" }, "previous": { "type": "number" }, "changePercent": { "type": "number" } } },
            "ratingChange": { "type": "object", "properties": { "current": { "type": "number" }, "previous": { "type": "number" }, "newReviews": { "type": "integer" } } },
            "alerts": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "severity": { "type": "string" }, "message": { "type": "string" } } } }
          }
        }
      },
      "summary": {
        "type": "object",
        "properties": {
          "mostActive": { "type": "string" },
          "biggestThreat": { "type": "string" },
          "opportunityWindow": { "type": "string" }
        }
      },
      "growthPath": {
        "type": "object",
        "properties": {
          "currentTier": { "type": "string" },
          "nextTierThreshold": { "type": "object", "properties": { "dailySales": { "type": "integer" }, "gap": { "type": "integer" } } },
          "skuAdvice": { "type": "string" },
          "keywordAdvice": { "type": "string" }
        }
      },
      "riskAlerts": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "level": { "type": "string", "enum": ["high", "medium", "low"] },
            "title": { "type": "string" },
            "description": { "type": "string" }
          }
        }
      }
    }
  },
  "timeout": 60000,
  "retry": {
    "maxAttempts": 2,
    "delay": 2000,
    "backoffMultiplier": 2
  }
}