OpenClaw VOC Skill Collection

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

目录结构

每个技能遵循 OpenClaw 规范：独立目录 + SKILL.md（核心描述文件）+ api-config.json（接口配置）。

openclaw-voc-skill/
├── voc/                              # Amazon/Sorftime 电商数据接口
│   ├── product-detail-query/         # 产品详情查询 (ASIN → 价格/评分/销量/BSR)
│   │   ├── SKILL.md
│   │   └── api-config.json
│   ├── product-search/               # 关键词搜索产品 (keyword → 产品列表)
│   │   ├── SKILL.md
│   │   └── api-config.json
│   ├── product-reviews-query/        # 产品评论查询 (ASIN → 评论列表)
│   │   ├── SKILL.md
│   │   └── api-config.json
│   ├── keyword-search/               # 关键词查询 (keyword → 搜索量/竞争度)
│   │   ├── SKILL.md
│   │   └── api-config.json
│   ├── keyword-search-trend/         # 关键词搜索趋势
│   │   ├── SKILL.md
│   │   └── api-config.json
│   ├── keyword-product-ranking/      # 关键词产品排名
│   │   ├── SKILL.md
│   │   └── api-config.json
│   ├── asin-reverse-keywords/        # ASIN 反查关键词
│   │   ├── SKILL.md
│   │   └── api-config.json
│   ├── asin-sales-volume/            # ASIN 销量查询
│   │   ├── SKILL.md
│   │   └── api-config.json
│   ├── category-tree/                # 类目树查询
│   │   ├── SKILL.md
│   │   └── api-config.json
│   ├── category-products/            # 类目产品查询
│   │   ├── SKILL.md
│   │   └── api-config.json
│   ├── similar-products/             # 相似产品查询
│   │   ├── SKILL.md
│   │   └── api-config.json
│   └── product-monitor/              # 产品监控数据
│       ├── SKILL.md
│       └── api-config.json
│
├── social-media/                     # TikTok/Instagram 社媒数据接口
│   ├── tiktok-video-search/          # TikTok 视频搜索
│   │   ├── SKILL.md
│   │   └── api-config.json
│   ├── tiktok-video-detail/          # TikTok 视频详情
│   │   ├── SKILL.md
│   │   └── api-config.json
│   ├── tiktok-video-comments/        # TikTok 视频评论
│   │   ├── SKILL.md
│   │   └── api-config.json
│   ├── tiktok-user-search/           # TikTok 用户搜索
│   │   ├── SKILL.md
│   │   └── api-config.json
│   ├── tiktok-user-profile/          # TikTok 用户详情
│   │   ├── SKILL.md
│   │   └── api-config.json
│   ├── tiktok-user-posts/            # TikTok 用户作品列表
│   │   ├── SKILL.md
│   │   └── api-config.json
│   ├── tiktok-hashtag-detail/        # TikTok 话题详情
│   │   ├── SKILL.md
│   │   └── api-config.json
│   ├── tiktok-hashtag-videos/        # TikTok 话题视频列表
│   │   ├── SKILL.md
│   │   └── api-config.json
│   ├── instagram-search/             # Instagram 搜索
│   │   ├── SKILL.md
│   │   └── api-config.json
│   ├── instagram-user-info/          # Instagram 用户详情
│   │   ├── SKILL.md
│   │   └── api-config.json
│   └── instagram-user-posts/         # Instagram 用户帖子列表
│       ├── SKILL.md
│       └── api-config.json
│
└── workflows/                        # 报告生成编排
    ├── report_generation.workflow.json
    ├── pipeline.md
    └── examples/

报告生成数据流

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

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

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 报告

OpenClaw 技能规范

每个技能是一个独立目录，包含：

文件	说明
`SKILL.md`	【必需】技能核心描述文件（UTF-8 无 BOM 编码），包含：技能名称、功能用途、入参规则、接口调用方式、返回格式、依赖要求
`api-config.json`	【必需】接口配置文件（严格 JSON 格式），包含：name, displayName, description, category, endpoint, parameters, requestTransform, response, usageExamples, reportMapping

命名规范

目录名：小写字母 + 连字符（如 product-detail-query），不可用中文、空格、下划线、特殊字符
SKILL.md 文件名必须全大写，后缀 .md 小写

报告生成编排 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 方法

README.md 7.2 KB لینک دائمی تاريخچه خام