Reddit Reader

Overview

通过 Reddit OAuth2 API 访问 Reddit 内容的 skill，支持搜索帖子、浏览子版块、阅读帖子详情和评论。输出为结构化 Markdown，可直接用于分析和总结。

Prerequisites

需要设置以下环境变量（从 https://www.reddit.com/prefs/apps 获取，创建 script 类型应用）：

• REDDIT_CLIENT_ID
• REDDIT_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 条
• 无法访问私有子版块或已删除内容