规范skill格式

README.md

@@ -4,34 +4,87 @@ VOC（Voice of Customer）数据查询服务的 OpenClaw Skill 定义文件集
 
 ## 目录结构
 
+每个技能遵循 OpenClaw 规范：独立目录 + `SKILL.md`（核心描述文件）+ `api-config.json`（接口配置）。
+
 ```
 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           # 产品监控数据
+├── 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
 │
-└── 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 用户帖子列表
+└── workflows/                        # 报告生成编排
+    ├── report_generation.workflow.json
+    ├── pipeline.md
+    └── examples/
 ```
 
 ## 报告生成数据流
@@ -72,22 +125,19 @@ Step 6: AI 综合分析
 Step 7: 渲染 HTML 报告
 ```
 
-## Skill JSON 格式说明
+## OpenClaw 技能规范
 
-每个 `.skill.json` 文件包含以下字段：
+每个技能是一个独立目录，包含：
 
-| 字段 | 说明 |
+| 文件 | 说明 |
 |------|------|
-| `name` | Skill 唯一标识符 |
-| `displayName` | 中文显示名称 |
-| `description` | 功能描述 |
-| `category` | 分类: `voc` 或 `social-media` |
-| `endpoint` | API 端点信息 (method, url, headers) |
-| `parameters` | 输入参数 JSON Schema |
-| `requestTransform` | 参数到实际请求的转换模板 |
-| `response` | 响应数据结构 |
-| `usageExamples` | 调用示例 |
-| `reportMapping` | 该接口数据对应报告的哪些页面和数据点 |
+| `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
 

social-media/instagram-search/SKILL.md

@@ -0,0 +1,55 @@
+# instagram-search
+
+## 功能用途
+
+按关键词搜索 Instagram 用户/品牌账号，返回匹配的用户列表。用于竞品品牌 Instagram 账号发现、红人搜索。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| query | string | ✅ | 搜索关键词，如品牌名 'NEST New York'、'Paddywax'、'SpaRoom' |
+| select | string | ❌ | 搜索类型: 'users'=搜索用户, 'hashtags'=搜索标签（默认 'users'） |
+
+## 接口调用方式
+
+- **请求方法**: GET
+- **接口地址**: `https://server.fmode.cn/thapi/v1/instagram/v1/fetch_search`
+- **请求头**:
+  - `Authorization: Bearer tKIbAsEM8X+GmE2vHqGW7D/ICwK1Q5V4viKFrWiPB6HholGdLFqZJmmyNw==`
+  - `Accept: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+参数直接作为 GET 查询参数传递：
+```
+GET /thapi/v1/instagram/v1/fetch_search?query=NEST+New+York&select=users
+```
+
+> 注意: 搜索结果中的 user.pk 可用于 instagram-user-posts 接口获取帖子列表。username 可用于 instagram-user-info 获取详细资料。
+
+## 返回格式
+
+返回 JSON 对象，主要字段：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| users | array | 匹配的用户列表 |
+
+users 数组中每个用户包含：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| user.pk | string | 用户数字 ID（用于获取帖子） |
+| user.username | string | 用户名 |
+| user.full_name | string | 显示名称 |
+| user.is_verified | boolean | 是否认证 |
+| user.profile_pic_url | string | 头像 URL |
+| user.follower_count | integer | 粉丝数 |
+| user.is_private | boolean | 是否私密账号 |
+
+## 依赖要求
+
+- 直连代理: `https://server.fmode.cn/thapi`
+- 需携带 Bearer Token 在 Authorization header 中
+- 所有请求均为 GET 方法
+- 关联技能: `instagram-user-info`（使用 username 获取详情）、`instagram-user-posts`（使用 pk 获取帖子）

social-media/instagram-user-info/SKILL.md

@@ -0,0 +1,53 @@
+# instagram-user-info
+
+## 功能用途
+
+根据用户名获取 Instagram 用户的完整资料，包括粉丝数、关注数、帖子数、个人简介、是否认证等。用于竞品品牌社媒画像分析、红人详情获取。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| username | string | ✅ | Instagram 用户名（不含@），如 'nestnewyork'、'paddywax' |
+
+## 接口调用方式
+
+- **请求方法**: GET
+- **接口地址**: `https://server.fmode.cn/thapi/v1/instagram/v1/fetch_user_info_by_username_v3`
+- **请求头**:
+  - `Authorization: Bearer tKIbAsEM8X+GmE2vHqGW7D/ICwK1Q5V4viKFrWiPB6HholGdLFqZJmmyNw==`
+  - `Accept: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+参数直接作为 GET 查询参数传递：
+```
+GET /thapi/v1/instagram/v1/fetch_user_info_by_username_v3?username=nestnewyork
+```
+
+> 注意: 返回的 pk（用户数字 ID）可用于 instagram-user-posts 接口获取帖子列表。
+
+## 返回格式
+
+返回 JSON 对象，主要字段：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| user.pk | string | 用户数字 ID |
+| user.username | string | 用户名 |
+| user.full_name | string | 显示名称 |
+| user.biography | string | 个人简介 |
+| user.follower_count | integer | 粉丝数 |
+| user.following_count | integer | 关注数 |
+| user.media_count | integer | 帖子总数 |
+| user.is_verified | boolean | 是否蓝V认证 |
+| user.is_business | boolean | 是否商业账号 |
+| user.category | string | 账号类别 |
+| user.external_url | string | 外部链接（如品牌官网） |
+| user.profile_pic_url_hd | string | 高清头像 URL |
+
+## 依赖要求
+
+- 直连代理: `https://server.fmode.cn/thapi`
+- 需携带 Bearer Token 在 Authorization header 中
+- 所有请求均为 GET 方法
+- 关联技能: `instagram-user-posts`（使用本接口返回的 pk 获取帖子列表）

social-media/instagram-user-posts/SKILL.md

@@ -0,0 +1,61 @@
+# instagram-user-posts
+
+## 功能用途
+
+获取指定 Instagram 用户发布的帖子列表，包括图片、点赞数、评论数等。用于竞品内容策略分析、发帖频率和互动率评估。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| user_id | string | ✅ | Instagram 用户数字 ID（pk），需先通过 instagram-user-info 或 instagram-search 接口获取 |
+| count | integer | ❌ | 每页帖子数量，最大 50（默认 12） |
+| end_cursor | string | ❌ | 分页游标，首次不传，后续传上次返回的 end_cursor |
+
+## 接口调用方式
+
+- **请求方法**: GET
+- **接口地址**: `https://server.fmode.cn/thapi/v1/instagram/v1/fetch_user_posts_v2`
+- **请求头**:
+  - `Authorization: Bearer tKIbAsEM8X+GmE2vHqGW7D/ICwK1Q5V4viKFrWiPB6HholGdLFqZJmmyNw==`
+  - `Accept: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+参数直接作为 GET 查询参数传递：
+```
+GET /thapi/v1/instagram/v1/fetch_user_posts_v2?user_id=12345678&count=12
+```
+
+> 注意: user_id 需先通过 instagram-user-info 接口获取 pk 字段。帖子的互动率可通过 (like_count + comment_count) / follower_count 计算。
+
+## 返回格式
+
+返回 JSON 对象，主要字段：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| items | array | 帖子数组 |
+| has_more | boolean | 是否有更多帖子 |
+| end_cursor | string | 下一页游标 |
+
+items 数组中每条帖子包含：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | string | 帖子 ID |
+| code | string | 帖子短码（URL 用） |
+| caption.text | string | 帖子文案 |
+| like_count | integer | 点赞数 |
+| comment_count | integer | 评论数 |
+| taken_at | integer | 发布时间戳 |
+| media_type | integer | 媒体类型: 1=图片, 2=视频, 8=轮播 |
+| image_versions2 | object | 图片版本列表 |
+| video_versions | array | 视频版本列表（仅视频帖子） |
+| view_count | integer | 视频观看次数（仅视频帖子） |
+
+## 依赖要求
+
+- 直连代理: `https://server.fmode.cn/thapi`
+- 需携带 Bearer Token 在 Authorization header 中
+- 所有请求均为 GET 方法
+- 关联技能: `instagram-user-info`（先获取 pk）、`instagram-search`（也可获取 pk）

social-media/tiktok-hashtag-detail/SKILL.md

@@ -0,0 +1,43 @@
+# tiktok-hashtag-detail
+
+## 功能用途
+
+根据话题/标签 ID 获取话题详情，包括总播放量、视频数量等。用于品类社媒热度统计、话题趋势追踪。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| ch_id | string | ✅ | TikTok 话题/标签 ID（可从视频搜索结果的 cha_list 中获取） |
+
+## 接口调用方式
+
+- **请求方法**: GET
+- **接口地址**: `https://server.fmode.cn/thapi/v1/tiktok/app/v3/fetch_hashtag_detail`
+- **请求头**:
+  - `Authorization: Bearer tKIbAsEM8X+GmE2vHqGW7D/ICwK1Q5V4viKFrWiPB6HholGdLFqZJmmyNw==`
+  - `Accept: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+参数直接作为 GET 查询参数传递：
+```
+GET /thapi/v1/tiktok/app/v3/fetch_hashtag_detail?ch_id=1234567
+```
+
+## 返回格式
+
+返回 JSON 对象，主要字段：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| ch_info.cha_name | string | 话题名称 |
+| ch_info.cid | string | 话题 ID |
+| ch_info.desc | string | 话题描述 |
+| ch_info.view_count | integer | 话题总播放量 |
+| ch_info.use_count | integer | 使用该话题的视频数 |
+
+## 依赖要求
+
+- 直连代理: `https://server.fmode.cn/thapi`
+- 需携带 Bearer Token 在 Authorization header 中
+- 所有请求均为 GET 方法

social-media/tiktok-hashtag-videos/SKILL.md

@@ -0,0 +1,57 @@
+# tiktok-hashtag-videos
+
+## 功能用途
+
+获取指定话题/标签下的视频列表，用于分析话题内容趋势、发现热门创作者。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| ch_id | string | ✅ | TikTok 话题/标签 ID |
+| count | integer | ❌ | 每页视频数量，最大 30（默认 20） |
+| cursor | integer | ❌ | 分页游标（默认 0） |
+
+## 接口调用方式
+
+- **请求方法**: GET
+- **接口地址**: `https://server.fmode.cn/thapi/v1/tiktok/app/v3/fetch_hashtag_video_list`
+- **请求头**:
+  - `Authorization: Bearer tKIbAsEM8X+GmE2vHqGW7D/ICwK1Q5V4viKFrWiPB6HholGdLFqZJmmyNw==`
+  - `Accept: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+参数直接作为 GET 查询参数传递：
+```
+GET /thapi/v1/tiktok/app/v3/fetch_hashtag_video_list?ch_id=1234567&count=20&cursor=0
+```
+
+## 返回格式
+
+返回 JSON 对象，主要字段：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| aweme_list | array | 视频列表 |
+| has_more | boolean | 是否有更多数据 |
+| cursor | integer | 下一页游标 |
+
+aweme_list 中每个视频包含：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| aweme_id | string | 视频 ID |
+| desc | string | 视频描述 |
+| statistics.play_count | integer | 播放量 |
+| statistics.digg_count | integer | 点赞数 |
+| statistics.comment_count | integer | 评论数 |
+| statistics.share_count | integer | 分享数 |
+| author.unique_id | string | 作者用户名 |
+| author.nickname | string | 作者昵称 |
+| author.follower_count | integer | 作者粉丝数 |
+
+## 依赖要求
+
+- 直连代理: `https://server.fmode.cn/thapi`
+- 需携带 Bearer Token 在 Authorization header 中
+- 所有请求均为 GET 方法

social-media/tiktok-user-posts/SKILL.md

@@ -0,0 +1,58 @@
+# tiktok-user-posts
+
+## 功能用途
+
+获取指定 TikTok 用户发布的视频列表，包括每个视频的播放量和互动数据。用于竞品内容策略分析、红人内容表现评估。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| sec_user_id | string | ✅ | 用户的安全 ID（secUid），需先通过 tiktok-user-profile 接口获取 |
+| count | integer | ❌ | 每页视频数量，最大 30（默认 20） |
+| cursor | integer | ❌ | 分页游标（默认 0） |
+
+## 接口调用方式
+
+- **请求方法**: GET
+- **接口地址**: `https://server.fmode.cn/thapi/v1/tiktok/app/v3/fetch_user_post_videos`
+- **请求头**:
+  - `Authorization: Bearer tKIbAsEM8X+GmE2vHqGW7D/ICwK1Q5V4viKFrWiPB6HholGdLFqZJmmyNw==`
+  - `Accept: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+参数直接作为 GET 查询参数传递：
+```
+GET /thapi/v1/tiktok/app/v3/fetch_user_post_videos?sec_user_id=MS4wLjABAAAA...&count=20&cursor=0
+```
+
+> 注意: sec_user_id 需先通过 tiktok-user-profile 获取。该接口可用于分析竞品品牌的内容发布频率和互动表现。
+
+## 返回格式
+
+返回 JSON 对象，主要字段：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| aweme_list | array | 视频列表 |
+| has_more | boolean | 是否有更多数据 |
+| cursor | integer | 下一页游标 |
+
+aweme_list 中每个视频包含：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| aweme_id | string | 视频 ID |
+| desc | string | 视频描述 |
+| statistics.play_count | integer | 播放量 |
+| statistics.digg_count | integer | 点赞数 |
+| statistics.comment_count | integer | 评论数 |
+| statistics.share_count | integer | 分享数 |
+| create_time | integer | 发布时间戳 |
+
+## 依赖要求
+
+- 直连代理: `https://server.fmode.cn/thapi`
+- 需携带 Bearer Token 在 Authorization header 中
+- 所有请求均为 GET 方法
+- 关联技能: `tiktok-user-profile`（先获取 secUid）

social-media/tiktok-user-profile/SKILL.md

@@ -0,0 +1,54 @@
+# tiktok-user-profile
+
+## 功能用途
+
+根据用户名获取 TikTok 用户的完整资料，包括粉丝数、获赞数、作品数、个人简介等。用于竞品品牌社媒画像、红人详情分析。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| uniqueId | string | ✅ | TikTok 用户名（不含@），如 'nestnewyork'、'dealwhisperer' |
+
+## 接口调用方式
+
+- **请求方法**: GET
+- **接口地址**: `https://server.fmode.cn/thapi/v1/tiktok/web/fetch_user_profile`
+- **请求头**:
+  - `Authorization: Bearer tKIbAsEM8X+GmE2vHqGW7D/ICwK1Q5V4viKFrWiPB6HholGdLFqZJmmyNw==`
+  - `Accept: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+参数直接作为 GET 查询参数传递：
+```
+GET /thapi/v1/tiktok/web/fetch_user_profile?uniqueId=nestnewyork
+```
+
+> 注意: 返回的 secUid 可用于 tiktok-user-posts 接口获取用户发布的视频列表。
+
+## 返回格式
+
+返回 JSON 对象，主要字段：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| user.id | string | 用户 ID |
+| user.uniqueId | string | 用户名 |
+| user.nickname | string | 昵称 |
+| user.signature | string | 个人简介 |
+| user.verified | boolean | 是否认证 |
+| user.avatarLarger | string | 头像 URL |
+| user.secUid | string | 安全用户 ID（用于获取帖子） |
+| stats.followerCount | integer | 粉丝数 |
+| stats.followingCount | integer | 关注数 |
+| stats.heart | integer | 获赞总数 |
+| stats.heartCount | integer | 获赞总数（别名） |
+| stats.videoCount | integer | 作品总数 |
+| stats.diggCount | integer | 点赞数 |
+
+## 依赖要求
+
+- 直连代理: `https://server.fmode.cn/thapi`
+- 需携带 Bearer Token 在 Authorization header 中
+- 所有请求均为 GET 方法
+- 关联技能: `tiktok-user-posts`（使用本接口返回的 secUid 获取用户视频列表）

social-media/tiktok-user-search/SKILL.md

@@ -0,0 +1,54 @@
+# tiktok-user-search
+
+## 功能用途
+
+按关键词搜索 TikTok 用户/达人，返回用户列表及粉丝数、关注数等基础信息。用于红人发现、达人库建设。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| keyword | string | ✅ | 搜索关键词，如品牌名 'NEST New York' 或品类 'candle warmer' |
+| count | integer | ❌ | 返回用户数量，最大 30（默认 10） |
+| cursor | integer | ❌ | 分页游标（默认 0） |
+
+## 接口调用方式
+
+- **请求方法**: GET
+- **接口地址**: `https://server.fmode.cn/thapi/v1/tiktok/web/fetch_search_user`
+- **请求头**:
+  - `Authorization: Bearer tKIbAsEM8X+GmE2vHqGW7D/ICwK1Q5V4viKFrWiPB6HholGdLFqZJmmyNw==`
+  - `Accept: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+参数直接作为 GET 查询参数传递：
+```
+GET /thapi/v1/tiktok/web/fetch_search_user?keyword=candle+warmer&count=15&cursor=0
+```
+
+## 返回格式
+
+返回 JSON 对象，主要字段：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| user_list | array | 用户列表（可能在 data.user_list 中） |
+
+user_list 中每个用户包含：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| user_info.unique_id | string | 用户名 |
+| user_info.nickname | string | 昵称 |
+| user_info.follower_count | integer | 粉丝数 |
+| user_info.following_count | integer | 关注数 |
+| user_info.total_favorited | integer | 获赞总数 |
+| user_info.video_count | integer | 作品数 |
+| user_info.avatar_larger | object | 头像（大图） |
+| user_info.signature | string | 个人简介 |
+
+## 依赖要求
+
+- 直连代理: `https://server.fmode.cn/thapi`
+- 需携带 Bearer Token 在 Authorization header 中
+- 所有请求均为 GET 方法

social-media/tiktok-video-comments/SKILL.md

@@ -0,0 +1,56 @@
+# tiktok-video-comments
+
+## 功能用途
+
+获取指定 TikTok 视频的用户评论列表，用于社媒用户情感分析、需求挖掘、红人互动率计算。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| aweme_id | string | ✅ | TikTok 视频唯一 ID |
+| count | integer | ❌ | 每页评论数量，最大 50（默认 20） |
+| cursor | integer | ❌ | 分页游标，首次不传或传 0（默认 0） |
+
+## 接口调用方式
+
+- **请求方法**: GET
+- **接口地址**: `https://server.fmode.cn/thapi/v1/tiktok/app/v3/fetch_video_comments`
+- **请求头**:
+  - `Authorization: Bearer tKIbAsEM8X+GmE2vHqGW7D/ICwK1Q5V4viKFrWiPB6HholGdLFqZJmmyNw==`
+  - `Accept: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+参数直接作为 GET 查询参数传递：
+```
+GET /thapi/v1/tiktok/app/v3/fetch_video_comments?aweme_id=7300000000000000000&count=20&cursor=0
+```
+
+## 返回格式
+
+返回 JSON 对象，主要字段：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| comments | array | 评论列表 |
+| has_more | boolean | 是否有更多评论 |
+| cursor | integer | 下一页游标 |
+| total | integer | 评论总数 |
+
+comments 数组中每条评论包含：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| cid | string | 评论 ID |
+| text | string | 评论内容 |
+| digg_count | integer | 评论点赞数 |
+| reply_comment_total | integer | 回复数 |
+| create_time | integer | 评论时间戳 |
+| user.nickname | string | 评论者昵称 |
+| user.unique_id | string | 评论者用户名 |
+
+## 依赖要求
+
+- 直连代理: `https://server.fmode.cn/thapi`
+- 需携带 Bearer Token 在 Authorization header 中
+- 所有请求均为 GET 方法

social-media/tiktok-video-detail/SKILL.md

@@ -0,0 +1,51 @@
+# tiktok-video-detail
+
+## 功能用途
+
+根据视频 ID 获取单条 TikTok 视频的完整信息，包括播放量、互动数据、作者信息、话题标签等。用于爆款视频深度分析。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| aweme_id | string | ✅ | TikTok 视频唯一 ID（从视频搜索结果中获取） |
+
+## 接口调用方式
+
+- **请求方法**: GET
+- **接口地址**: `https://server.fmode.cn/thapi/v1/tiktok/app/v3/fetch_one_video`
+- **请求头**:
+  - `Authorization: Bearer tKIbAsEM8X+GmE2vHqGW7D/ICwK1Q5V4viKFrWiPB6HholGdLFqZJmmyNw==`
+  - `Accept: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+参数直接作为 GET 查询参数传递：
+```
+GET /thapi/v1/tiktok/app/v3/fetch_one_video?aweme_id=7300000000000000000
+```
+
+## 返回格式
+
+返回 JSON 对象，主要字段：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| aweme_id | string | 视频 ID |
+| desc | string | 视频描述 |
+| statistics.play_count | integer | 播放量 |
+| statistics.digg_count | integer | 点赞数 |
+| statistics.comment_count | integer | 评论数 |
+| statistics.share_count | integer | 分享数 |
+| author.nickname | string | 作者昵称 |
+| author.unique_id | string | 作者用户名 |
+| author.follower_count | integer | 作者粉丝数 |
+| create_time | integer | 视频创建时间戳 |
+| cha_list | array | 关联话题列表 |
+| video.cover | object | 封面图信息 |
+| video.duration | integer | 视频时长(ms) |
+
+## 依赖要求
+
+- 直连代理: `https://server.fmode.cn/thapi`
+- 需携带 Bearer Token 在 Authorization header 中
+- 所有请求均为 GET 方法

social-media/tiktok-video-search/SKILL.md

@@ -0,0 +1,61 @@
+# tiktok-video-search
+
+## 功能用途
+
+按关键词搜索 TikTok 视频，返回视频列表及播放量、点赞、评论、分享等互动数据。用于社媒热度分析、爆款视频发现、品类 TikTok 播放量统计。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| keyword | string | ✅ | 搜索关键词，如 'reed diffuser'、'candle warmer'、'aroma diffuser' |
+| count | integer | ❌ | 返回视频数量，最大 30（默认 10） |
+| cursor | integer | ❌ | 分页游标，首次请求不传或传 0，后续传上次返回的 cursor 值（默认 0） |
+
+## 接口调用方式
+
+- **请求方法**: GET
+- **接口地址**: `https://server.fmode.cn/thapi/v1/tiktok/app/v3/fetch_video_search_result`
+- **请求头**:
+  - `Authorization: Bearer tKIbAsEM8X+GmE2vHqGW7D/ICwK1Q5V4viKFrWiPB6HholGdLFqZJmmyNw==`
+  - `Accept: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+参数直接作为 GET 查询参数传递：
+```
+GET /thapi/v1/tiktok/app/v3/fetch_video_search_result?keyword=candle+warmer&count=20&cursor=0
+```
+
+> 注意: 响应数据可能在 `aweme_list` 或 `search_item_list[].aweme_info` 中，需做兼容处理。
+
+## 返回格式
+
+返回 JSON 对象，主要字段：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| aweme_list | array | 视频列表（可能为空） |
+| search_item_list | array | 备选数据路径（当 aweme_list 为空时从此取 aweme_info） |
+| has_more | boolean | 是否有更多数据 |
+| cursor | integer | 下一页游标 |
+
+aweme_list 中每个视频包含：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| aweme_id | string | 视频唯一 ID |
+| desc | string | 视频描述/标题 |
+| statistics.play_count | integer | 播放量 |
+| statistics.digg_count | integer | 点赞数 |
+| statistics.comment_count | integer | 评论数 |
+| statistics.share_count | integer | 分享数 |
+| author.nickname | string | 作者昵称 |
+| author.unique_id | string | 作者用户名 |
+| author.follower_count | integer | 作者粉丝数 |
+| cha_list | array | 关联话题/标签列表 |
+
+## 依赖要求
+
+- 直连代理: `https://server.fmode.cn/thapi`
+- 需携带 Bearer Token 在 Authorization header 中
+- 所有请求均为 GET 方法

voc/asin-reverse-keywords/SKILL.md

@@ -0,0 +1,48 @@
+# asin-reverse-keywords
+
+## 功能用途
+
+根据 ASIN 反向查询该产品关联的搜索关键词列表，包括搜索排名、搜索量等。用于竞品关键词策略分析、广告关键词挖掘。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| ASIN | string | ✅ | Amazon 产品 ASIN（10位大写字母数字） |
+| domain | integer | ❌ | Amazon 站点 ID: 1=amazon.com（默认 1） |
+
+## 接口调用方式
+
+- **请求方法**: POST
+- **接口地址**: `https://server-msq.fmode.cn/api/sorftime/forward`
+- **请求头**: `Content-Type: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+实际请求体通过 `requestTransform` 模板转换：
+```json
+{
+  "path": "/api/ASINRequestKeyword",
+  "method": "POST",
+  "query": { "domain": 1 },
+  "body": {
+    "ASIN": "B0B24QJ217"
+  }
+}
+```
+
+## 返回格式
+
+返回 JSON 数组，每个元素包含：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| Keyword | string | 关键词 |
+| SearchVolume | integer | 月搜索量 |
+| Rank | integer | 该ASIN在此关键词下的排名 |
+| CompetitorCount | integer | 竞争产品数 |
+
+## 依赖要求
+
+- 通过 `https://server-msq.fmode.cn/api/sorftime/forward` 统一转发，认证已在后端内置，前端无需传入 Token
+- `domain` 参数必须是数字
+- ASIN 参数必须大写

voc/asin_reverse_keywords.skill.json → voc/asin-reverse-keywords/api-config.json

@@ -54,7 +54,7 @@
     {
       "name": "反查竞品关键词",
       "input": { "ASIN": "B0B24QJ217", "domain": 1 },
-      "description": "查看 COCORRÍNA Reed Diffuser 排名靠前的搜索关键词"
+      "description": "查看 COCORRINA Reed Diffuser 排名靠前的搜索关键词"
     }
   ],
   "reportMapping": {

voc/asin-sales-volume/SKILL.md

@@ -0,0 +1,49 @@
+# asin-sales-volume
+
+## 功能用途
+
+查询指定 ASIN 的销量数据，包括日销量、周销量、月销量趋势。用于市场规模估算、品类销售额计算。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| ASIN | string | ✅ | Amazon 产品 ASIN（10位大写字母数字） |
+| domain | integer | ❌ | Amazon 站点 ID: 1=amazon.com（默认 1） |
+
+## 接口调用方式
+
+- **请求方法**: POST
+- **接口地址**: `https://server-msq.fmode.cn/api/sorftime/forward`
+- **请求头**: `Content-Type: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+实际请求体通过 `requestTransform` 模板转换：
+```json
+{
+  "path": "/api/AsinSalesVolume",
+  "method": "POST",
+  "query": { "domain": 1 },
+  "body": {
+    "ASIN": "B0CSVRWJ1H"
+  }
+}
+```
+
+## 返回格式
+
+返回 JSON 对象，主要字段：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| DailySales | integer | 日均销量 |
+| WeeklySales | integer | 周均销量 |
+| MonthlySales | integer | 月均销量 |
+| Revenue | number | 估算收入（美元） |
+| SalesTrend | array | 销量趋势数据点 |
+
+## 依赖要求
+
+- 通过 `https://server-msq.fmode.cn/api/sorftime/forward` 统一转发，认证已在后端内置，前端无需传入 Token
+- `domain` 参数必须是数字
+- ASIN 参数必须大写

voc/category-products/SKILL.md

@@ -0,0 +1,51 @@
+# category-products
+
+## 功能用途
+
+根据类目 ID 获取该类目下的产品列表。用于获取品类 Top 产品、分析品类竞争格局、统计品牌分布和中国卖家占比。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| NodeId | string | ✅ | Amazon 类目节点 ID，可通过 category-tree 接口获取 |
+| domain | integer | ❌ | Amazon 站点 ID: 1=amazon.com（默认 1） |
+
+## 接口调用方式
+
+- **请求方法**: POST
+- **接口地址**: `https://server-msq.fmode.cn/api/sorftime/forward`
+- **请求头**: `Content-Type: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+实际请求体通过 `requestTransform` 模板转换：
+```json
+{
+  "path": "/api/CategoryProducts",
+  "method": "POST",
+  "query": { "domain": 1 },
+  "body": {
+    "NodeId": "3734931"
+  }
+}
+```
+
+## 返回格式
+
+返回 JSON 数组，每个元素包含：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| Asin | string | 产品 ASIN |
+| Title | string | 产品标题 |
+| Price | number | 售价 |
+| Rating | number | 评分 |
+| RatingsCount | integer | 评论数 |
+| BSR | integer | BSR 排名 |
+| Brand | string | 品牌 |
+
+## 依赖要求
+
+- 通过 `https://server-msq.fmode.cn/api/sorftime/forward` 统一转发，认证已在后端内置，前端无需传入 Token
+- `domain` 参数必须是数字
+- 关联技能: `category-tree`（先通过类目树获取 NodeId）

voc/category-tree/SKILL.md

@@ -0,0 +1,44 @@
+# category-tree
+
+## 功能用途
+
+获取 Amazon 类目层级树结构，用于定位目标品类的类目 ID，再通过 category-products 获取该类目下的产品列表。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| domain | integer | ❌ | Amazon 站点 ID: 1=amazon.com（默认 1） |
+
+## 接口调用方式
+
+- **请求方法**: POST
+- **接口地址**: `https://server-msq.fmode.cn/api/sorftime/forward`
+- **请求头**: `Content-Type: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+实际请求体通过 `requestTransform` 模板转换：
+```json
+{
+  "path": "/api/CategoryTree",
+  "method": "POST",
+  "query": { "domain": 1 },
+  "body": {}
+}
+```
+
+## 返回格式
+
+返回 JSON 数组，每个元素包含：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| NodeId | string | 类目节点 ID |
+| Name | string | 类目名称 |
+| Children | array | 子类目列表 |
+
+## 依赖要求
+
+- 通过 `https://server-msq.fmode.cn/api/sorftime/forward` 统一转发，认证已在后端内置，前端无需传入 Token
+- `domain` 参数必须是数字
+- 关联技能: `category-products`（使用本接口返回的 NodeId 查询类目下产品）

voc/keyword-product-ranking/SKILL.md

@@ -0,0 +1,50 @@
+# keyword-product-ranking
+
+## 功能用途
+
+查询指定关键词下的产品排名列表，获取该关键词搜索结果中的产品排序。用于竞品在关键词下的位置分析、广告优化。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| Keyword | string | ✅ | 要查询排名的关键词，如 'reed diffuser' |
+| domain | integer | ❌ | Amazon 站点 ID: 1=amazon.com（默认 1） |
+
+## 接口调用方式
+
+- **请求方法**: POST
+- **接口地址**: `https://server-msq.fmode.cn/api/sorftime/forward`
+- **请求头**: `Content-Type: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+实际请求体通过 `requestTransform` 模板转换：
+```json
+{
+  "path": "/api/KeywordProductRanking",
+  "method": "POST",
+  "query": { "domain": 1 },
+  "body": {
+    "Keyword": "reed diffuser"
+  }
+}
+```
+
+## 返回格式
+
+返回 JSON 数组，每个元素包含：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| Asin | string | 产品 ASIN |
+| Title | string | 产品标题 |
+| Rank | integer | 在该关键词下的排名 |
+| Price | number | 售价 |
+| Rating | number | 评分 |
+| RatingsCount | integer | 评论数 |
+| IsSponsored | boolean | 是否为广告产品 |
+
+## 依赖要求
+
+- 通过 `https://server-msq.fmode.cn/api/sorftime/forward` 统一转发，认证已在后端内置，前端无需传入 Token
+- `domain` 参数必须是数字

voc/keyword-search-trend/SKILL.md

@@ -0,0 +1,52 @@
+# keyword-search-trend
+
+## 功能用途
+
+查询指定关键词的搜索结果趋势变化，包括搜索量随时间的变化。用于发现飙升关键词、季节性趋势分析。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| Keyword | string | ✅ | 要查询趋势的关键词 |
+| domain | integer | ❌ | Amazon 站点 ID: 1=amazon.com（默认 1） |
+
+## 接口调用方式
+
+- **请求方法**: POST
+- **接口地址**: `https://server-msq.fmode.cn/api/sorftime/forward`
+- **请求头**: `Content-Type: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+实际请求体通过 `requestTransform` 模板转换：
+```json
+{
+  "path": "/api/KeywordSearchResultTrend",
+  "method": "POST",
+  "query": { "domain": 1 },
+  "body": {
+    "Keyword": "candle warmer lamp aesthetic"
+  }
+}
+```
+
+## 返回格式
+
+返回 JSON 对象，主要字段：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| TrendData | array | 趋势数据点列表 |
+
+TrendData 数组中每个元素包含：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| Date | string | 日期 |
+| SearchVolume | integer | 搜索量 |
+| ProductCount | integer | 搜索结果产品数 |
+
+## 依赖要求
+
+- 通过 `https://server-msq.fmode.cn/api/sorftime/forward` 统一转发，认证已在后端内置，前端无需传入 Token
+- `domain` 参数必须是数字

voc/keyword-search/SKILL.md

@@ -0,0 +1,49 @@
+# keyword-search
+
+## 功能用途
+
+查询 Amazon 关键词的搜索量、搜索趋势、竞争度等数据。用于广告关键词推荐、趋势雷达、飙升卖点词分析。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| Keyword | string | ✅ | 要查询的关键词，如 'reed diffuser'、'natural reed diffuser'、'candle warmer lamp aesthetic' |
+| domain | integer | ❌ | Amazon 站点 ID: 1=amazon.com（默认 1） |
+
+## 接口调用方式
+
+- **请求方法**: POST
+- **接口地址**: `https://server-msq.fmode.cn/api/sorftime/forward`
+- **请求头**: `Content-Type: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+实际请求体通过 `requestTransform` 模板转换：
+```json
+{
+  "path": "/api/KeywordQuery",
+  "method": "POST",
+  "query": { "domain": 1 },
+  "body": {
+    "Keyword": "natural reed diffuser"
+  }
+}
+```
+
+## 返回格式
+
+返回 JSON 对象，主要字段：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| SearchVolume | integer | 月搜索量 |
+| SearchVolumeGrowth | number | 搜索量增长率 (%) |
+| CompetitionLevel | string | 竞争度: 低/中/高/极高 |
+| CPC | number | 建议广告出价 (美元) |
+| ConversionRate | number | 转化率 (%) |
+| RelatedKeywords | array | 相关关键词列表 |
+
+## 依赖要求
+
+- 通过 `https://server-msq.fmode.cn/api/sorftime/forward` 统一转发，认证已在后端内置，前端无需传入 Token
+- `domain` 参数必须是数字

voc/product-detail-query/SKILL.md

@@ -0,0 +1,76 @@
+# product-detail-query
+
+## 功能用途
+
+根据 ASIN 获取 Amazon 产品详情，包括标题、价格、评分、销量、BSR、品牌、类目、变体、趋势等完整信息。用于竞品分析、市场全景、定价策略。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| ASIN | string | ✅ | Amazon 产品唯一标识符（10位字母数字），必须大写。例：B0CSVRWJ1H |
+| domain | integer | ❌ | Amazon 站点 ID: 1=amazon.com, 2=amazon.co.uk, 3=amazon.de, 4=amazon.co.jp, 5=amazon.fr, 6=amazon.it, 7=amazon.es, 8=amazon.ca（默认 1） |
+| Trend | integer | ❌ | 是否返回趋势数据: 1=是, 0=否（默认 1） |
+| QueryTrendStartDt | string | ❌ | 趋势数据起始日期，格式 YYYYMMDD，留空则使用默认范围 |
+| QueryTrendEndDt | string | ❌ | 趋势数据结束日期，格式 YYYYMMDD，留空则使用默认范围 |
+
+## 接口调用方式
+
+- **请求方法**: POST
+- **接口地址**: `https://server-msq.fmode.cn/api/sorftime/forward`
+- **请求头**: `Content-Type: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+实际请求体通过 `requestTransform` 模板转换：
+```json
+{
+  "path": "/api/ProductRequest",
+  "method": "POST",
+  "query": { "domain": 1 },
+  "body": {
+    "ASIN": "B0CSVRWJ1H",
+    "Trend": 1,
+    "QueryTrendStartDt": "",
+    "QueryTrendEndDt": ""
+  }
+}
+```
+
+## 返回格式
+
+返回 JSON 对象，主要字段：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| Title | string | 产品标题 |
+| Price | number | 当前售价（美元） |
+| SalesPrice | number | 促销价（美元） |
+| Brand | string | 品牌名称 |
+| StoreName | string | 店铺名称 |
+| Rating | number | 平均评分 (0-5) |
+| RatingsCount | integer | 评论总数 |
+| fiveStartRatings | number | 5星评分百分比 |
+| fourStartRatings | number | 4星评分百分比 |
+| threeStartRatings | number | 3星评分百分比 |
+| twoStartRatings | number | 2星评分百分比 |
+| oneStartRatings | number | 1星评分百分比 |
+| MonthlySales | integer | 月销量估算 |
+| BSR | integer | Best Sellers Rank 大类排名 |
+| Category | array | 类目层级 |
+| BsrCategory | array | BSR 类目层级 |
+| Photo | array | 产品图片 URL 列表 |
+| Feature | object | 产品 Bullet Points 卖点 |
+| Description | string | 产品描述 |
+| Property | string | 产品属性（JSON 字符串） |
+| VariationASIN | array | 变体 ASIN 列表 |
+| Size | array | 尺寸选项 |
+| ShipsFrom | string | 发货地 |
+| ProductType | string | 配送类型 (FBA/FBM) |
+| DealType | string | 促销类型 |
+| UpdateDate | string | 数据更新日期 |
+
+## 依赖要求
+
+- 通过 `https://server-msq.fmode.cn/api/sorftime/forward` 统一转发，认证已在后端内置，前端无需传入 Token
+- `domain` 参数必须是数字: 1=amazon.com, 2=amazon.co.uk 等
+- ASIN 参数必须大写

voc/product-monitor/SKILL.md

@@ -0,0 +1,48 @@
+# product-monitor
+
+## 功能用途
+
+获取产品的监控追踪数据，包括价格变化、排名变化、评分变化等历史数据。用于竞品动态追踪、价格监控、新品上架预警。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| ASIN | string | ✅ | Amazon 产品 ASIN（10位大写字母数字） |
+| domain | integer | ❌ | Amazon 站点 ID: 1=amazon.com（默认 1） |
+
+## 接口调用方式
+
+- **请求方法**: POST
+- **接口地址**: `https://server-msq.fmode.cn/api/sorftime/forward`
+- **请求头**: `Content-Type: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+实际请求体通过 `requestTransform` 模板转换：
+```json
+{
+  "path": "/api/MonitorQuery",
+  "method": "POST",
+  "query": { "domain": 1 },
+  "body": {
+    "ASIN": "B0B24QJ217"
+  }
+}
+```
+
+## 返回格式
+
+返回 JSON 对象，主要字段：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| PriceHistory | array | 价格历史数据 |
+| RankHistory | array | 排名历史数据 |
+| RatingHistory | array | 评分历史数据 |
+| ReviewCountHistory | array | 评论数历史数据 |
+
+## 依赖要求
+
+- 通过 `https://server-msq.fmode.cn/api/sorftime/forward` 统一转发，认证已在后端内置，前端无需传入 Token
+- `domain` 参数必须是数字
+- ASIN 参数必须大写

voc/product_monitor.skill.json → voc/product-monitor/api-config.json

@@ -51,7 +51,7 @@
     {
       "name": "监控竞品价格变化",
       "input": { "ASIN": "B0B24QJ217", "domain": 1 },
-      "description": "获取 COCORRÍNA Reed Diffuser 的价格和排名变化历史"
+      "description": "获取 COCORRINA Reed Diffuser 的价格和排名变化历史"
     }
   ],
   "reportMapping": {

voc/product-reviews-query/SKILL.md

@@ -0,0 +1,77 @@
+# product-reviews-query
+
+## 功能用途
+
+根据 ASIN 抓取 Amazon 产品用户评论，支持按星级、日期、是否验证购买筛选。用于 VOC 用户洞察、痛点提取、喜爱点分析、使用场景挖掘。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| ASIN | string | ✅ | Amazon 产品 ASIN（10位大写字母数字） |
+| Star | string | ❌ | 筛选星级: 空=全部, '1'=1星, '2'=2星, '3'=3星, '4'=4星, '5'=5星（默认空） |
+| PageIndex | integer | ❌ | 分页页码，从 1 开始（默认 1） |
+| OnlyPurchase | integer | ❌ | 仅显示验证购买评论: 0=全部, 1=仅验证购买（默认 0） |
+| QueryStartDt | string | ❌ | 评论起始日期，格式 YYYYMMDD，如 '20250101' |
+| domain | integer | ❌ | Amazon 站点 ID: 1=amazon.com（默认 1） |
+
+## 接口调用方式
+
+- **请求方法**: POST
+- **接口地址**: `https://server-msq.fmode.cn/api/sorftime/forward`
+- **请求头**: `Content-Type: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+实际请求体通过 `requestTransform` 模板转换：
+```json
+{
+  "path": "/api/ProductReviewsQuery",
+  "method": "POST",
+  "query": { "domain": 1 },
+  "body": {
+    "ASIN": "B0B24QJ217",
+    "Star": "",
+    "PageIndex": 1,
+    "OnlyPurchase": 0,
+    "QueryStartDt": ""
+  }
+}
+```
+
+> 注意字段名使用 PascalCase: ReviewsDate（非 ReviewDate）、ReviewedCountry（非 ReviewsCountry）、IsVP（非 Ivp）、ConsumerURL（非 ConsumerUrl）、ReviewsLink（非 ReviewLink）。每页约返回 10 条评论，需多次分页获取完整评论。
+
+## 返回格式
+
+返回 JSON 对象，主要字段：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| TotalCount | integer | 评论总数 |
+| Reviews | array | 评论列表 |
+
+Reviews 数组中每条评论包含：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| Star | integer | 评论星级 (1-5) |
+| Title | string | 评论标题 |
+| Content | string | 评论正文 |
+| ConsumerName | string | 评论者名称 |
+| ReviewsDate | string | 评论日期，格式 '20260204' |
+| ReviewedCountry | string | 评论者国家，如 'United States' |
+| IsVP | boolean | 是否验证购买 |
+| Helpful | integer | 有用数 |
+| Asin | string | 关联产品 ASIN |
+| AsinProperty | string | 变体属性 |
+| Resource | array | 评论附图 URL |
+| Videos | array | 评论视频 URL |
+| ConsumerURL | string | 评论者主页链接 |
+| ReviewsLink | string | 评论详情链接 |
+| ConsumerBadge | string | 评论者徽章 |
+| UpdateTime | string | 数据更新时间，格式 '2026-02-06 17:39' |
+
+## 依赖要求
+
+- 通过 `https://server-msq.fmode.cn/api/sorftime/forward` 统一转发，认证已在后端内置，前端无需传入 Token
+- `domain` 参数必须是数字
+- 建议搭配 AI 分析进行情感分类和痛点提取

voc/product_reviews_query.skill.json → voc/product-reviews-query/api-config.json

@@ -100,7 +100,7 @@
     {
       "name": "获取全部评论（第一页）",
       "input": { "ASIN": "B0B24QJ217", "domain": 1 },
-      "description": "获取 COCORRÍNA Reed Diffuser 的全部评论第一页"
+      "description": "获取 COCORRINA Reed Diffuser 的全部评论第一页"
     },
     {
       "name": "获取差评（1-2星）",

voc/product-search/SKILL.md

@@ -0,0 +1,58 @@
+# product-search
+
+## 功能用途
+
+按关键词搜索 Amazon 产品列表，返回多个产品的标题、价格、评分、销量等信息。用于品类市场全景分析、Top100 产品列表获取。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| Pattern | string | ✅ | 搜索关键词，如 'reed diffuser'、'aroma diffuser'、'scented candle' |
+| Page | integer | ❌ | 分页页码，从 1 开始（默认 1） |
+| domain | integer | ❌ | Amazon 站点 ID: 1=amazon.com, 2=amazon.co.uk, 3=amazon.de, 4=amazon.co.jp（默认 1） |
+
+## 接口调用方式
+
+- **请求方法**: POST
+- **接口地址**: `https://server-msq.fmode.cn/api/sorftime/forward`
+- **请求头**: `Content-Type: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+实际请求体通过 `requestTransform` 模板转换：
+```json
+{
+  "path": "/api/ProductQuery",
+  "method": "POST",
+  "query": { "domain": 1 },
+  "body": {
+    "Page": 1,
+    "Query": "1",
+    "QueryType": "7",
+    "Pattern": "aroma diffuser"
+  }
+}
+```
+
+> 注意: QueryType=7 表示按标题搜索。如果被验证码拦截（code=-10），返回空数组，需回退到批量 ProductRequest。
+
+## 返回格式
+
+返回 JSON 数组，每个元素包含：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| Asin | string | 产品 ASIN |
+| Title | string | 产品标题 |
+| Price | number | 售价（美元） |
+| Rating | number | 平均评分 |
+| RatingsCount | integer | 评论总数 |
+| MonthlySales | integer | 月销量估算 |
+| Brand | string | 品牌 |
+| BSR | integer | BSR 排名 |
+| Photo | array | 图片列表 |
+
+## 依赖要求
+
+- 通过 `https://server-msq.fmode.cn/api/sorftime/forward` 统一转发，认证已在后端内置，前端无需传入 Token
+- `domain` 参数必须是数字

voc/similar-products/SKILL.md

@@ -0,0 +1,49 @@
+# similar-products
+
+## 功能用途
+
+根据 ASIN 查询与该产品相似的产品列表，用于竞品发现、关联分析。
+
+## 入参规则
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| ASIN | string | ✅ | Amazon 产品 ASIN（10位大写字母数字） |
+| domain | integer | ❌ | Amazon 站点 ID: 1=amazon.com（默认 1） |
+
+## 接口调用方式
+
+- **请求方法**: POST
+- **接口地址**: `https://server-msq.fmode.cn/api/sorftime/forward`
+- **请求头**: `Content-Type: application/json`
+- **接口配置文件路径**: `./api-config.json`
+
+实际请求体通过 `requestTransform` 模板转换：
+```json
+{
+  "path": "/api/SimilarProductRealtimeRequest",
+  "method": "POST",
+  "query": { "domain": 1 },
+  "body": {
+    "ASIN": "B0B24QJ217"
+  }
+}
+```
+
+> 注意: 此接口为异步任务，返回 TaskId 后需通过 `/api/SimilarProductRealtimeRequestStatusQuery` 查询状态，状态完成后通过 `/api/SimilarProductRealtimeRequestCollection` 获取分页结果。
+
+## 返回格式
+
+返回 JSON 对象，主要字段：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| TaskId | string | 异步任务 ID，需通过后续接口查询结果 |
+| Status | string | 任务状态 |
+
+## 依赖要求
+
+- 通过 `https://server-msq.fmode.cn/api/sorftime/forward` 统一转发，认证已在后端内置，前端无需传入 Token
+- `domain` 参数必须是数字
+- ASIN 参数必须大写
+- 关联技能: `product-detail-query`

voc/similar_products.skill.json → voc/similar-products/api-config.json

@@ -51,7 +51,7 @@
     {
       "name": "查找相似产品",
       "input": { "ASIN": "B0B24QJ217", "domain": 1 },
-      "description": "查找与 COCORRÍNA Reed Diffuser 相似的产品"
+      "description": "查找与 COCORRINA Reed Diffuser 相似的产品"
     }
   ],
   "reportMapping": {