# 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`](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/社媒/竞品分析/评论分析/综合分析 五大类