---
name: reddit
description: "Reddit 趋势发现和商机预判。当用户需要从 Reddit 发现趋势（Reddit趋势/Reddit热门/Reddit话题）、搜索 Reddit 帖子（Reddit搜索/搜Reddit）、查看 subreddit 版块（版块/社区/subreddit）、分析 Reddit 评论（Reddit评论/帖子评论）、查看 Reddit 广告（Reddit广告/竞品广告）、或预判商机（趋势预判/商机发现/市场信号）时使用此技能。"
version: "1.0.0"
owner_repo: Optima-Chat/optima-scout
---

# Reddit - 趋势发现与商机预判

**开始前先加载 scout-intent skill 执行意图确认。** 平台已确定为 Reddit，只需确认目的和品类/关键词。

所有命令使用 `scout reddit` 前缀。

---

## 快速选择：我该用哪个命令？

| 你的目标 | 最佳命令 | 补充命令 | 组合逻辑 |
|---------|---------|---------|---------|
| **发现商机趋势** | `trends "关键词"` | — | 一键聚合全站热帖+多版块分析 |
| **搜索 Reddit 话题** | `search "关键词"` | `comments` | 全站搜索→深入看评论 |
| **监控特定版块** | `subreddit <名称>` | `subreddit-info` | 看热帖+版块数据 |
| **版块内精准搜索** | 通过 API: `/subreddit/:name/search` | — | 在特定版块搜关键词 |
| **分析帖子讨论** | `comments <url>` | — | 看用户真实反馈和痛点 |
| **竞品广告情报** | `ads "关键词"` | — | 看竞品在 Reddit 投了什么广告 |

---

## 典型场景

当用户说：
- "Reddit 上什么火" / "Reddit 趋势" → `scout reddit trends "关键词"`
- "搜一下 Reddit 上关于XX的讨论" → `scout reddit search "XX"`
- "看看 r/BuyItForLife" → `scout reddit subreddit BuyItForLife`
- "这个版块有多少人" → `scout reddit subreddit-info BuyItForLife`
- "看看这个帖子的评论" + Reddit URL → `scout reddit comments "<url>"`
- "竞品在 Reddit 打了什么广告" → `scout reddit ads "产品关键词" -i RETAIL_AND_ECOMMERCE`
- "这个品类有没有商机" / "市场趋势" → `scout reddit trends "品类关键词"`

---

## URL 解析 - Reddit 链接处理

用户可能直接贴 Reddit 链接，按以下规则处理：

| URL 特征 | 提取内容 | 调用命令 |
|----------|---------|---------|
| `reddit.com/r/名称/comments/...` | 完整帖子 URL | `scout reddit comments "<url>"` |
| `reddit.com/r/名称` | subreddit 名称 | `scout reddit subreddit <名称>` |
| `redd.it/短链接` | 完整 URL | `scout reddit comments "https://redd.it/..."` |

**示例**：
```bash
# 帖子链接 → 获取评论
scout reddit comments "https://www.reddit.com/r/BuyItForLife/comments/1s6eg5r/best_backpack/"

# 版块链接 → 获取热帖
# https://www.reddit.com/r/Entrepreneur
scout reddit subreddit Entrepreneur
```

---

## 核心命令

### 🔥 第一层：趋势发现

#### 1. 趋势发现（旗舰命令） - `scout reddit trends`

一键聚合全站搜索 + 多版块热帖分析，用于预判商机。

```bash
scout reddit trends "wireless earbuds"
scout reddit trends "portable blender"scout reddit trends "home office" --subreddits "BuyItForLife,Entrepreneur,smallbusiness" -t month
```

**参数**：
- `<query>`：搜索关键词（必填）
- `--subreddits`：逗号分隔的版块名（默认: BuyItForLife,shutupandtakemymoney,Entrepreneur,smallbusiness）
- `-t, --timeframe`：时间范围 `all|day|week|month|year`（默认: week）
- `-f, --format`：输出格式 `json|text`（默认: json）

**返回数据**：
- `globalResults`：全站 Top 帖子（sort=top，找历史表现最好的讨论）
- `subredditResults`：每个版块的热帖（sort=hot，找当前势头）+ 版块信息（订阅者数、分类）

**分析重点**：
1. 全站 Top 帖 = 已验证的用户兴趣（高 score = 广泛共鸣）
2. 版块热帖 = 正在发酵的需求（hot = 当前势头）
3. 评论数高 = 话题争议性/参与度强
4. 跨版块重复出现的话题 = 强趋势信号

#### 2. 全站搜索 - `scout reddit search`

按关键词搜索全 Reddit。

```bash
scout reddit search "coffee maker"scout reddit search "standing desk" -s top -t month
scout reddit search "protein powder" -s comment_count -t week
```

**参数**：
- `-s, --sort`：排序 `relevance|new|top|comment_count`（默认: top）
- `-t, --timeframe`：时间范围 `all|day|week|month|year`（默认: week）
- `-f, --format`：输出格式 `json|text`

**返回数据**：帖子列表，含 `title`、`subreddit`、`author`、`score`、`numComments`、`permalink`

---

### 📊 第二层：版块分析

#### 3. 版块热帖 - `scout reddit subreddit`

获取特定版块的帖子列表。

```bash
scout reddit subreddit BuyItForLifescout reddit subreddit Entrepreneur --sort top --timeframe week
scout reddit subreddit smallbusiness --sort rising
```

**参数**：
- `<name>`：版块名（不加 r/）
- `-s, --sort`：排序 `best|hot|new|top|rising`（默认: hot）
- `-t, --timeframe`：时间范围（**仅 sort=top 时有效**，其他 sort 值会被忽略）
- `-f, --format`：输出格式

**推荐版块**（商机发现）：

| 版块 | 订阅者 | 方向 |
|------|--------|------|
| r/BuyItForLife | 3.6M | 耐用消费品需求 |
| r/shutupandtakemymoney | 496K | 冲动消费/新奇产品 |
| r/Entrepreneur | 5.1M | 创业趋势/商业模式 |
| r/smallbusiness | 2.4M | 中小企业需求/痛点 |
| r/ProductHunting | — | 产品发现 |
| r/Gadgets | — | 科技产品趋势 |
| r/cooltools | — | 工具和装备 |

#### 4. 版块信息 - `scout reddit subreddit-info`

查看版块的订阅者数、分类、描述等。

```bash
scout reddit subreddit-info BuyItForLifescout reddit subreddit-info Entrepreneur
```

**返回数据**：`name`、`subscribers`、`advertiserCategory`、`description`、`createdAt`

**注意**：`weeklyActiveUsers` 和 `weeklyContributions` 可能为 null（API 限制）。

---

### 💬 第三层：深度分析

#### 5. 帖子评论 - `scout reddit comments`

获取帖子的评论列表，用于分析用户真实反馈。

```bash
scout reddit comments "https://www.reddit.com/r/BuyItForLife/comments/1s6eg5r/..."```

**返回数据**：`post`（帖子详情）+ `comments`（评论列表，含 author、body、score）+ `hasMore`

**分析重点**：
1. 高 score 评论 = 社区共识
2. 产品推荐评论 = 真实用户口碑
3. 抱怨/吐槽评论 = 未满足的需求（商机）
4. "I wish..." / "Why doesn't..." = 产品创意来源

---

### 📢 第四层：竞品广告情报

#### 6. 广告搜索 - `scout reddit ads`

搜索 Reddit 上的广告投放，了解竞品营销策略。

```bash
scout reddit ads "earbuds"scout reddit ads "coffee" -i RETAIL_AND_ECOMMERCE
```

**参数**：
- `<query>`：搜索关键词
- `-i, --industries`：行业筛选（可选）
- `-f, --format`：输出格式

**行业选项**：`RETAIL_AND_ECOMMERCE`, `TECH_B2B`, `TECH_B2C`, `GAMING`, `HEALTH_AND_BEAUTY`, `CONSUMER_PACKAGED_GOODS`, `FINANCIAL_SERVICES`, `EDUCATION`, `ENTERTAINMENT`, `EMPLOYMENT`, `AUTO`, `TRAVEL`, `REAL_ESTATE`

**返回数据**：广告列表（最多 30 条），含 `headline`、`body`、`industry`、`budgetCategory`（LOW/MEDIUM/HIGH）、`objective`、`profileName`

**分析重点**：
1. HIGH 预算广告 = 该品类有大玩家在投入
2. 多个广告主同一品类 = 市场竞争激烈
3. 广告文案中的卖点 = 市场验证过的 USP
4. CONVERSIONS 目标 = 直接带货型广告

---

## 典型工作流

### 趋势预判：从 Reddit 话题到商机

```bash
# 1. 一键发现趋势（全站 + 多版块聚合）
scout reddit trends "portable blender"
# 2. 看到感兴趣的帖子，深入分析评论
scout reddit comments "https://www.reddit.com/r/..."

# 3. 看竞品在 Reddit 的广告投放
scout reddit ads "portable blender" -i RETAIL_AND_ECOMMERCE

# 4. 跨平台验证
scout search "portable blender" --limit 10          # Amazon 市场验证
scout supplier-search "便携式榨汁机" --limit 10      # 1688 供应商
```

### 版块深耕：监控特定社区

```bash
# 1. 了解版块基本情况
scout reddit subreddit-info BuyItForLife
# 2. 看当前热帖
scout reddit subreddit BuyItForLife --sort hot
# 3. 搜索特定品类讨论
scout reddit search "backpack" -s top -t month
# 4. 分析高互动帖子评论
scout reddit comments "<帖子URL>"
```

### 竞品广告分析

```bash
# 1. 搜索品类广告
scout reddit ads "wireless earbuds" -i RETAIL_AND_ECOMMERCE
# 2. 分析广告文案卖点 → 提炼差异化方向
# 3. 结合 Reddit 用户讨论发现未满足需求
scout reddit search "wireless earbuds problem" -s top -t month
```

---

## 数据解读参考

### 帖子热度判断

| 指标 | 高关注 | 中等 | 低关注 |
|------|--------|------|--------|
| Score | >500 | 50-500 | <50 |
| 评论数 | >100 | 20-100 | <20 |
| Upvote Ratio | >0.90 | 0.70-0.90 | <0.70 |

### 版块活跃度判断

| 订阅者数 | 规模 |
|----------|------|
| >1M | 超大社区，趋势信号强 |
| 100K-1M | 活跃社区，垂直价值高 |
| 10K-100K | 小众社区，精准需求 |
| <10K | 新兴/冷门社区 |

### 商机信号识别

| Reddit 信号 | 含义 | 下一步 |
|------------|------|--------|
| 多帖问 "best X for Y" | 品类有需求但用户迷茫 | Amazon 选品验证 |
| 高 score 吐槽帖 | 现有产品痛点明确 | 差异化产品机会 |
| "I wish..." 高频出现 | 未被满足的需求 | 产品创新方向 |
| 版块 rising 帖子暴涨 | 新兴趋势正在形成 | 快速入场窗口 |
| 竞品广告 HIGH 预算 | 品类利润空间大 | 成本分析 + 供应商 |

---

## 重要提醒

1. **timeframe 限制**：`subreddit` 命令的 `--timeframe` 只在 `--sort top` 时有效，其他排序方式传 timeframe 会被自动忽略
2. **广告数量上限**：`ads` 命令最多返回 30 条广告，无分页
3. **评论分页**：单次最多返回 ~95 条评论，`hasMore=true` 表示还有更多
4. **trends 命令成本**：每次调用消耗多个 API credit（1 + 2×版块数），默认 4 个版块 = 9 credits
5. **版块名大小写敏感**：使用正确的大小写（如 `BuyItForLife` 而非 `buyitforlife`）
6. **跨 Skill 联动**：Reddit 发现趋势 → scout search Amazon 验证 → scout supplier-search 找供应商 → TikTok/抖音验证社媒热度