openclaw-voc-skill/workflows/report_generation.workflow.json

{
  "name": "competitive_analysis_report",
  "displayName": "竞品分析报告生成",
  "description": "端到端编排：从输入行业关键词和竞品品牌，到自动采集数据、AI 分析、生成 HTML 幻灯片报告。覆盖市场全景、竞品对标、VOC 用户洞察、社媒热度、趋势雷达、执行策略等完整报告内容。",
  "version": "1.0.0",

  "input": {
    "type": "object",
    "required": ["industryName", "categoryKeywords", "competitorBrands"],
    "properties": {
      "industryName": {
        "type": "string",
        "description": "行业名称，如 '香薰'、'宠物用品'、'家居收纳'",
        "example": "香薰"
      },
      "categoryKeywords": {
        "type": "array",
        "description": "品类搜索关键词列表（每个关键词对应一个子品类）",
        "items": { "type": "string" },
        "example": ["scented candle", "aroma diffuser", "candle warmer", "car diffuser", "reed diffuser"]
      },
      "competitorBrands": {
        "type": "array",
        "description": "竞品品牌列表，每个品牌包含名称和社媒账号",
        "items": {
          "type": "object",
          "properties": {
            "name": { "type": "string", "description": "品牌名称" },
            "positioning": { "type": "string", "description": "品牌定位标签，如 '高端标杆'、'可持续标杆'" },
            "instagramUsername": { "type": "string", "description": "Instagram 用户名" },
            "tiktokUsername": { "type": "string", "description": "TikTok 用户名" },
            "sampleAsins": { "type": "array", "items": { "type": "string" }, "description": "品牌代表性 ASIN 列表" }
          }
        },
        "example": [
          { "name": "NEST New York", "positioning": "高端标杆", "instagramUsername": "nestnewyork", "tiktokUsername": "nestnewyork", "sampleAsins": ["B07GZXX3Q9"] },
          { "name": "Paddywax", "positioning": "可持续标杆", "instagramUsername": "paddywax", "tiktokUsername": "paddywax", "sampleAsins": ["B09MRGV1QY"] },
          { "name": "SpaRoom", "positioning": "待提升", "instagramUsername": "sparoom", "tiktokUsername": "", "sampleAsins": [] }
        ]
      },
      "vocAsins": {
        "type": "array",
        "description": "用于 VOC 深度分析的 ASIN 列表（通常选品类 Top3 畅销品）",
        "items": { "type": "string" },
        "example": ["B0B24QJ217", "B0DJHP1FCS", "B0CSVRWJ1H"]
      },
      "trendKeywords": {
        "type": "array",
        "description": "趋势雷达追踪的关键词列表",
        "items": { "type": "string" },
        "example": ["candle warmer lamp aesthetic", "reed diffuser natural oil", "aroma diffuser jellyfish", "organic scented candle gift", "car diffuser essential oil USB"]
      },
      "domain": {
        "type": "integer",
        "description": "Amazon 站点: 1=US, 2=UK, 3=DE",
        "default": 1
      },
      "reviewPages": {
        "type": "integer",
        "description": "每个 VOC ASIN 抓取的评论页数（每页约10条）",
        "default": 10
      }
    }
  },

  "stages": [
    {
      "id": "stage_1",
      "name": "品类市场数据采集",
      "description": "并行搜索各品类关键词，获取 Top 产品列表和基础数据",
      "parallel": true,
      "steps": [
        {
          "id": "1.1",
          "name": "品类产品搜索",
          "skill": "product_search",
          "iterate": "input.categoryKeywords",
          "iterateAs": "keyword",
          "input": {
            "Pattern": "{{keyword}}",
            "Page": 1,
            "domain": "{{input.domain}}"
          },
          "output": "categoryProducts[{{keyword}}]",
          "description": "对每个品类关键词执行产品搜索，获取产品列表"
        },
        {
          "id": "1.2",
          "name": "品类产品详情补全",
          "skill": "product_detail_query",
          "dependsOn": ["1.1"],
          "iterate": "categoryProducts[*].topAsins[:20]",
          "iterateAs": "asin",
          "input": {
            "ASIN": "{{asin}}",
            "domain": "{{input.domain}}",
            "Trend": 1
          },
          "output": "productDetails[{{asin}}]",
          "rateLimit": { "maxConcurrent": 5, "delayMs": 200 },
          "description": "批量获取 Top20 产品详情（价格/评分/销量/品牌）"
        },
        {
          "id": "1.3",
          "name": "品类销量数据",
          "skill": "asin_sales_volume",
          "dependsOn": ["1.1"],
          "iterate": "categoryProducts[*].topAsins[:10]",
          "iterateAs": "asin",
          "input": {
            "ASIN": "{{asin}}",
            "domain": "{{input.domain}}"
          },
          "output": "salesData[{{asin}}]",
          "rateLimit": { "maxConcurrent": 3, "delayMs": 300 },
          "description": "获取 Top10 产品销量用于计算周均销售额"
        }
      ],
      "aggregation": {
        "output": "marketOverview",
        "logic": "对每个品类汇总: 周均销量、周均销售额、均价、品牌数、增长率、中国卖家占比"
      }
    },

    {
      "id": "stage_2",
      "name": "竞品品牌数据采集",
      "description": "采集竞品品牌的产品数据和社媒数据",
      "parallel": true,
      "steps": [
        {
          "id": "2.1",
          "name": "竞品产品详情",
          "skill": "product_detail_query",
          "iterate": "input.competitorBrands[*].sampleAsins",
          "iterateAs": "asin",
          "input": {
            "ASIN": "{{asin}}",
            "domain": "{{input.domain}}",
            "Trend": 1
          },
          "output": "competitorProducts[{{asin}}]",
          "description": "获取竞品代表性产品的详情"
        },
        {
          "id": "2.2",
          "name": "竞品 Instagram 画像",
          "skill": "instagram_user_info",
          "iterate": "input.competitorBrands",
          "iterateAs": "brand",
          "condition": "brand.instagramUsername != ''",
          "input": {
            "username": "{{brand.instagramUsername}}"
          },
          "output": "igProfiles[{{brand.name}}]",
          "description": "获取竞品 IG 粉丝数、帖子数等"
        },
        {
          "id": "2.3",
          "name": "竞品 TikTok 画像",
          "skill": "tiktok_user_profile",
          "iterate": "input.competitorBrands",
          "iterateAs": "brand",
          "condition": "brand.tiktokUsername != ''",
          "input": {
            "uniqueId": "{{brand.tiktokUsername}}"
          },
          "output": "tiktokProfiles[{{brand.name}}]",
          "description": "获取竞品 TikTok 粉丝数、获赞数"
        },
        {
          "id": "2.4",
          "name": "竞品 IG 帖子分析",
          "skill": "instagram_user_posts",
          "dependsOn": ["2.2"],
          "iterate": "igProfiles",
          "iterateAs": "profile",
          "input": {
            "user_id": "{{profile.user.pk}}",
            "count": 12
          },
          "output": "igPosts[{{profile.user.username}}]",
          "description": "获取竞品最近帖子分析内容策略"
        }
      ],
      "aggregation": {
        "output": "competitorBenchmark",
        "logic": "整合每个品牌的: 产品数据(价格/评分/SKU数) + IG(粉丝/帖子/互动率) + TikTok(粉丝/获赞)"
      }
    },

    {
      "id": "stage_3",
      "name": "VOC 评论采集与分析",
      "description": "抓取目标产品评论并进行 AI 情感分析",
      "steps": [
        {
          "id": "3.1",
          "name": "评论批量抓取",
          "skill": "product_reviews_query",
          "iterate": "input.vocAsins",
          "iterateAs": "asin",
          "repeatPages": "input.reviewPages",
          "input": {
            "ASIN": "{{asin}}",
            "PageIndex": "{{pageIndex}}",
            "domain": "{{input.domain}}"
          },
          "output": "rawReviews[{{asin}}]",
          "rateLimit": { "maxConcurrent": 2, "delayMs": 500 },
          "description": "逐页抓取每个 ASIN 的评论（每页约10条，默认10页≈100条/ASIN）"
        },
        {
          "id": "3.2",
          "name": "AI 情感分类与痛点提取",
          "type": "ai_analysis",
          "dependsOn": ["3.1"],
          "input": {
            "reviews": "{{rawReviews}}",
            "systemPrompt": "你是一名专业的亚马逊产品评论分析师。请对以下用户评论进行深度分析。",
            "userPrompt": "请对以下 {{reviewCount}} 条用户评论进行分析，输出 JSON 格式结果：\n\n1. **情感分类**: 每条评论标记为 positive/negative/neutral\n2. **痛点提取**: 列出 Top5 痛点及占比（如 '化学味/人工感 30.5%'），每个痛点附带代表性原文\n3. **喜爱点提取**: 列出 Top5 好评亮点及占比\n4. **使用场景**: 提取用户提到的使用场景及占比（如 '浴室 48.7%'）\n5. **关键洞察**: 3-5 条核心商业洞察\n\n评论数据:\n{{reviewsText}}"
          },
          "output": "vocAnalysis",
          "outputSchema": {
            "totalReviews": "integer",
            "positiveRate": "number",
            "negativeRate": "number",
            "painPoints": [{ "name": "string", "percentage": "number", "quote": "string" }],
            "highlights": [{ "name": "string", "percentage": "number" }],
            "usageScenes": [{ "scene": "string", "percentage": "number" }],
            "insights": ["string"]
          },
          "description": "AI 自动提取痛点/喜爱点/场景分布"
        }
      ]
    },

    {
      "id": "stage_4",
      "name": "社媒热度与趋势数据",
      "description": "采集 TikTok 品类热度和关键词趋势",
      "parallel": true,
      "steps": [
        {
          "id": "4.1",
          "name": "TikTok 品类视频搜索",
          "skill": "tiktok_video_search",
          "iterate": "input.categoryKeywords",
          "iterateAs": "keyword",
          "input": {
            "keyword": "{{keyword}}",
            "count": 20
          },
          "output": "tiktokVideos[{{keyword}}]",
          "description": "搜索每个品类在 TikTok 的视频，统计总播放量"
        },
        {
          "id": "4.2",
          "name": "关键词搜索趋势",
          "skill": "keyword_search_trend",
          "iterate": "input.trendKeywords",
          "iterateAs": "keyword",
          "input": {
            "keyword": "{{keyword}}",
            "domain": "{{input.domain}}"
          },
          "output": "keywordTrends[{{keyword}}]",
          "description": "获取飙升关键词的搜索量趋势"
        },
        {
          "id": "4.3",
          "name": "关键词搜索量查询",
          "skill": "keyword_search",
          "iterate": "input.trendKeywords",
          "iterateAs": "keyword",
          "input": {
            "keyword": "{{keyword}}",
            "domain": "{{input.domain}}"
          },
          "output": "keywordData[{{keyword}}]",
          "description": "获取关键词搜索量和竞争度"
        },
        {
          "id": "4.4",
          "name": "TikTok 达人搜索",
          "skill": "tiktok_user_search",
          "iterate": "input.categoryKeywords[:3]",
          "iterateAs": "keyword",
          "input": {
            "keyword": "{{keyword}}",
            "count": 10
          },
          "output": "tiktokInfluencers[{{keyword}}]",
          "description": "搜索品类相关达人用于红人推荐"
        }
      ],
      "aggregation": {
        "output": "socialTrends",
        "logic": "汇总: 品类TikTok总播放量排名 + 飙升关键词Top5 + 红人推荐列表"
      }
    },

    {
      "id": "stage_5",
      "name": "广告关键词分析",
      "description": "基于 VOC 痛点和品类数据生成广告关键词推荐",
      "dependsOn": ["stage_3", "stage_4"],
      "steps": [
        {
          "id": "5.1",
          "name": "竞品 ASIN 反查关键词",
          "skill": "asin_reverse_keywords",
          "iterate": "input.vocAsins",
          "iterateAs": "asin",
          "input": {
            "ASIN": "{{asin}}",
            "domain": "{{input.domain}}"
          },
          "output": "asinKeywords[{{asin}}]",
          "description": "反查竞品排名靠前的搜索关键词"
        },
        {
          "id": "5.2",
          "name": "AI 广告关键词推荐",
          "type": "ai_analysis",
          "dependsOn": ["5.1"],
          "input": {
            "vocAnalysis": "{{vocAnalysis}}",
            "asinKeywords": "{{asinKeywords}}",
            "keywordData": "{{keywordData}}",
            "systemPrompt": "你是一名亚马逊广告优化专家。",
            "userPrompt": "基于以下数据，为该品类推荐高转化广告关键词：\n\n## VOC 痛点\n{{vocAnalysis.painPoints}}\n\n## 竞品关键词\n{{asinKeywords}}\n\n## 关键词搜索量\n{{keywordData}}\n\n请输出 JSON 格式，每个关键词包含: keyword, searchVolume, competition, suggestedBid, vocMatchScore(基于痛点匹配度0-100), reason"
          },
          "output": "adKeywordRecommendations",
          "description": "AI 结合 VOC 痛点生成 VOC 匹配度排序的广告关键词"
        }
      ]
    },

    {
      "id": "stage_6",
      "name": "AI 综合分析与策略生成",
      "description": "整合所有数据生成执行策略、Listing 优化、总结",
      "dependsOn": ["stage_1", "stage_2", "stage_3", "stage_4", "stage_5"],
      "steps": [
        {
          "id": "6.1",
          "name": "AI 执行策略生成",
          "type": "ai_analysis",
          "input": {
            "marketOverview": "{{marketOverview}}",
            "competitorBenchmark": "{{competitorBenchmark}}",
            "vocAnalysis": "{{vocAnalysis}}",
            "socialTrends": "{{socialTrends}}",
            "systemPrompt": "你是一名资深跨境电商战略顾问，擅长制定市场进入策略。",
            "userPrompt": "基于以下{{input.industryName}}行业数据，生成分阶段执行策略（JSON格式）：\n\n## 市场全景\n{{marketOverview}}\n\n## 竞品对标\n{{competitorBenchmark}}\n\n## VOC 用户洞察\n{{vocAnalysis}}\n\n## 社媒趋势\n{{socialTrends}}\n\n请输出：\n1. shortTerm (1-3个月): 3条行动项\n2. midTerm (3-6个月): 3条行动项\n3. longTerm (6-12个月): 3条行动项\n4. vocDrivenPriorities: 基于VOC的产品开发优先级\n5. keyConclusions: 3大关键行动总结"
          },
          "output": "strategyPlan"
        },
        {
          "id": "6.2",
          "name": "AI Listing 优化建议",
          "type": "ai_analysis",
          "input": {
            "vocAnalysis": "{{vocAnalysis}}",
            "competitorProducts": "{{competitorProducts}}",
            "systemPrompt": "你是亚马逊 Listing 优化专家，精通 A9 算法和消费者心理学。",
            "userPrompt": "基于 VOC 分析结果，为{{input.industryName}}品类生成 Listing 优化方案（JSON格式）：\n\n## VOC 痛点与喜爱点\n{{vocAnalysis}}\n\n## 竞品 Listing 参考\n{{competitorProducts}}\n\n请输出：\n1. currentTitle: 竞品当前标题（举例）\n2. optimizedTitle: AI 优化标题\n3. titleRationale: 优化依据（引用VOC数据）\n4. bulletPoints: 5条优化后的 Bullet Points（每条标注对应的VOC数据支撑）\n5. searchTerms: 建议后台搜索词"
          },
          "output": "listingOptimization"
        },
        {
          "id": "6.3",
          "name": "品类机会矩阵评估",
          "type": "ai_analysis",
          "input": {
            "marketOverview": "{{marketOverview}}",
            "socialTrends": "{{socialTrends}}",
            "vocAnalysis": "{{vocAnalysis}}",
            "systemPrompt": "你是一名电商品类分析专家。",
            "userPrompt": "基于以下数据，为每个品类生成综合机会评估矩阵（JSON格式）：\n\n## 品类市场数据\n{{marketOverview}}\n\n## TikTok 热度\n{{socialTrends.tiktokPlayCounts}}\n\n请输出每个品类的: categoryName, marketSize(1-5星), growth(1-5星), socialHeat(1-5星), competition(低/中/高/极高), chineseSeller(%), recommendation(最优先/高优先/推荐/需谨慎/可考虑), reason"
          },
          "output": "categoryMatrix"
        }
      ]
    },

    {
      "id": "stage_7",
      "name": "报告渲染",
      "description": "将所有数据注入 HTML 模板生成最终报告",
      "dependsOn": ["stage_6"],
      "steps": [
        {
          "id": "7.1",
          "name": "组装报告数据",
          "type": "data_transform",
          "input": {
            "industryName": "{{input.industryName}}",
            "marketOverview": "{{marketOverview}}",
            "competitorBenchmark": "{{competitorBenchmark}}",
            "vocAnalysis": "{{vocAnalysis}}",
            "socialTrends": "{{socialTrends}}",
            "adKeywordRecommendations": "{{adKeywordRecommendations}}",
            "strategyPlan": "{{strategyPlan}}",
            "listingOptimization": "{{listingOptimization}}",
            "categoryMatrix": "{{categoryMatrix}}"
          },
          "output": "reportData",
          "transform": {
            "slides": [
              {
                "id": "cover",
                "title": "{{industryName}}行业竞品与B端线索分析报告",
                "subtitle": "基于Amazon电商数据 · TikTok/Instagram社媒数据 · {{vocAnalysis.totalReviews}}条用户评论VOC分析",
                "date": "{{currentDate}}"
              },
              {
                "id": "toc",
                "sections": ["核心执行摘要", "品类市场全景分析", "核心竞品深度对标", "全渠道用户VOC与需求洞察", "B端高价值线索与品类矩阵", "市场拓展与落地执行建议", "总结与展望", "AI-VOC 智能系统展示"]
              },
              {
                "id": "executive_summary",
                "metrics": "从 marketOverview 提取 Top4 核心指标卡片",
                "coreFindings": "从 vocAnalysis + marketOverview 提取5条核心发现",
                "coreValues": "从 strategyPlan 提取5条核心价值"
              },
              {
                "id": "market_overview",
                "revenueChart": "从 marketOverview 生成品类周均销售额柱状图数据",
                "growthChart": "从 marketOverview 生成品类增长率横向柱状图数据",
                "dataTable": "品类数据表: 品类/周均销量/周均销售额/均价/品牌数/增长率/中国卖家占比"
              },
              {
                "id": "competitor_benchmark",
                "brands": "从 competitorBenchmark 生成3个品牌卡片（IG粉丝/TikTok/Amazon SKU/策略）",
                "radarChart": "从 competitorBenchmark 生成竞品能力雷达图（品牌知名度/社媒粉丝/内容质量/产品线宽度/价格竞争力）"
              },
              {
                "id": "voc_insights",
                "painPoints": "从 vocAnalysis.painPoints 生成痛点进度条",
                "highlights": "从 vocAnalysis.highlights 生成好评进度条",
                "scenesChart": "从 vocAnalysis.usageScenes 生成使用场景饼图"
              },
              {
                "id": "category_matrix",
                "opportunityTable": "从 categoryMatrix 生成品类机会评估表格",
                "tiktokChart": "从 socialTrends 生成 TikTok 热度排名柱状图",
                "seasonality": "从 marketOverview 提取季节性规律"
              },
              {
                "id": "strategy",
                "shortTerm": "从 strategyPlan.shortTerm 生成1-3月行动项",
                "midTerm": "从 strategyPlan.midTerm 生成3-6月行动项",
                "longTerm": "从 strategyPlan.longTerm 生成6-12月行动项",
                "vocPriorities": "从 strategyPlan.vocDrivenPriorities 生成VOC驱动优先级标签"
              },
              {
                "id": "conclusion",
                "topCategory": "最优先品类（从 categoryMatrix 取排名第1）",
                "socialDividend": "最具社媒红利品类",
                "differentiator": "最大差异化机会（从 vocAnalysis 取最大痛点）",
                "keyActions": "从 strategyPlan.keyConclusions 取3大关键行动"
              }
            ]
          }
        },
        {
          "id": "7.2",
          "name": "渲染 HTML 报告",
          "type": "template_render",
          "input": {
            "template": "report_template.html",
            "data": "{{reportData}}"
          },
          "output": "finalReport",
          "description": "使用 Chart.js 渲染图表，注入数据到 HTML 幻灯片模板"
        }
      ]
    }
  ],

  "errorHandling": {
    "retryPolicy": {
      "maxRetries": 3,
      "backoffMs": [1000, 3000, 10000],
      "retryableErrors": ["TIMEOUT", "RATE_LIMIT", "CAPTCHA_BLOCKED"]
    },
    "fallbacks": {
      "product_search": "当 ProductQuery 被验证码拦截(code=-10)时，回退到批量 product_detail_query",
      "tiktok_*": "TikHub 接口失败时，跳过该数据点，在报告中标注 '社媒数据暂不可用'",
      "instagram_*": "IG 接口失败时，跳过该品牌的社媒数据"
    },
    "timeout": {
      "perStep": 30000,
      "perStage": 120000,
      "total": 600000
    }
  },

  "output": {
    "type": "object",
    "properties": {
      "report": {
        "type": "string",
        "format": "html",
        "description": "完整的 HTML 幻灯片报告文件"
      },
      "rawData": {
        "type": "object",
        "description": "所有中间数据的 JSON 快照（可用于二次分析）"
      },
      "metadata": {
        "type": "object",
        "properties": {
          "generatedAt": { "type": "string", "format": "datetime" },
          "totalApiCalls": { "type": "integer" },
          "totalReviewsAnalyzed": { "type": "integer" },
          "dataFreshness": { "type": "string" },
          "errors": { "type": "array", "description": "执行过程中的错误/警告列表" }
        }
      }
    }
  },

  "billing": {
    "description": "计费逻辑",
    "items": [
      { "type": "sorftime_api_call", "unit": "次", "description": "每次 Sorftime API 调用计1次" },
      { "type": "tikhub_api_call", "unit": "次", "description": "每次 TikHub API 调用计1次" },
      { "type": "ai_analysis_token", "unit": "千token", "description": "AI 分析消耗的 token 数" },
      { "type": "report_generation", "unit": "份", "description": "每生成1份报告计1次" }
    ],
    "estimatedCalls": {
      "sorftime": "品类数×20(产品详情) + vocAsins×reviewPages(评论) + trendKeywords(关键词) ≈ 130-200次",
      "tikhub": "品类数(视频搜索) + 品牌数×2(IG+TikTok) + 品类数(达人搜索) ≈ 20-30次",
      "ai": "3次大型分析(VOC/策略/Listing) + 2次中型(关键词/矩阵) ≈ 50K-100K tokens"
    }
  }
}