openclaw-voc-skill/synthesis/product-deep-analysis/api-config.json

{
  "name": "product-deep-analysis",
  "displayName": "单品深度诊断",
  "description": "针对单个ASIN进行多维度深度分析：流量架构透视、定价策略、Listing优化、VOC痛点、广告策略、市场机会，并由AI生成核心诊断和运营建议",
  "version": "1.3.0",
  "category": "synthesis",
  "parameters": {
    "asin": {
      "type": "string",
      "required": true,
      "description": "目标ASIN"
    },
    "domain": {
      "type": "integer",
      "default": 1,
      "description": "Amazon站点: 1=US, 2=UK, 3=DE, 4=FR, 5=JP, 6=CA, 7=IT, 8=ES"
    },
    "includeReviews": {
      "type": "boolean",
      "default": true,
      "description": "是否采集评论用于VOC分析"
    },
    "reviewPages": {
      "type": "integer",
      "default": 3,
      "description": "评论采集页数(每页10条)"
    },
    "competitorAsins": {
      "type": "array",
      "items": { "type": "string" },
      "default": [],
      "description": "可选的竞品ASIN列表，用于对比分析"
    }
  },
  "pipeline": [
    {
      "step": 1,
      "name": "获取产品详情",
      "api": {
        "endpoint": "/api/ProductRequest",
        "method": "POST",
        "forwardUrl": "https://server.fmode.cn/api/voc-ecom/forward",
        "headers": { "Authorization": "Bearer r:858b3ee92314d5447d1fc3cdc10462d7" },
        "requestBody": { "ASIN": "${asin}", "Trend": 1, "QueryTrendStartDt": "", "QueryTrendEndDt": "" },
        "queryParams": { "domain": "${domain}" }
      },
      "output": "productDetail",
      "responseExtract": {
        "title": "Title",
        "brand": "Brand",
        "salesPrice": "SalesPrice (cents, /100→USD)",
        "ratings": "Ratings",
        "starDistribution": "{ fiveStartRatings, fourStartRatings, threeStartRatings, twoStartRatings, oneStartRatings } (百分比值)",
        "monthlySales": "ListingSalesVolumeOfMonthTrend (数组, 末值=最新月销)",
        "bsr": "BsrRank",
        "category": "Category (数组)",
        "feature": "Feature",
        "photo": "Photo (数组)",
        "variationASIN": "VariationASIN (数组)",
        "priceTrend": "PriceTrend (数组[date,cents,...])",
        "rankTrend": "RankTrend (数组[date,rank,...])",
        "salesTrend": "ListingSalesVolumeOfMonthTrend (数组[date,vol,...])"
      }
    },
    {
      "step": 2,
      "name": "ASIN反查关键词",
      "api": {
        "endpoint": "/api/ASINRequestKeyword",
        "method": "POST",
        "forwardUrl": "https://server.fmode.cn/api/voc-ecom/forward",
        "headers": { "Authorization": "Bearer r:858b3ee92314d5447d1fc3cdc10462d7" },
        "requestBody": { "ASIN": "${asin}" },
        "queryParams": { "domain": "${domain}" }
      },
      "output": "asinKeywords",
      "responseExtract": "Array<{ Keyword, KeywordCNName, SearchVolume, SearchRank, SPR, TitleDensity, ProductCount, ShareClickRate, ShareConversionRate, CPC, GrowthRate, Season, Top3Brand, Top3Asin, WordCount }>"
    },
    {
      "step": 3,
      "name": "获取监控数据(价格/排名趋势)",
      "api": {
        "endpoint": "/api/MonitorQuery",
        "method": "POST",
        "forwardUrl": "https://server.fmode.cn/api/voc-ecom/forward",
        "headers": { "Authorization": "Bearer r:858b3ee92314d5447d1fc3cdc10462d7" },
        "requestBody": { "ASIN": "${asin}" },
        "queryParams": { "domain": "${domain}" }
      },
      "output": "monitorData",
      "responseExtract": "{ PriceHistory, RankHistory, RatingHistory, ReviewCountHistory, SellerCount }"
    },
    {
      "step": 4,
      "name": "采集评论(可选)",
      "condition": "includeReviews == true",
      "loop": { "from": 1, "to": "${reviewPages}", "var": "pageIndex", "delay": 400 },
      "api": {
        "endpoint": "/api/ProductReviewsQuery",
        "method": "POST",
        "forwardUrl": "https://server.fmode.cn/api/voc-ecom/forward",
        "headers": { "Authorization": "Bearer r:858b3ee92314d5447d1fc3cdc10462d7" },
        "requestBody": { "ASIN": "${asin}", "PageIndex": "${pageIndex}" },
        "queryParams": { "domain": "${domain}" }
      },
      "output": "reviews",
      "responseExtract": "Array<{ Star, Title, Content, ReviewsDate, ReviewedCountry, IsVP, Helpful, ConsumerName, Asin, AsinProperty }>"
    },
    {
      "step": 5,
      "name": "流量架构分析(关键词维度)",
      "type": "compute",
      "logic": "analyzeKeywordTraffic(asinKeywords, productDetail)",
      "algorithm": {
        "competitionLevel": {
          "high": "ProductCount > 50000 或 CPC > $2.00",
          "medium": "ProductCount > 10000 或 CPC > $1.00",
          "low": "其余"
        },
        "valueScore": {
          "formula": "min(100, searchVolumeScore + growthScore + conversionScore + competitionReverse)",
          "searchVolume_30pts": ">100K→30, >10K→20, >1K→10, else→5",
          "growth_25pts": ">50%→25, >20%→20, >0%→10, ≤0%→0",
          "conversion_25pts": "ShareConversionRate >5%→25, >2%→15, >0%→5, else→0",
          "competitionReverse_20pts": "low→20, medium→10, high→0"
        },
        "trafficShare": "按SearchVolume计算各关键词的流量占比百分比",
        "diagnosis": {
          "perKeyword": "根据自然排名(SearchRank)、广告占比(CPC/竞争度)、转化效率(ShareConversionRate/ShareClickRate)生成诊断文本",
          "naturalVsAd": "自然排名<=#10→主要自然流量; 仅广告位→依赖广告; 混合→广告+自然",
          "conversionEfficiency": "ShareConversionRate/ShareClickRate >1.5→转化效率极高; <0.5→转化偏低需优化Listing"
        },
        "keywordClassification": {
          "core": "matchScore>=70 且 valueScore>=60",
          "secondary": "matchScore>=50 或 valueScore>=50",
          "longtail": "其余"
        }
      },
      "output": "keywordAnalysis"
    },
    {
      "step": 6,
      "name": "定价策略分析",
      "type": "compute",
      "logic": "analyzePricing(productDetail, competitorAsins)",
      "algorithm": {
        "priceBands": {
          "method": "按五分位划分价格带: 低价带(<P20)/中低价带(P20-P40)/黄金中价带(P40-P60)/中高价带(P60-P80)/高价带(>P80)",
          "perBand": "每个价格带计算: skuCount, pct(SKU占比), avgSales, avgRating, avgBsr",
          "goldenBandScoring": "bandScore = avgSales*0.5 + avgRating*20 + (skuCount>0?10:0), 最高分为黄金带",
          "isGolden": "标记量利平衡最优带"
        },
        "optimalPrice": {
          "formula": "goldenBandMin + (goldenBandMax-goldenBandMin)*0.6 * min(1.15, max(0.85, selfRating/bandAvgRating))",
          "range": "最优价格 ±5%"
        },
        "marginEstimate": {
          "commission": "15% Amazon佣金",
          "fba": "$5 FBA费用",
          "cogs": "30% 采购成本估算",
          "formula": "grossMargin = (price*(1-0.15) - 5 - price*0.30) / price * 100",
          "breakEvenSales": "avgSales * (currentMargin/suggestedMargin) * 0.85"
        },
        "positionStrategy": {
          "below": "评分高于带均值→提价获溢价; 否则→逐步调至带内",
          "within": "维持价格，优化Listing提升转化率",
          "above": "评分>=4.5→维持高价品牌定位; 否则→降至最优价附近"
        },
        "promotionAdvice": {
          "priceWarRisk": "价格带高度集中(spread<avgPrice*0.3)时不建议降价，优先「多件折扣」「满减策略」",
          "bundleDiscount": "2件9折/3件8折套装折扣，提升连带率"
        }
      },
      "output": "pricingAnalysis"
    },
    {
      "step": 7,
      "name": "Listing优化评估",
      "type": "compute",
      "logic": "evaluateListing(productDetail, keywordAnalysis)",
      "algorithm": {
        "dimensions": {
          "title": {
            "scoring": "基础40 + 评分>=4.0(+10) + 月销>100(+10) + 有核心词(+5), 上限75",
            "tips": "核心词放前65字符(移动端截断); 多词关键词核心词靠前; 高搜索量>50K作核心词, <5K作长尾"
          },
          "bullet": {
            "tips": "第1-2条融入核心词; 围绕搜索意图突出卖点; 竞品品牌占据的词需差异化; 旺季前强调季节卖点"
          },
          "searchTerm": {
            "tips": "填入变体和同义词; 避免重复标题已有词; 短词补长尾变体, 长尾补拆分短词"
          },
          "image": {
            "tips": "主图白底高清>=2000px; 场景图展示核心卖点; 信息图标注差异化特征; >=7张图+1视频"
          },
          "aPlus": {
            "tips": "品牌故事强化认知; 对比表格突出vs竞品优势; 场景图呼应关键词意图; 好评截图增强信任"
          }
        }
      },
      "output": "listingAnalysis"
    },
    {
      "step": 8,
      "name": "VOC痛点提取",
      "condition": "includeReviews == true && reviews.length > 0",
      "type": "compute",
      "logic": "extractPainPoints(reviews)",
      "algorithm": {
        "filter": "star<=2的差评",
        "tokenize": "split+toLowerCase, 过滤停用词(200+常见英文词/购物泛词/情感泛词), 最小词长>=5",
        "bigram": "提取相邻双词组合(如'broke easily','fell apart','poor quality')",
        "frequency": "按评论去重计频(每条评论每个词/短语最多计1次), 过滤出现>=2次的",
        "ranking": "bigram优先, 同类按频率降序, 取top8",
        "severity": "severity = min(100, freq/totalNeg*100*0.4 + rankBonus*0.3 + 30*0.3)",
        "impact": "severity>=70→high, >=40→medium, <40→low"
      },
      "output": "vocPainPoints"
    },
    {
      "step": 9,
      "name": "广告策略推荐",
      "type": "compute",
      "logic": "recommendAdStrategy(keywordAnalysis, productDetail)",
      "algorithm": {
        "bidSuggestion": {
          "formula": "suggestedBid = CPC * bidMultiplier",
          "multiplier": "valueScore>=70→1.2, >=40→1.0, <40→0.8"
        },
        "expectedAcos": "suggestedBid / (avgPrice * conversionRate) * 100",
        "matchType": {
          "high_competition": "精准匹配 - 先自动广告测试转化",
          "medium_competition": "短语+精准组合",
          "low_competition": "广泛匹配 - 抢流量积销量"
        },
        "dailyBudget": "valueScore>=70→$50, >=40→$30, <40→$15",
        "extraRules": {
          "growthOver30pct": "提前布局广告占位",
          "convClickRatioOver1_5": "转化效率极高，加大投放",
          "convClickRatioUnder0_5": "先优化Listing转化率再重点投放"
        }
      },
      "output": "adStrategy"
    },
    {
      "step": 10,
      "name": "综合健康评分",
      "type": "compute",
      "logic": "calcOverallScore(keywordAnalysis, pricingAnalysis, productDetail, reviews)",
      "algorithm": {
        "baseScore": 50,
        "keywordBonus_20": "核心词数*5, 上限20",
        "pricingBonus_20": "在最优带内→+20, 偏低→+10, 偏高→+5",
        "ratingBonus_15": ">=4.5→+15, >=4.0→+10, >=3.5→+5",
        "reviewBonus_10": ">100条→+10, >30条→+5",
        "cap": 100,
        "verdict": {
          "strong": ">=80分: 产品综合竞争力强",
          "potential": ">=60分: 产品有提升空间",
          "needFix": "<60分: 产品需要重点优化"
        }
      },
      "output": "overallScore"
    },
    {
      "step": 11,
      "name": "AI生成核心诊断与运营建议",
      "type": "ai",
      "logic": "generateDiagnosis(overallScore, keywordAnalysis, pricingAnalysis, listingAnalysis, vocPainPoints, adStrategy, productDetail, monitorData)",
      "aiConfig": {
        "systemPrompt": "你是一名资深的亚马逊跨境电商运营专家，精通选品、Listing优化、关键词策略、定价策略和广告投放。请基于提供的算法分析结果和数据，给出深度专业的中文建议，使用Markdown格式输出。你的建议应该：具体可执行、有数据支撑、考虑ROI、分优先级排序。",
        "userPromptTemplate": "# 智能推荐分析请求\n综合健康分：${overallScore}/100\n目标ASIN：${asin}\n品类：${category}\n当前价格：$${currentPrice}\n当前评分：${currentRating}\n当前月销：${currentMonthlySales}\n\n## 关键词分析结果\n${keywordSummary}\n\n## 定价分析结果\n${pricingSummary}\n\n## VOC痛点分析\n${vocSummary}\n\n## 请基于以上算法分析结果，输出以下内容：\n1. **核心诊断** — 当前产品的核心优势和瓶颈(季节性/功能性/流量结构)\n2. **流量架构透视** — 关键词表格(关键词/流量占比/月搜索量/竞争分析诊断)\n3. **运营建议(Action Plan)** — 广告策略PPC/Listing优化SEO&CRO/备货节奏\n4. **30天行动计划** — 按周排列的可执行任务清单",
        "outputFormat": "Markdown格式，包含核心诊断/流量架构透视表格/运营建议(PPC+Listing+备货)/行动计划",
        "temperature": 0.5,
        "maxTokens": 8000,
        "promptPattern": "system约束专家角色+Markdown输出 + user注入算法结果摘要 + 指定输出章节结构"
      },
      "output": "aiDiagnosis"
    }
  ],
  "response": {
    "type": "object",
    "properties": {
      "productSummary": {
        "type": "object",
        "description": "产品基本信息摘要",
        "properties": {
          "asin": { "type": "string" },
          "title": { "type": "string" },
          "brand": { "type": "string" },
          "price": { "type": "number", "description": "美元" },
          "rating": { "type": "number" },
          "monthlySales": { "type": "integer" },
          "bsr": { "type": "integer" },
          "category": { "type": "string" }
        }
      },
      "overallScore": {
        "type": "object",
        "description": "综合健康评分",
        "properties": {
          "score": { "type": "integer", "description": "0-100" },
          "verdict": { "type": "string" },
          "breakdown": {
            "type": "object",
            "properties": {
              "keyword": { "type": "integer" },
              "pricing": { "type": "integer" },
              "rating": { "type": "integer" },
              "review": { "type": "integer" }
            }
          }
        }
      },
      "keywordAnalysis": {
        "type": "object",
        "description": "流量架构透视",
        "properties": {
          "topKeywords": {
            "type": "array",
            "description": "关键词流量表",
            "items": {
              "type": "object",
              "properties": {
                "keyword": { "type": "string" },
                "keywordCN": { "type": "string" },
                "trafficShare": { "type": "number", "description": "流量占比%" },
                "searchVolume": { "type": "integer", "description": "月搜索量" },
                "searchRank": { "type": "integer", "description": "自然排名" },
                "competitionLevel": { "type": "string", "enum": ["low", "medium", "high"] },
                "valueScore": { "type": "integer", "description": "0-100" },
                "diagnosis": { "type": "string", "description": "竞争分析诊断文本" },
                "priority": { "type": "string", "enum": ["core", "secondary", "longtail"] }
              }
            }
          },
          "trafficStructure": {
            "type": "object",
            "description": "流量结构摘要",
            "properties": {
              "organicPct": { "type": "number", "description": "自然流量占比" },
              "adPct": { "type": "number", "description": "广告流量占比" },
              "topKeywordConcentration": { "type": "number", "description": "Top5关键词流量集中度" }
            }
          }
        }
      },
      "pricingAnalysis": {
        "type": "object",
        "description": "定价策略分析",
        "properties": {
          "currentPrice": { "type": "number" },
          "optimalPrice": { "type": "number" },
          "recommendedRange": { "type": "object", "properties": { "min": { "type": "number" }, "max": { "type": "number" } } },
          "currentPosition": { "type": "string", "enum": ["below", "within", "above"] },
          "bandName": { "type": "string" },
          "goldenBand": { "type": "string", "description": "量利平衡最优带名称" },
          "priceStrategy": { "type": "string" },
          "marginEstimate": {
            "type": "object",
            "properties": {
              "currentMargin": { "type": "number", "description": "当前毛利率%" },
              "suggestedMargin": { "type": "number" },
              "breakEvenSales": { "type": "integer" }
            }
          },
          "promotionAdvice": { "type": "array", "items": { "type": "string" } }
        }
      },
      "listingAnalysis": {
        "type": "array",
        "description": "Listing优化评估",
        "items": {
          "type": "object",
          "properties": {
            "dimension": { "type": "string", "enum": ["title", "bullet", "searchTerm", "image", "a+content"] },
            "currentScore": { "type": "integer" },
            "potentialScore": { "type": "integer" },
            "tips": { "type": "array", "items": { "type": "string" } },
            "keywordsToAdd": { "type": "array", "items": { "type": "string" } },
            "priority": { "type": "string", "enum": ["high", "medium", "low"] }
          }
        }
      },
      "vocPainPoints": {
        "type": "array",
        "description": "VOC痛点(差评关键词)",
        "items": {
          "type": "object",
          "properties": {
            "painPoint": { "type": "string" },
            "severity": { "type": "integer", "description": "0-100" },
            "frequency": { "type": "integer" },
            "suggestion": { "type": "string" },
            "expectedImpact": { "type": "string", "enum": ["high", "medium", "low"] }
          }
        }
      },
      "adStrategy": {
        "type": "array",
        "description": "广告策略推荐",
        "items": {
          "type": "object",
          "properties": {
            "keyword": { "type": "string" },
            "matchType": { "type": "string", "enum": ["exact", "phrase", "broad"] },
            "suggestedBid": { "type": "number" },
            "expectedAcos": { "type": "number" },
            "dailyBudget": { "type": "number" },
            "priority": { "type": "string", "enum": ["high", "medium", "low"] },
            "reason": { "type": "string" }
          }
        }
      },
      "aiDiagnosis": {
        "type": "string",
        "description": "AI生成的核心诊断与运营建议(Markdown格式)，包含: 核心诊断/流量架构透视表格/运营建议(PPC+Listing+备货)/30天行动计划"
      }
    }
  },
  "timeout": 300000,
  "retry": {
    "maxAttempts": 2,
    "delay": 3000,
    "backoffMultiplier": 2
  }
}