Reddit Research
General-purpose Reddit research agent. Search, read, monitor — all from the terminal. No API key needed.
Why?
Reddit is the largest collection of authentic human opinions on the internet. Unlike SEO-optimized blog posts or sponsored content, Reddit threads contain real experiences, tested solutions, and unfiltered takes.
Zero auth. Zero cost. Zero dependencies.
Data Providers
| Provider | Flag | Best For | Limitation |
|---|
| Reddit (default) | INLINECODE0 | Real-time data, feeds, threads | ~60 req/min |
| PullPush |
--provider pullpush | Historical/deleted posts, global comment search | Sometimes down |
|
Arctic Shift |
--provider arctic-shift | Archived data, deep history | Requires
--sub or
--author |
Default is Reddit (real-time). Switch to PullPush or Arctic Shift when you need historical data or deleted content.
Setup
Node.js 18+ required (for native fetch). No npm install needed.
CODEBLOCK0
CLI Tool
Search
CODEBLOCK1
Options:
- -
--sub <subreddit> — restrict to a subreddit - INLINECODE8 — sort order (default: relevance)
- INLINECODE9 — time filter (default: week)
- INLINECODE10 — max results (default: 15)
- INLINECODE11 — data source
- INLINECODE12 — filter by author (Arctic Shift only)
- INLINECODE13 — one-line format
- INLINECODE14 — save results to file
- INLINECODE15 — raw JSON output
- INLINECODE16 — markdown formatted output
Examples:
CODEBLOCK2
Comment Search
Search through comments using PullPush or Arctic Shift:
CODEBLOCK3
CODEBLOCK4
Subreddit Feeds
CODEBLOCK5
Multi-Subreddit Feed
CODEBLOCK6
Read Thread
CODEBLOCK7
User Profile
CODEBLOCK8
Subreddit Info
CODEBLOCK9
Find Subreddits
CODEBLOCK10
Popular Subreddits
CODEBLOCK11
Cross-Posts / Duplicates
CODEBLOCK12
Wiki
CODEBLOCK13
Watchlist
CODEBLOCK14
Cache
CODEBLOCK15
Research Loop (Agentic)
When doing deep research, follow this loop:
1. Decompose the Question
Turn the research question into 3-5 search queries:
- - Direct query: Core keywords
- Subreddit-specific: Search within the most relevant sub
- Solution-focused: Add "solved", "fix", "how to"
- Experience-focused: Add "experience", "review", "worth it"
- Negative signal: "scam", "avoid", "warning"
- Historical: Use
--provider pullpush for deleted/old content
2. Search and Triage
Run each query. For each result set:
- - High score + lots of comments = worth reading the thread
- Low score but specific = might have niche info
- Cross-posted = narrative spreading
3. Read Key Threads
CODEBLOCK16
4. Cross-Reference
CODEBLOCK17
5. Comment Deep Dive
Search through comments when posts don't surface the answer:
CODEBLOCK18
6. Synthesize
Group findings by theme:
CODEBLOCK19
Heartbeat Integration
On heartbeat, run watchlist check to see if watched subreddits have notable activity. Flag only if genuinely interesting/actionable.
Rate Limits
- - Reddit JSON: ~60 req/min, User-Agent required, auto-retry with backoff
- PullPush: Generous, no official limit, sometimes down
- Arctic Shift: Generous, no official limit
- Cache: 15min TTL prevents redundant hits
File Structure
CODEBLOCK20
Requirements
- - Node.js 18+ (for native
fetch) - No API key needed
- No npm install needed — zero dependencies
Reddit 研究
通用型 Reddit 研究助手。搜索、阅读、监控——全部在终端完成。无需 API 密钥。
为什么选择它?
Reddit 是互联网上最大的真实人类观点集合。与 SEO 优化的博客文章或赞助内容不同,Reddit 帖子包含真实体验、经过验证的解决方案和未经筛选的观点。
零认证。零成本。零依赖。
数据提供商
| 提供商 | 标志 | 最佳用途 | 限制 |
|---|
| Reddit(默认) | --provider reddit | 实时数据、信息流、帖子 | 约 60 次请求/分钟 |
| PullPush |
--provider pullpush | 历史/已删除帖子、全局评论搜索 | 有时不可用 |
|
Arctic Shift | --provider arctic-shift | 归档数据、深度历史 | 需要 --sub 或 --author |
默认为 Reddit(实时)。当需要历史数据或已删除内容时,切换到 PullPush 或 Arctic Shift。
设置
需要 Node.js 18+(用于原生 fetch)。无需 npm install。
bash
cd <技能目录>/scripts
CLI 工具
搜索
bash
npx tsx reddit.ts search <查询> [选项]
选项:
- - --sub <子版块> — 限制在某个子版块内搜索
- --sort relevance|top|new|hot|comments — 排序方式(默认:相关性)
- --time hour|day|week|month|year|all — 时间筛选(默认:一周)
- --limit N — 最大结果数(默认:15)
- --provider reddit|pullpush|arctic-shift — 数据来源
- --author <用户名> — 按作者筛选(仅 Arctic Shift)
- --compact — 单行格式
- --save — 将结果保存到文件
- --json — 原始 JSON 输出
- --markdown — Markdown 格式输出
示例:
bash
npx tsx reddit.ts search pumpfun 诈骗 --sort top --time month
npx tsx reddit.ts search 最佳 VPN --sub privacy --sort top --time year
npx tsx reddit.ts search openclaw --provider pullpush --limit 20
npx tsx reddit.ts search agent --provider arctic-shift --sub openclaw
评论搜索
使用 PullPush 或 Arctic Shift 搜索评论:
bash
npx tsx reddit.ts comments <查询> [--sub <子版块>] [--provider pullpush|arctic-shift] [--limit N]
bash
npx tsx reddit.ts comments solana 诈骗 --provider pullpush --limit 10
npx tsx reddit.ts comments openclaw --provider arctic-shift --sub openclaw
子版块信息流
bash
npx tsx reddit.ts hot <子版块> [--limit N] [--time day|week]
npx tsx reddit.ts new <子版块> [--limit N]
npx tsx reddit.ts rising <子版块> [--limit N]
npx tsx reddit.ts top <子版块> [--time day|week|month|year|all] [--limit N]
npx tsx reddit.ts controversial <子版块> [--time day|week] [--limit N]
多子版块信息流
bash
npx tsx reddit.ts multi <子版块1+子版块2+子版块3> [--sort hot|new|top] [--time day|week] [--limit N]
阅读帖子
bash
npx tsx reddit.ts thread <网址> [--sort top|best|new|controversial] [--limit N] [--depth N]
用户资料
bash
npx tsx reddit.ts user <用户名> [--posts|--comments] [--sort new|top|hot] [--limit N]
子版块信息
bash
npx tsx reddit.ts subreddit <名称>
查找子版块
bash
npx tsx reddit.ts find-subs <查询> [--limit N]
热门子版块
bash
npx tsx reddit.ts popular [--limit N]
跨帖/重复帖
bash
npx tsx reddit.ts duplicates <帖子ID>
维基
bash
npx tsx reddit.ts wiki <子版块> [页面]
监控列表
bash
npx tsx reddit.ts watchlist # 显示所有
npx tsx reddit.ts watchlist add <子版块> [备注] # 添加子版块
npx tsx reddit.ts watchlist remove <子版块> # 移除
npx tsx reddit.ts watchlist check # 检查所有子版块的热门帖子
缓存
bash
npx tsx reddit.ts cache stats # 缓存统计
npx tsx reddit.ts cache clear # 清除所有缓存数据
研究循环(智能体模式)
进行深度研究时,请遵循以下循环:
1. 分解问题
将研究问题转化为 3-5 个搜索查询:
- - 直接查询:核心关键词
- 特定子版块:在最相关的子版块内搜索
- 聚焦解决方案:添加solved、fix、how to
- 聚焦体验:添加experience、review、worth it
- 负面信号:scam、avoid、warning
- 历史查询:使用 --provider pullpush 查找已删除/旧内容
2. 搜索与分类
运行每个查询。对于每组结果:
- - 高分 + 大量评论 = 值得阅读该帖子
- 低分但具体 = 可能包含小众信息
- 跨帖 = 叙事正在传播
3. 阅读关键帖子
bash
npx tsx reddit.ts thread <网址> --sort top --limit 30
4. 交叉引用
bash
npx tsx reddit.ts duplicates <帖子ID>
5. 评论深度挖掘
当帖子未提供答案时,搜索评论:
bash
npx tsx reddit.ts comments 具体错误信息 --provider pullpush --limit 20
6. 综合整理
按主题分组发现:
[发现/主题]
[摘要]
- - u/用户名 在 r/子版块 (⬆️ N): [关键引用] 链接
- u/用户名2 在 r/子版块2 (⬆️ N): [另一种观点] 链接
心跳集成
心跳时,运行 watchlist check 查看监控的子版块是否有值得注意的活动。仅在真正有趣/可操作时标记。
速率限制
- - Reddit JSON:约 60 次请求/分钟,需要 User-Agent,自动重试并退避
- PullPush:宽松,无官方限制,有时不可用
- Arctic Shift:宽松,无官方限制
- 缓存:15 分钟 TTL 防止重复请求
文件结构
skills/reddit-research/
├── SKILL.md # 本文件
├── README.md
├── package.json # 零依赖
├── assets/
│ └── banner.svg
├── scripts/
│ ├── reddit.ts # CLI 入口点
│ └── lib/
│ ├── api.ts # Reddit + PullPush + Arctic Shift 封装
│ ├── cache.ts # 基于文件的缓存
│ └── format.ts # 终端 + Markdown 格式化器
├── data/
│ ├── watchlist.json # 监控的子版块
│ └── cache/ # 自动管理
└── references/
└── reddit-json-api.md # API 端点参考
要求
- - Node.js 18+(用于原生 fetch)
- 无需 API 密钥
- 无需 npm install——零依赖