reddit-skill

name	reddit-skill
description	通过 Reddit OAuth2 API 搜索和阅读 Reddit 帖子、评论和子版块内容。当用户要求搜索 Reddit 讨论、浏览子版块帖子、阅读 Reddit 帖子内容和评论、了解 Reddit 社区对某个话题的看法时使用此 skill。支持按时间范围和排序方式筛选，支持读取完整帖子正文和嵌套评论树。

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