@optima-chat/optima-agent 0.7.9 → 0.7.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -106,7 +106,11 @@
106
106
  "Bash(git pull:*)",
107
107
  "Bash(pnpm build:*)",
108
108
  "Skill(read-code)",
109
- "Bash(npm run cli:*)"
109
+ "Bash(npm run cli:*)",
110
+ "Bash(scout:*)",
111
+ "WebFetch(domain:docs.scrapecreators.com)",
112
+ "WebFetch(domain:scrapecreators.com)",
113
+ "Bash(gh auth status:*)"
110
114
  ],
111
115
  "deny": [],
112
116
  "ask": []
@@ -49,8 +49,8 @@ scout tiktok trending --region UK --time-period 7d --limit 20
49
49
 
50
50
  | 你的目标 | 最佳命令 | 补充命令 | 组合逻辑 |
51
51
  |---------|---------|---------|---------|
52
- | **发现爆款产品** | `shop-search` 按销量排序 | `trending --has-product` | 销量+热度双验证 |
53
- | **找内容灵感** | `trending` | `video-insights` | 看趋势视频的文案和 hook |
52
+ | **发现爆款产品** | `shop-search` 按销量排序 | `search-videos --has-product` | 销量+视频热度双验证 |
53
+ | **找内容灵感** | `trending` | `video-insights` | 发现热门话题,深入分析文案 |
54
54
  | **验证产品需求** | `search-videos "产品" --has-product` | `shop-search "产品"` | 视频数量=热度,销量=真实需求 |
55
55
  | **竞品分析** | `search-videos "品牌"` | `shop-search "品牌"` | 内容策略+价格策略 |
56
56
  | **网红合作** | `creators` | `creator-products` | 找人+看历史推广 |
@@ -62,7 +62,8 @@ scout tiktok trending --region UK --time-period 7d --limit 20
62
62
 
63
63
  当用户说:
64
64
  - "帮我找TikTok网红" / "找美妆博主" → `scout tiktok creators`
65
- - "TikTok上什么产品火" / "最近有什么爆款" → `scout tiktok trending --has-product`
65
+ - "TikTok上什么产品火" / "最近有什么爆款" → `scout tiktok shop-search "品类" --region US`
66
+ - "最近流行什么话题" / "看看热门视频" → `scout tiktok trending --region US`
66
67
  - "搜索TikTok Shop的XX产品" → `scout tiktok shop-search "XX"`
67
68
  - "这个TikTok Shop产品详情" → `scout tiktok shop-product <productId>`
68
69
  - "搜索XX相关的视频" → `scout tiktok search-videos "XX"`
@@ -101,12 +102,12 @@ scout tiktok shop-search "coffee maker" --region US --limit 10 --format text
101
102
  scout tiktok trending --region US --time-period 7d --has-product --limit 20
102
103
  ```
103
104
 
104
- **返回数据**:`views`, `likes`, `comments`, `shares`, `productUrl`, `description`, `creator`, `videoUrl`(视频直接下载链接,使用 `wget -O "filename.mp4" "<videoUrl>"` 下载)
105
+ **返回数据**:`id`, `url`, `creator`, `description`, `createdAt`, `duration`
105
106
 
106
- **分析逻辑**:
107
- - 多个视频推同一产品 = 趋势信号强
108
- - 评论问"哪里买" = 购买意向高
109
- - likes/views >5% = 内容质量好
107
+ **使用场景**:
108
+ - 快速查看当前热门视频话题和创作者
109
+ - 发现热门内容的创意灵感
110
+ - 需要详细数据时,用返回的 URL 调用 `video-insights` 获取完整信息
110
111
 
111
112
  #### 3. 搜索视频 - `scout tiktok search-videos`
112
113
 
@@ -132,13 +133,14 @@ scout tiktok search-videos "coffee maker" --region US --has-product --limit 20
132
133
  scout tiktok video-insights "https://tiktok.com/@user/video/123456789"
133
134
  ```
134
135
 
135
- **返回数据**:`video`(完整数据), `transcript`(视频字幕,分析 Hook 和文案), `comments`(用户评论,提取情感和购买意向)
136
+ **返回数据**:`video`(完整数据), `transcript`(视频字幕,仅当视频有字幕时返回), `comments`(用户评论)
136
137
 
137
138
  **分析重点**:
138
- 1. Transcript 3 - 开头 Hook
139
- 2. Comments 高频词 - "where to buy", "I need this"
140
- 3. Likes/Views >5% - 优秀内容
141
- 4. Shares - 传播性强
139
+ 1. Video 统计数据 - views, likes, comments, shares
140
+ 2. Transcript(如有)前 3 - 开头 Hook
141
+ 3. Comments 高频词 - "where to buy", "I need this"
142
+ 4. Likes/Views >5% - 优秀内容
143
+ 5. Shares - 传播性强
142
144
 
143
145
  #### 5. TikTok Shop 产品详情 - `scout tiktok shop-product`
144
146
 
@@ -200,7 +202,8 @@ scout tiktok hashtags --region US --limit 30
200
202
  ## 选品方法论:数据交叉验证
201
203
 
202
204
  TikTok 选品的关键是交叉验证:
203
- - 📹 **视频热度**(`trending`, `search-videos`)= 内容端的热度
205
+ - 📹 **视频热度**(`search-videos`)= 内容端的热度(views/likes 数据)
206
+ - 🎯 **热门话题**(`trending`)= 发现当前趋势和话题方向
204
207
  - 💰 **销量数据**(`shop-search`, `shop-product`)= 交易端的验证
205
208
 
206
209
  ### 信号强度判断
@@ -213,15 +216,15 @@ TikTok 选品的关键是交叉验证:
213
216
 
214
217
  ### 典型验证流程
215
218
 
216
- **流程1:trending 发现 → shop-search 验证**
219
+ **流程1:search-videos 发现 → shop-search 验证**
217
220
  ```bash
218
- # 1. 看到热门视频推某产品
219
- scout tiktok trending --region US --has-product
221
+ # 1. 搜索产品相关视频,按热度排序
222
+ scout tiktok search-videos "产品名" --region US --has-product --limit 20
220
223
 
221
224
  # 2. 验证销量
222
225
  scout tiktok shop-search "产品名" --region US
223
226
 
224
- # 3. 判断:sold_count >5000 = 强信号
227
+ # 3. 判断:高 views/likes + sold_count >5000 = 强信号
225
228
  ```
226
229
 
227
230
  **流程2:shop-search 发现 → search-videos 学习**
@@ -353,5 +356,5 @@ scout tiktok creator-products @competitor_influencer
353
356
  3. **Engagement Rate > Follower Count**:小网红高互动比大V低互动效果好
354
357
  4. **跨 Skill 联动**:TikTok 发现趋势 → scout 验证市场 → scout supplier-search 找供应商
355
358
  5. **TikTok Shop 数据最可靠**:销量数据 > 视频热度,真实交易数据是最强验证
356
- 6. **视频下载**:`trending` 和 `search-videos` 返回的 `videoUrl` 是可直接下载的 .mp4 链接,使用 `wget -O "filename.mp4" "<videoUrl>"` 下载
359
+ 6. **视频下载**:`search-videos` 和 `video-insights` 返回的 `videoUrl` 是可直接下载的 .mp4 链接(临时链接,几小时后过期),使用 `wget -O "filename.mp4" "<videoUrl>"` 下载
357
360
  7. **Region 参数使用**:美国和英国的趋势完全不同,建议明确指定 `--region` 匹配目标市场
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@optima-chat/optima-agent",
3
- "version": "0.7.9",
3
+ "version": "0.7.10",
4
4
  "description": "基于 Claude Agent SDK 的电商运营 AI 助手",
5
5
  "type": "module",
6
6
  "main": "dist/src/index.js",