openclaw-voc-skill

OpenClaw VOC Skill Collection

VOC（Voice of Customer）数据查询服务的 OpenClaw Skill 定义文件集合。

目录结构

openclaw-voc-skill/
├── voc/                          # Amazon/Sorftime 电商数据接口
│   ├── product_detail_query      # 产品详情查询 (ASIN → 价格/评分/销量/BSR)
│   ├── product_search            # 关键词搜索产品 (keyword → 产品列表)
│   ├── product_reviews_query     # 产品评论查询 (ASIN → 评论列表)
│   ├── keyword_search            # 关键词查询 (keyword → 搜索量/竞争度)
│   ├── keyword_search_trend      # 关键词搜索趋势
│   ├── keyword_product_ranking   # 关键词产品排名
│   ├── asin_reverse_keywords     # ASIN 反查关键词
│   ├── asin_sales_volume         # ASIN 销量查询
│   ├── category_tree             # 类目树查询
│   ├── category_products         # 类目产品查询
│   ├── similar_products          # 相似产品查询
│   └── product_monitor           # 产品监控数据
│
└── social-media/                 # TikTok/Instagram 社媒数据接口
    ├── tiktok_video_search       # TikTok 视频搜索
    ├── tiktok_video_detail       # TikTok 视频详情
    ├── tiktok_video_comments     # TikTok 视频评论
    ├── tiktok_user_search        # TikTok 用户搜索
    ├── tiktok_user_profile       # TikTok 用户详情
    ├── tiktok_user_posts         # TikTok 用户作品列表
    ├── tiktok_hashtag_detail     # TikTok 话题详情
    ├── tiktok_hashtag_videos     # TikTok 话题视频列表
    ├── instagram_search          # Instagram 搜索
    ├── instagram_user_info       # Instagram 用户详情
    └── instagram_user_posts      # Instagram 用户帖子列表

报告生成数据流

以「香薰行业竞品分析报告」为例，生成一份完整报告需要的数据调用链：

输入: 行业关键词 + 竞品品牌列表

Step 1: 品类市场数据
  product_search × 6品类 → Top100 产品 ASIN 列表
  product_detail_query × N → 批量产品详情（价格/销量/评分/品牌）
  asin_sales_volume × Top ASIN → 销量趋势

Step 2: VOC 评论分析
  product_reviews_query × Top3 ASIN → 抓取评论（~300条/ASIN）
  → AI NLP → 情感分类 + 痛点提取 + 场景提取

Step 3: 关键词分析
  keyword_search × 目标词 → 搜索量/竞争度
  keyword_search_trend × 目标词 → 趋势变化
  asin_reverse_keywords × 竞品ASIN → 竞品关键词

Step 4: TikTok 社媒热度
  tiktok_video_search × 品类词 → 视频播放量统计
  tiktok_hashtag_detail × 话题ID → 话题总播放量
  tiktok_user_search × 品类词 → 达人发现

Step 5: Instagram 品牌画像
  instagram_search × 品牌名 → 找到品牌账号
  instagram_user_info × 品牌username → 粉丝数/帖子数
  instagram_user_posts × 品牌pk → 内容策略分析

Step 6: AI 综合分析
  → 整合 Step 1-5 数据
  → AI 生成执行策略 + Listing优化 + 广告关键词推荐

Step 7: 渲染 HTML 报告

Skill JSON 格式说明

每个 .skill.json 文件包含以下字段：

字段	说明
name	Skill 唯一标识符
displayName	中文显示名称
description	功能描述
category	分类: voc 或 social-media
endpoint	API 端点信息 (method, url, headers)
parameters	输入参数 JSON Schema
requestTransform	参数到实际请求的转换模板
response	响应数据结构
usageExamples	调用示例
reportMapping	该接口数据对应报告的哪些页面和数据点

报告生成编排 Workflow

完整的报告生成编排定义在 workflows/ 目录下：

workflows/
├── report_generation.workflow.json   # 7阶段编排定义（核心文件）
├── pipeline.md                       # 执行流程图 + 并行度 + API调用量估算
└── examples/
    └── fragrance_report_input.json   # 香薰行业完整输入示例

7 阶段编排

阶段	名称	并行	依赖	预计耗时
Stage 1	品类市场数据采集	✅	—	30-60s
Stage 2	竞品品牌数据采集	✅	—	15-30s
Stage 3	VOC 评论采集与 AI 分析	—	—	40-80s
Stage 4	社媒热度与趋势数据	✅	—	15-20s
Stage 5	广告关键词分析	—	Stage 3+4	15-25s
Stage 6	AI 综合分析与策略生成	—	Stage 1-5	30-60s
Stage 7	报告渲染	—	Stage 6	5-10s

Stage 1/2/4 可完全并行执行，总耗时约 3-5 分钟。

详细流程图和数据依赖关系见 workflows/pipeline.md。

API 认证

Sorftime (VOC)

• 通过 https://server-msq.fmode.cn/api/sorftime/forward 统一转发
• 认证已在后端内置，前端无需传入 Token
• domain 参数必须是数字: 1=amazon.com, 2=amazon.co.uk ...

TikHub (社媒)

• 直连代理: https://server.fmode.cn/thapi
• 需携带 Bearer Token 在 Authorization header 中
• 所有请求均为 GET 方法