@optima-chat/optima-agent 0.8.51 → 0.8.53

package/.claude/skills/reddit/SKILL.md

@@ -67,8 +67,7 @@ scout reddit subreddit Entrepreneur
 
 ```bash
 scout reddit trends "wireless earbuds"
-scout reddit trends "portable blender" --format text
-scout reddit trends "home office" --subreddits "BuyItForLife,Entrepreneur,smallbusiness" -t month
+scout reddit trends "portable blender"scout reddit trends "home office" --subreddits "BuyItForLife,Entrepreneur,smallbusiness" -t month
 ```
 
 **参数**：
@@ -92,8 +91,7 @@ scout reddit trends "home office" --subreddits "BuyItForLife,Entrepreneur,smallb
 按关键词搜索全 Reddit。
 
 ```bash
-scout reddit search "coffee maker" --format text
-scout reddit search "standing desk" -s top -t month
+scout reddit search "coffee maker"scout reddit search "standing desk" -s top -t month
 scout reddit search "protein powder" -s comment_count -t week
 ```
 
@@ -113,8 +111,7 @@ scout reddit search "protein powder" -s comment_count -t week
 获取特定版块的帖子列表。
 
 ```bash
-scout reddit subreddit BuyItForLife --format text
-scout reddit subreddit Entrepreneur --sort top --timeframe week
+scout reddit subreddit BuyItForLifescout reddit subreddit Entrepreneur --sort top --timeframe week
 scout reddit subreddit smallbusiness --sort rising
 ```
 
@@ -141,8 +138,7 @@ scout reddit subreddit smallbusiness --sort rising
 查看版块的订阅者数、分类、描述等。
 
 ```bash
-scout reddit subreddit-info BuyItForLife --format text
-scout reddit subreddit-info Entrepreneur
+scout reddit subreddit-info BuyItForLifescout reddit subreddit-info Entrepreneur
 ```
 
 **返回数据**：`name`、`subscribers`、`advertiserCategory`、`description`、`createdAt`
@@ -158,8 +154,7 @@ scout reddit subreddit-info Entrepreneur
 获取帖子的评论列表，用于分析用户真实反馈。
 
 ```bash
-scout reddit comments "https://www.reddit.com/r/BuyItForLife/comments/1s6eg5r/..." --format text
-```
+scout reddit comments "https://www.reddit.com/r/BuyItForLife/comments/1s6eg5r/..."```
 
 **返回数据**：`post`（帖子详情）+ `comments`（评论列表，含 author、body、score）+ `hasMore`
 
@@ -178,8 +173,7 @@ scout reddit comments "https://www.reddit.com/r/BuyItForLife/comments/1s6eg5r/..
 搜索 Reddit 上的广告投放，了解竞品营销策略。
 
 ```bash
-scout reddit ads "earbuds" --format text
-scout reddit ads "coffee" -i RETAIL_AND_ECOMMERCE
+scout reddit ads "earbuds"scout reddit ads "coffee" -i RETAIL_AND_ECOMMERCE
 ```
 
 **参数**：
@@ -205,8 +199,7 @@ scout reddit ads "coffee" -i RETAIL_AND_ECOMMERCE
 
 ```bash
 # 1. 一键发现趋势（全站 + 多版块聚合）
-scout reddit trends "portable blender" --format text
-
+scout reddit trends "portable blender"
 # 2. 看到感兴趣的帖子，深入分析评论
 scout reddit comments "https://www.reddit.com/r/..."
 
@@ -222,14 +215,11 @@ scout supplier-search "便携式榨汁机" --limit 10      # 1688 供应商
 
 ```bash
 # 1. 了解版块基本情况
-scout reddit subreddit-info BuyItForLife --format text
-
+scout reddit subreddit-info BuyItForLife
 # 2. 看当前热帖
-scout reddit subreddit BuyItForLife --sort hot --format text
-
+scout reddit subreddit BuyItForLife --sort hot
 # 3. 搜索特定品类讨论
-scout reddit search "backpack" -s top -t month --format text
-
+scout reddit search "backpack" -s top -t month
 # 4. 分析高互动帖子评论
 scout reddit comments "<帖子URL>"
 ```
@@ -238,8 +228,7 @@ scout reddit comments "<帖子URL>"
 
 ```bash
 # 1. 搜索品类广告
-scout reddit ads "wireless earbuds" -i RETAIL_AND_ECOMMERCE --format text
-
+scout reddit ads "wireless earbuds" -i RETAIL_AND_ECOMMERCE
 # 2. 分析广告文案卖点 → 提炼差异化方向
 # 3. 结合 Reddit 用户讨论发现未满足需求
 scout reddit search "wireless earbuds problem" -s top -t month

package/.claude/skills/twitter/SKILL.md

@@ -0,0 +1,302 @@
+---
+name: twitter
+description: "Twitter/X 趋势发现和社交媒体洞察。当用户需要搜索推文（Twitter搜索/搜推特/搜X）、查看 Twitter 热门趋势（Twitter趋势/热搜/trending）、查看 Twitter 用户资料（Twitter用户/推特账号/@某人）、分析推文详情（推文分析/tweet详情）、查看推文评论（推文评论/回复）、查看用户粉丝（粉丝列表/followers）、查看热门推文（top tweets/热门推文）、获取视频转录（推文视频/transcript）、或查看 Twitter 社区（Twitter社区/community）时使用此技能。"
+---
+
+# Twitter/X - 趋势发现与社交媒体洞察
+
+所有命令使用 `scout twitter` 前缀。双 API 源：TikHub（搜索/趋势/评论）+ ScrapeCreators（用户推文/转录/社区）。
+
+---
+
+## 快速选择：我该用哪个命令？
+
+| 你的目标 | 最佳命令 | 补充命令 | 组合逻辑 |
+|---------|---------|---------|---------|
+| **发现热门趋势** | `trends` | — | 一键聚合趋势榜+关键词搜索 |
+| **搜索相关推文** | `search "关键词"` | `tweet <id>` | 搜索→深入看详情 |
+| **查看热搜榜** | `trending` | — | Twitter 实时热门话题 |
+| **了解某个账号** | `profile <用户名>` | `top-tweets` + `followers` | 主页→热门推文→粉丝 |
+| **分析特定推文** | `tweet <tweetId>` | `comments` | 推文详情→评论分析 |
+| **社区调研** | `community <url>` | `community-tweets` | 社区信息→社区内容 |
+
+---
+
+## 典型场景
+
+当用户说：
+- "Twitter 上什么火" / "推特热搜" → `scout twitter trending`
+- "搜一下 Twitter 上关于XX的讨论" → `scout twitter search "XX"`
+- "看看这个 Twitter 账号" / "@某人" → `scout twitter profile <用户名>`
+- "分析这条推文" + tweet ID → `scout twitter tweet <tweetId>`
+- "看看推文评论" → `scout twitter comments <tweetId>`
+- "这个账号的粉丝都是谁" → `scout twitter followers <用户名>`
+- "这个账号最火的推文" → `scout twitter top-tweets <用户名>`
+- "这条视频说了什么" → `scout twitter transcript "<url>"`
+- "看看这个 Twitter 社区" → `scout twitter community "<url>"`
+- "这个品类在 Twitter 上有趋势吗" → `scout twitter trends "品类关键词"`
+
+---
+
+## URL 解析 - Twitter/X 链接处理
+
+用户可能直接贴 Twitter 链接，按以下规则处理：
+
+| URL 特征 | 提取内容 | 调用命令 |
+|----------|---------|---------|
+| `x.com/用户名/status/数字` | tweetId (数字) | `scout twitter tweet <tweetId>` |
+| `x.com/用户名` (无 /status) | 用户名 | `scout twitter profile <用户名>` |
+| `x.com/i/communities/数字` | 完整 URL | `scout twitter community "<url>"` |
+| `twitter.com/...` | 同上规则 | 同上 |
+
+**示例**：
+```bash
+# 推文链接 → 提取 tweetId
+# https://x.com/AnthropicAI/status/2034302152945144166
+scout twitter tweet 2034302152945144166
+
+# 用户主页 → 提取用户名
+# https://x.com/AnthropicAI
+scout twitter profile AnthropicAI
+
+# 社区链接 → 传完整 URL
+scout twitter community "https://x.com/i/communities/1926186499399139650"
+```
+
+---
+
+## 核心命令
+
+### 🔥 第一层：趋势发现
+
+#### 1. 趋势发现（旗舰命令） - `scout twitter trends`
+
+一键聚合热搜榜 + 关键词搜索，用于趋势预判。
+
+```bash
+scout twitter trends "wireless earbuds"
+scout twitter trends "AI agents"
+scout twitter trends
+```
+
+**参数**：
+- `[keyword]`：搜索关键词（可选，不传则只返回热搜榜）
+- `-f, --format`：输出格式 `json|text`（默认: json）
+
+**返回数据**：
+- `trends`：Twitter 实时热搜话题列表
+- `searchResults`：关键词搜索结果（仅传 keyword 时）
+
+#### 2. 热搜榜 - `scout twitter trending`
+
+查看 Twitter 实时热门话题。
+
+```bash
+scout twitter trending
+```
+
+**返回数据**：`name`（话题名）、`tweetCount`（推文数）、`context`（话题分类）
+
+#### 3. 搜索推文 - `scout twitter search`
+
+按关键词搜索全 Twitter。
+
+```bash
+scout twitter search "coffee maker"
+scout twitter search "standing desk" --type Latest
+scout twitter search "AI tools" --type Top
+```
+
+**参数**：
+- `<keyword>`：搜索关键词（必填）
+- `-t, --type`：搜索类型 `Top|Latest|People|Photos|Videos`（默认: Top）
+- `-f, --format`：输出格式
+
+**返回数据**：推文列表，含 `text`、`author`（screenName + name）、`likes`、`retweets`、`views`、`createdAt`
+
+---
+
+### 👤 第二层：账号分析
+
+#### 4. 用户资料 - `scout twitter profile`
+
+查看 Twitter 用户主页信息。
+
+```bash
+scout twitter profile AnthropicAI
+scout twitter profile elonmusk
+```
+
+**返回数据**：`name`、`screenName`、`followers`、`following`、`tweetCount`、`verified`、`description`、`location`、`website`
+
+#### 5. 用户热门推文 - `scout twitter top-tweets`
+
+获取用户最热门的推文（ScrapeCreators 源）。
+
+```bash
+scout twitter top-tweets AnthropicAI
+```
+
+**返回数据**：推文列表（按热度排序），含完整互动数据
+
+**注意**：返回的是用户最热门的推文，不是最新推文。
+
+#### 6. 用户粉丝 - `scout twitter followers`
+
+获取用户粉丝列表及详细信息。
+
+```bash
+scout twitter followers AnthropicAI
+```
+
+**返回数据**：`followersCount`（总粉丝数）、`followers[]`（粉丝列表，含 screenName、followers、description）、`hasMore`、`cursor`
+
+---
+
+### 💬 第三层：推文深度分析
+
+#### 7. 推文详情 - `scout twitter tweet`
+
+获取单条推文的完整数据。
+
+```bash
+scout twitter tweet 2034302152945144166
+```
+
+**返回数据**：`text`、`likes`、`retweets`、`replies`、`quotes`、`bookmarks`、`views`、`author`、`createdAt`
+
+#### 8. 推文评论 - `scout twitter comments`
+
+获取推文的回复/评论。
+
+```bash
+scout twitter comments 2034302152945144166
+```
+
+**返回数据**：`comments[]`（评论列表，含 text、author、likes）、`cursor`（分页）
+
+#### 9. 视频转录 - `scout twitter transcript`
+
+获取视频推文的文字转录（AI 驱动，速度较慢）。
+
+```bash
+scout twitter transcript "https://x.com/user/status/123456"
+```
+
+**返回数据**：`transcript`（转录文本）
+
+**注意**：仅视频推文有效，非视频推文返回空。
+
+---
+
+### 🏘️ 第四层：社区洞察
+
+#### 10. 社区信息 - `scout twitter community`
+
+获取 Twitter 社区的详细信息。
+
+```bash
+scout twitter community "https://x.com/i/communities/1926186499399139650"
+```
+
+**返回数据**：`name`、`description`、`memberCount`、`joinPolicy`、`rules[]`、`createdAt`
+
+#### 11. 社区推文 - `scout twitter community-tweets`
+
+获取社区内的推文列表。
+
+```bash
+scout twitter community-tweets "https://x.com/i/communities/1926186499399139650"
+```
+
+**返回数据**：推文列表（含完整互动数据 + 作者信息）
+
+---
+
+## 典型工作流
+
+### 趋势预判：从 Twitter 话题到商机
+
+```bash
+# 1. 一键发现趋势（热搜 + 关键词搜索）
+scout twitter trends "portable blender"
+
+# 2. 深入分析热门推文的评论
+scout twitter comments <tweetId>
+
+# 3. 跨平台验证
+scout search "portable blender" --limit 10          # Amazon 市场验证
+scout reddit trends "portable blender"               # Reddit 趋势对比
+scout supplier-search "便携式榨汁机" --limit 10      # 1688 供应商
+```
+
+### 账号分析流程
+
+```bash
+# 1. 查看目标账号主页
+scout twitter profile AnthropicAI
+
+# 2. 看最火推文
+scout twitter top-tweets AnthropicAI
+
+# 3. 看粉丝质量
+scout twitter followers AnthropicAI
+
+# 4. 深入分析某条推文
+scout twitter tweet <tweetId>
+scout twitter comments <tweetId>
+```
+
+### 竞品社媒分析
+
+```bash
+# 1. 搜索竞品推文
+scout twitter search "竞品品牌" --type Top
+
+# 2. 看竞品账号
+scout twitter profile 竞品账号
+
+# 3. 分析竞品最火推文
+scout twitter top-tweets 竞品账号
+```
+
+---
+
+## 数据解读参考
+
+### 推文表现判断
+
+| 指标 | 高互动 | 中等 | 低互动 |
+|------|--------|------|--------|
+| Views | >100K | 10K-100K | <10K |
+| Likes/Views | >3% | 1-3% | <1% |
+| RT/Views | >1% | 0.3-1% | <0.3% |
+| Replies/Likes | >10% | 3-10% | <3% |
+
+### 账号质量判断
+
+| 指标 | 优秀 | 良好 | 一般 |
+|------|------|------|------|
+| 粉丝数 | >100K | 10K-100K | <10K |
+| 推文互动率 | >5% | 1-5% | <1% |
+| 粉丝/关注比 | >10:1 | 3:1-10:1 | <3:1 |
+
+### 商机信号识别
+
+| Twitter 信号 | 含义 | 下一步 |
+|-------------|------|--------|
+| 热搜话题与品类相关 | 大众关注度高 | 趋势确认 + Amazon 验证 |
+| 高 views 产品推文 | 产品有传播力 | 分析评论反馈 |
+| KOL 推荐某产品 | 意见领袖背书 | 看粉丝反应 + 供应商 |
+| 社区高频讨论某需求 | 垂直需求明确 | 精准选品机会 |
+
+---
+
+## 重要提醒
+
+1. **screenName 大小写敏感**：使用正确的 Twitter 用户名（如 `AnthropicAI` 而非 `anthropicai`）
+2. **tweetId 纯数字**：从推文 URL 中提取数字 ID（如 `2034302152945144166`）
+3. **社区 URL 完整传入**：社区命令需要传完整的 `https://x.com/i/communities/...` URL
+4. **视频转录较慢**：transcript 使用 AI 生成，响应时间可能较长
+5. **热门推文非最新**：`top-tweets` 返回的是用户最热门推文，不是最新发布的
+6. **跨 Skill 联动**：Twitter 发现趋势 → Reddit 验证讨论 → scout search Amazon 验证 → scout supplier-search 找供应商

package/dist/src/system-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/system-prompt.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,IAAI,MAAM,CAgLxC"}
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/system-prompt.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,IAAI,MAAM,CAmLxC"}

package/dist/src/system-prompt.js

@@ -41,6 +41,7 @@ export function getSystemPrompt() {
 - **ads** - Google Ads 广告投放
 - **scout** - Amazon 选品调研
 - **reddit** - Reddit 趋势发现与商机预判
+- **twitter** - Twitter/X 趋势发现与社交媒体洞察
 - **bi** - 数据分析和报表
 - **review** - 评价管理（审核、回复、精选）
 - **sentinel** - 自动化监控规则管理（创建/暂停/查看规则、审批管理）
@@ -56,6 +57,7 @@ export function getSystemPrompt() {
 - 用户："包裹到哪了" / "查物流" - 使用 Skill 工具加载 "order"
 - 用户："连接我的 Shopify 店铺" / "看看 Shopify 商品" - 使用 Skill 工具加载 "shopify"
 - 用户："Reddit 上什么趋势" / "看看 Reddit 上关于XX的讨论" - 使用 Skill 工具加载 "reddit"
+- 用户："Twitter 上什么火" / "搜一下推特上关于XX" / "看看@某人" - 使用 Skill 工具加载 "twitter"
 
 ## 工作原则
 
@@ -98,6 +100,7 @@ export function getSystemPrompt() {
 | \`instagram.com/reel/\`、\`/p/\`、\`instagram.com/username\` | **instagram** | URL / username |
 | \`1688.com/offer/XXXX\` | **scout** | 请用户描述产品关键词 |
 | \`reddit.com/r/名称/comments/...\`、\`redd.it/...\` | **reddit** | 帖子 URL / subreddit 名称 |
+| \`x.com/用户名/status/数字\`、\`twitter.com/...\`、\`x.com/i/communities/...\` | **twitter** | tweetId / 用户名 / 社区 URL |
 
 **重要**：这些平台有反爬机制，WebFetch 必然失败。务必先加载技能再执行命令。
 

package/dist/src/system-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/system-prompt.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE;QAC9C,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,MAAM;QACb,GAAG,EAAE,SAAS;QACd,OAAO,EAAE,MAAM;KAChB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE;QAC9C,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC;IAEH,OAAO;;;;;;;;;aASI,OAAO,IAAI,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyJ9B,CAAC;AACF,CAAC"}
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/system-prompt.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE;QAC9C,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,MAAM;QACb,GAAG,EAAE,SAAS;QACd,OAAO,EAAE,MAAM;KAChB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE;QAC9C,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC;IAEH,OAAO;;;;;;;;;aASI,OAAO,IAAI,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4J9B,CAAC;AACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/optima-agent",
-  "version": "0.8.51",
+  "version": "0.8.53",
   "description": "基于 Claude Agent SDK 的电商运营 AI 助手",
   "type": "module",
   "main": "dist/src/index.js",