openclaw-voc-skill/openclaw-skills/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 {{vocToken}}"
        },
        "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 {{vocToken}}"
        },
        "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 {{vocToken}}"
        },
        "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 {{vocToken}}"
        },
        "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
  },
  "tokenConfig": {
    "type": "bearer",
    "configFile": "~/.openclaw/voc-credentials.json",
    "tokenField": "vocToken",
    "resolutionOrder": [
      "configFile"
    ],
    "apigId": "7HwdQZk55B",
    "paymentUrlResolution": {
      "description": "动态构建充值URL：在已存在 session token 时查出用户 objectId，拼接到专属充值页面",
      "steps": [
        "1. 从 voc-credentials.json 获取当前 session token",
        "2. 调用 GET https://server.fmode.cn/parse/users/me （Header: X-Parse-Application-Id: ncloudmaster, X-Parse-Session-Token: {token}）获取用户 objectId",
        "3. 拼接充值URL: https://app.fmode.cn/dev/apig-pay/?user={objectId}&apigid=7HwdQZk55B&fun_id=HOkkX72PMF",
        "4. 将该URL展示给用户，引导扫码支付"
      ],
      "userResolveEndpoint": "https://server.fmode.cn/parse/users/me",
      "userResolveHeaders": {
        "X-Parse-Application-Id": "ncloudmaster",
        "X-Parse-Session-Token": "{vocToken}"
      },
      "paymentBaseUrl": "https://app.fmode.cn/dev/apig-pay/",
      "paymentParams": {
        "user": "{resolvedUserId}",
        "apigid": "7HwdQZk55B",
        "fun_id": "HOkkX72PMF"
      },
      "balanceCheckEndpoint": "https://server.fmode.cn/api/apig/getApig"
    },
    "onMissing": {
      "action": "showPaymentQR",
      "qrCodeUrl": "https://app.fmode.cn/dev/apig-pay/?apigid=7HwdQZk55B&fun_id=HOkkX72PMF",
      "title": "扫码开通 VOC-AI 数据服务",
      "message": "此 Skill 需要有效的 API Token。请先打开充值页面完成登录和充值；当用户提供 session token 后，请由 OpenClaw 运行 node scripts/tools/set-voc-token.js <session-token> 写入 ~/.openclaw/voc-credentials.json 的 vocToken 字段，再重试当前 Skill。",
      "tokenSetupCommandTemplate": "node scripts/tools/set-voc-token.js {sessionToken}",
      "tokenSetupInstructions": "当用户完成登录和充值后，如果用户把 session token 发给你，请直接运行 node scripts/tools/set-voc-token.js <session-token> 写入 ~/.openclaw/voc-credentials.json，然后重试当前 Skill。"
    },
    "onBalanceInsufficient": {
      "action": "resolveUserThenShowPayment",
      "title": "VOC-AI Token 余额不足，请扫码充值",
      "message": "当前 Token 余额不足，我将为你生成专属充值链接，扫码支付后即可继续使用。"
    }
  },
  "errorHandling": {
    "balanceInsufficient": {
      "conditions": [
        {
          "responseField": "code",
          "operator": "in",
          "value": [
            -2,
            -3,
            -10,
            402,
            429
          ]
        },
        {
          "responseField": "msg",
          "operator": "contains",
          "value": [
            "余额不足",
            "insufficient",
            "balance",
            "quota",
            "没有开通",
            "权限或余额"
          ]
        },
        {
          "responseField": "mess",
          "operator": "contains",
          "value": [
            "余额不足",
            "insufficient",
            "balance",
            "quota",
            "没有开通",
            "权限或余额"
          ]
        },
        {
          "responseField": "message",
          "operator": "contains",
          "value": [
            "余额不足",
            "insufficient",
            "balance",
            "没有开通",
            "权限或余额"
          ]
        }
      ],
      "matchMode": "any",
      "trigger": "tokenConfig.onBalanceInsufficient"
    },
    "unauthorized": {
      "conditions": [
        {
          "responseField": "code",
          "operator": "in",
          "value": [
            401,
            403
          ]
        },
        {
          "responseField": "msg",
          "operator": "contains",
          "value": [
            "unauthorized",
            "token",
            "invalid",
            "auth"
          ]
        }
      ],
      "matchMode": "any",
      "trigger": "tokenConfig.onMissing"
    }
  }
}