一、项目概览
liangdabiao/reddit-business-idea-validator 是一个给 Claude Code 使用的 Skill——你告诉它一个创业想法，它自动去 Reddit 抓帖子和评论，让 AI 分析用户痛点、现有方案、市场机会，最后生成一份 0–100 分的综合评分报告。
项目今天（2026-08-10）刚创建，目前 8 Stars、1 Fork。作者 liangdabiao 在 GitHub 上还维护了同系列的 XHS 商业创意验证器（小红书版），两者架构相似，构成了一个”全球 + 中国市场双验证”的工具矩阵。
二、它能解决什么问题
验证创业想法最难的一步是：用户到底在说什么？
- 网上搜到的信息太泛，没有真实用户在抱怨什么
- 自己上 Reddit 查，又累又慢，还容易漏掉重要讨论
- AI 头脑风暴出来的”痛点”，往往不是真实需求
这个工具把 Reddit 变成了一个用户调研数据库，用 AI 自动分析真实讨论，输出结构化报告。
三、工作原理：五步流水线
Claude Code 接到你的需求后，自动跑完这个流程：
- 预检（5 秒）：检查 .env 配置、Python 依赖、API 连通性
- 选参数档位：fast / standard / deep 三档
- Reddit 数据抓取：搜索关键词，抓帖子标题 + 正文 + 评论
- LLM 分析：识别痛点、现有方案、市场机会
- 报告生成：输出 HTML 报告（含评分）
四、三档参数：按需选择
| 档位 | 耗时 | 数据量 | 适合场景 |
|---|---|---|---|
| fast | 2–4 分钟 | 1 页 × 5 条评论 | 快速试水，判断方向 |
| standard（默认） | 10–15 分钟 | 2 页 × 20 条评论 | 正常验证流程 |
| deep | 25–35 分钟 | 3 页 × 30 条评论 | 重要决策，多数据支撑 |
五、最终产出：HTML 评分报告
报告存在 reports/<想法>_<时间戳>.html，包含：
- 综合评分（0–100）+ 一句话定性
- 数据统计：抓取帖子数、评论数、情感分布、活跃 subreddit
- 核心痛点（5–10 条，按重要性排序）
- 现有方案：用户现在用什么替代产品
- 市场机会：哪些需求没被满足
- 行动建议：下一步具体做什么
- 评论标签分析：四象限（人群 / 功能价值 / 保障价值 / 体验价值）
- 用户画像
评分参考：
| 分数 | 含义 |
|---|---|
| ≥ 75 | 🟢 强需求 + 弱竞争，值得做 |
| 50–74 | 🟡 有信号，需要差异化定位 |
| 30–49 | 🟠 信号弱 或 市场已饱和 |
| < 30 | 🔴 几乎没人讨论，或以负面为主 |
六、前置准备
1. 安装依赖
pip install -r requirements.txt2. 配置 .env
# LLM（必填）—— 支持 OpenAI / DeepSeek 等兼容 API
OPENAI_API_KEY="sk-你的key"
OPENAI_BASE_URL="https://api.deepseek.com"
OPENAI_MODEL="deepseek-v4-flash"
# Reddit API（必填）—— 去 reddit.com/prefs/apps 创建 "script" 类型应用
REDDIT_CLIENT_ID="你的client_id"
REDDIT_CLIENT_SECRET="你的client_secret"
REDDIT_USER_AGENT="BusinessResearchAgent/1.0 by 你的用户名"3. 注意：Reddit 应用类型必须是 “script”
如果选了 “web app” 或 “installed app”，会报 401 Unauthorized 错误。
4. 网络要求
⚠️ Reddit 在中国大陆无法直接访问。解决方案：设置代理环境变量：
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890DeepSeek / OpenAI 的 API 通常不受影响，只有 Reddit 流量需要代理。
七、使用方式
方式一：Claude Code（推荐）
直接用大白话告诉 Claude Code：
"帮我验证下这个想法：**给独居老人做智能药盒**"
"**Reddit 上的人怎么看 AI 写代码工具**？跑一下分析"
"我想做**美国市场的二手 Labubu 交易平台**，调研一下"Claude 会自动识别意图，跑完整个流程，最后告诉你评分和报告路径。
方式二：命令行直跑
# 1. 预检
python .claude/skills/reddit-business-idea-validator/scripts/preflight.py
# 2. 跑流水线
python .claude/skills/reddit-business-idea-validator/scripts/run_pipeline.py \
"你的创业想法" --profile standard
# 3. 查看历史
python .claude/skills/reddit-business-idea-validator/scripts/recover.py --list
# 4. 从失败处恢复（不用全部重来）
python .claude/skills/reddit-business-idea-validator/scripts/recover.py \
--resume-last --idea "你的想法"八、设计亮点：Skill 与流水线分离
这个项目有一个很聪明的设计决策：
- Skill 层（SKILL.md）：只负责告诉 Claude 怎么操作，4 个薄壳脚本做预检 / 运行 / 恢复 / 提取
- 业务逻辑层（agents/ + mcp_servers/）：实际的抓取、分析、报告生成逻辑独立维护
好处是：如果未来升级了底层流水线（比如换更强的 LLM、加小红书数据源），Skill 自动跟着升级，不需要改 SKILL.md。
九、适合人群
强烈推荐：
- 想验证美国市场创业想法的创业者（Reddit 是美国用户真实讨论的最大社区）
- 独立开发者 / 副业探索者（用数据说话，减少拍脑袋决策）
- 做产品调研的产品经理（快速获取用户声音）
- 投资人和分析师（快速评估某个 niche 市场的热度）
不适合：
- 需要小红书 / 抖音数据（请用作者同系列的 XHS 验证器）
- 纯 SEO / 关键词调研（Reddit 数据不够结构化）
- 中国大陆市场（Reddit 用户主要是英文市场）
十、一句话总结
Reddit 商业创意验证器是一个 Claude Code Skill，通过 Reddit 真实用户讨论数据验证创业想法——输入一个方向，10–15 分钟后拿到一份 0–100 分的 HTML 评分报告，包含痛点、竞品、机会和行动建议。它和作者同系列的 XHS 验证器一起，构成了中美两大市场双验证的工具矩阵。
GitHub 地址：https://github.com/liangdabiao/reddit-business-idea-validator
相关软件