imsatoshi/bot_article/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

根据用户请求识别需要执行的操作：

Step 2: Execute Script

使用 scripts/reddit_reader.py 执行对应操作。脚本路径相对于此 skill 目录。

Search - 搜索帖子

python3 scripts/reddit_reader.py search "query" [options]

示例：

# 全站搜索，按热度排序，最近一周
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]

示例：

# 热门帖子
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]

示例：

# 通过 URL 阅读
python3 scripts/reddit_reader.py read "https://www.reddit.com/r/ClaudeAI/comments/abc123/some_title"
 
# 通过 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 条
• 无法访问私有子版块或已删除内容