18307996893/openclaw-voc-skill

# 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 视频搜索
│   ├── 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 用户帖子列表
│
├── competitor-analysis/              # 竞品分析（编排层）
│   ├── competitor-discovery/         # 竞品发现与筛选 + 竞争格局(CR5/垄断/攻防策略)
│   ├── competitor-product-comparison/# 竞品多维对比 + 5维健康度仪表盘
│   ├── competitor-pricing-analysis/  # 5分位价格带 + 黄金带 + 毛利估算 + 促销建议
│   └── competitor-bsr-tracking/      # BSR追踪 + 增长路径分析 + 风险预警
│
├── review-analysis/                  # 评论分析（编排层）
│   ├── review-batch-collection/      # 批量采集 + 竞品VOC对比汇总
│   ├── review-sentiment-analysis/    # 情感分析 + 情感短语规则 + 情感词云
│   ├── review-pain-point-extraction/ # 痛点提取 + VOC驱动优化建议
│   ├── review-highlight-extraction/  # 亮点提取 + Listing卖点植入建议
│   └── review-keyword-cloud/         # 关键词云 + 情感标签(正/负/中性)
│
├── social-voc/                       # 社媒VOC分析（编排层）
│   ├── tiktok-category-voc/          # TikTok品类VOC采集与分析
│   ├── tiktok-brand-voc/             # TikTok品牌VOC采集与分析
│   ├── instagram-brand-voc/          # Instagram品牌VOC采集与分析
│   └── social-trend-analysis/        # 社媒趋势分析 + 优先级行动清单
│
├── synthesis/                        # 综合分析（编排层）
│   ├── product-deep-analysis/        # 6维诊断 + 5分位价格带 + 毛利估算 + AI建议
│   ├── category-landscape/           # CR5/HHI + 风险预警 + 优先行动清单
│   ├── brand-profile/                # 六维画像 + 机会/风险标签 + 定位建议
│   ├── user-persona/                 # 用户画像 + 购买行为分析 + 季节/渠道偏好
│   └── voc-proposal/                 # 6章节提案 + ROI估算 + 30天行动时间线
│
└── 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.fmode.cn/api/voc-ecom/forward
需携带 Authorization header: Bearer r:858b3ee92314d5447d1fc3cdc10462d7
domain 参数必须是数字: 1=amazon.com, 2=amazon.co.uk ...

TikHub (VOC 社媒)

统一代理: https://server.fmode.cn/api/voc-social/
路径拼接: 去掉原 /v1/ 前缀，如 thapi/v1/tiktok/web/... → api/voc-social/tiktok/web/...
需携带 Authorization header: Bearer r:a5a19ea9868043b15d9b10423234ca43
所有请求均为 GET 方法

版本管理

当前版本: v1.3.0 (2026-03-26)

Changelog

v1.3.0 (2026-03-26)

模块重命名: VOC 电商接口 api/voc/forward → api/voc-ecom/forward；社媒接口 api/social/ → api/voc-social/
受影响文件: 全部 41 个 api-config.json

v1.2.0 (2026-03-26)

社媒端点迁移: TikHub 代理从 thapi/v1/ 迁移至 api/social/，Auth token 切换为统一代理 token
受影响文件: social-media/(11) + social-voc/(4) = 15 个 api-config.json

v1.1.0 (2026-03-26)

API 端点迁移: 所有 VOC 接口从 server-msq.fmode.cn/api/sorftime/forward 迁移至 server.fmode.cn/api/voc/forward
认证升级: 所有使用 VOC 转发地址的 api-config.json 添加 Authorization: Bearer header
规范修复: 修复 13 个 SKILL.md 文件的 UTF-8 BOM 编码问题
命名统一: api-config.json 的 name 字段统一为小写连字符格式（与目录名一致）
受影响文件: voc/(12) + competitor-analysis/(4) + review-analysis/(2) + synthesis/(3) = 21 个 api-config.json

v1.0.0 (初始版本)

41 个技能初始定义
涵盖 VOC/社媒/竞品分析/评论分析/综合分析五大类

README.md 9.8 KB Пермалинк Историја Датотека