用途:该技能通过 Reddit API(PRAW)做深度调研,适用于市场调研、用户反馈收集、技术方案研究,最终生成可读研究报告。环境需在 .env 配置 REDDIT_CLIENT_ID、REDDIT_CLIENT_SECRET、REDDIT_USER_AGENT,以及用于 AI 分析的 OPENROUTER_API_KEY。依赖安装:cd .claude/skills/research-by-reddit/scripts 后执行 pip install -r requirements.txt。
主要能力由三个脚本组成。search_reddit.py 搜索全站或指定 subreddit,参数含 --query、--subreddit、--limit(默认 25,最大 100)、--time_filter(all/year/month/week/day/hour)、--sort(relevance/hot/top/new/comments)、--output,例如 python scripts/search_reddit.py --query "AI productivity tools" --limit 50 --time_filter month。fetch_posts.py 抓取某 subreddit 的帖子与评论,参数含 --subreddit、--sort(hot/new/top/rising/controversial)、--limit、--time_filter、--include_comments、--comment_limit、--output。analyze_reddit.py 对 JSON 数据做 AI 分析,参数含 --input、--analysis_type(sentiment/topic/summary/competitive/pain_points)、--model(默认 gemini,可选 claude、gpt-4)、--output、--format(json/markdown)。
典型流程为先定义调研目标与目标 subreddit、时间范围和样本量,再用 search 或 fetch 收集数据,然后运行 AI 分析,最后整合为报告。输出支持结构化 JSON 与 Markdown 报告。
限制与注意:Reddit API 有速率限制(约 60 请求/分钟),大批量收集需分批;不应收集或存储用户个人信息;引用内容需注明来源并遵守 Reddit API 使用条款。认证失败需检查凭据且 Reddit 应用类型为 script;搜索为空可放宽时间范围或更换关键词;AI 分析失败需检查 OPENROUTER_API_KEY 与输入文件格式。其余未提供。