Reddit Reader
Overview
通过 Reddit OAuth2 API 访问 Reddit 内容的 skill，支持搜索帖子、浏览子版块、阅读帖子详情和评论。输出为结构化 Markdown，可直接用于分析和总结。
Prerequisites
需要设置以下环境变量（从 https://www.reddit.com/prefs/apps 获取，创建 script 类型应用）：
REDDIT_CLIENT_IDREDDIT_CLIENT_SECRET
依赖: pip install requests
Usage Scenarios
当用户请求以下任务时触发：
- "搜索 Reddit 关于 xxx 的讨论"
- "看看 r/ClaudeAI 最近有什么热帖"
- "读一下这个 Reddit 帖子"
- "Reddit 上大家怎么看 xxx"
- "帮我找 Reddit 上关于 xxx 的经验分享"
- 任何涉及浏览、搜索、阅读 Reddit 内容的请求
Workflow
Step 1: Determine User Intent
根据用户请求识别需要执行的操作：
| 用户意图 | 子命令 | 示例 |
|---|---|---|
| 搜索特定话题 | search | "搜索 Reddit 上关于 Claude Code 的讨论" |
| 浏览子版块帖子列表 | list | "看看 r/ClaudeAI 最近的热帖" |
| 阅读具体帖子和评论 | read | "读一下这个帖子 https://reddit.com/r/..." |
| 了解子版块信息 | subreddit | "r/LocalLLaMA 是什么社区" |
Step 2: Execute Script
使用 scripts/reddit_reader.py 执行对应操作。脚本路径相对于此 skill 目录。
Search - 搜索帖子
python3 scripts/reddit_reader.py search "query" [options]
| 参数 | 说明 | 默认值 | 可选值 |
|---|---|---|---|
query | 搜索关键词（必填） | - | - |
--subreddit, -s | 限定子版块 | 全站搜索 | 任意子版块名 |
--sort | 排序方式 | relevance | relevance, hot, new, top, comments |
--time, -t | 时间范围 | all | hour, day, week, month, year, all |
--limit, -l | 返回条数 | 10 | 1-100 |
示例：
# 全站搜索，按热度排序，最近一周
python3 scripts/reddit_reader.py search "Claude Code tips" --sort hot --time week --limit 15
# 在特定子版块内搜索
python3 scripts/reddit_reader.py search "cursor vs claude" -s ClaudeAI --sort top --time month
List - 浏览子版块帖子
python3 scripts/reddit_reader.py list <subreddit> [options]
| 参数 | 说明 | 默认值 | 可选值 |
|---|---|---|---|
subreddit | 子版块名（必填） | - | 如 ClaudeAI, LocalLLaMA |
--category, -c | 帖子分类 | hot | hot, new, top, rising, controversial |
--time, -t | 时间范围（top/controversial） | week | hour, day, week, month, year, all |
--limit, -l | 返回条数 | 10 | 1-100 |
示例：
# 热门帖子
python3 scripts/reddit_reader.py list r/ClaudeAI --category hot --limit 10
# 本月最高赞帖子
python3 scripts/reddit_reader.py list LocalLLaMA --category top --time month --limit 20
Read - 阅读帖子和评论
python3 scripts/reddit_reader.py read <post_id_or_url> [options]
| 参数 | 说明 | 默认值 | 可选值 |
|---|---|---|---|
post | 帖子 ID、完整 URL 或分享短链接（必填） | - | - |
--comment-sort | 评论排序 | top | best, top, new, controversial, old |
--comment-limit | 评论数量 | 30 | 任意整数 |
--comment-depth | 嵌套深度 | 5 | 1-10 |
示例：
# 通过 URL 阅读
python3 scripts/reddit_reader.py read "https://www.reddit.com/r/ClaudeAI/comments/abc123/some_title"
# 通过分享短链接阅读（/s/ 格式，自动解析为真实帖子）
python3 scripts/reddit_reader.py read "https://www.reddit.com/r/ClaudeCode/s/C3mumg2tj8"
# 通过 ID 阅读，按最新评论排序
python3 scripts/reddit_reader.py read abc123 --comment-sort new --comment-limit 50
Subreddit - 查看子版块信息
python3 scripts/reddit_reader.py subreddit <name>
示例：
python3 scripts/reddit_reader.py subreddit ClaudeAI
Step 3: Analyze and Summarize
脚本输出为 Markdown 格式。根据用户需求：
- 总结帖子列表：提炼出主要话题和趋势
- 分析帖子内容：总结正文要点和评论区核心观点
- 对比观点：梳理评论中的不同立场和共识
- 提取经验：从讨论中提取实用建议和经验
References
详细的 Reddit API 端点参数参考见 references/reddit_api.md。
Limitations
- 需要 Reddit API 凭证（client_id + client_secret）
- 只读访问，不支持发帖或评论
- 每分钟 100 次请求限制（OAuth 认证后）
- 搜索结果最多翻阅约 1000 条
- 无法访问私有子版块或已删除内容