---
name: twitter
description: "Twitter/X 趋势发现和社交媒体洞察。当用户需要搜索推文（Twitter搜索/搜推特/搜X）、查看 Twitter 热门趋势（Twitter趋势/热搜/trending）、查看 Twitter 用户资料（Twitter用户/推特账号/@某人）、分析推文详情（推文分析/tweet详情）、查看推文评论（推文评论/回复）、查看用户粉丝（粉丝列表/followers）、查看热门推文（top tweets/热门推文）、获取视频转录（推文视频/transcript）、或查看 Twitter 社区（Twitter社区/community）时使用此技能。"
version: "1.0.0"
owner_repo: Optima-Chat/optima-scout
---

# Twitter/X - 趋势发现与社交媒体洞察

**开始前先加载 scout-intent skill 执行意图确认。** 平台已确定为 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 找供应商