Reddit 商业创意验证器（reddit-business-idea-validator）

给 Claude Code 用的 Skill。你说一个创业想法，它自动去 Reddit 抓帖子 + 评论，让 AI 分析痛点、现有方案、市场机会，最后给你一份打分（0–100）的 HTML 报告。

一句话介绍

"卖陈皮茶能赚钱吗？" → Claude 自动跑完抓取、分析、报告全流程，给你一份带评分的调研报告。

它能帮你做什么

• 验证想法：你给的创意（产品 / 服务 / 利基市场），它会去 Reddit 找真人讨论
• 找痛点：从帖子+评论里提取用户真正在抱怨什么、需要什么
• 看竞品：现在大家都在用什么替代方案
• 看机会：哪些需求没被满足，可以做差异化
• 打分：0–100 综合评分，秒懂这个方向值不值得做

适用场景

前置准备

1. 装好 Python 和依赖

# 项目根目录下
pip install -r requirements.txt

2. 配置 .env 文件

在项目根目录建一个 .env，填入以下内容：

# LLM（必填）—— 支持 OpenAI 或 DeepSeek 等兼容 API
OPENAI_API_KEY="sk-你的key"
OPENAI_BASE_URL="https://api.deepseek.com"   # 或 https://api.openai.com
OPENAI_MODEL="deepseek-v4-flash"             # 或 gpt-4o

# Reddit API（必填）—— 去 https://www.reddit.com/prefs/apps 创建 "script" 类型应用
REDDIT_CLIENT_ID="你的client_id"
REDDIT_CLIENT_SECRET="你的client_secret"
REDDIT_USER_AGENT="BusinessResearchAgent/1.0 by 你的用户名"

⚠️ Reddit 应用必须是 "script" 类型，否则会报 401 错误。

3. 网络要求

⚠️ Reddit 在中国大陆无法直接访问。如果你的网络环境访问不了 www.reddit.com：

• 设置代理环境变量：HTTPS_PROXY=http://127.0.0.1:7890（改成你的代理端口）
• 或在能访问 Reddit 的网络环境下运行

DeepSeek/OpenAI 的 API 通常不受影响，只有 Reddit 流量被卡。

怎么用（在 Claude Code 里）

直接用大白话告诉 Claude 你的需求，比如：

• "帮我验证下这个想法：给独居老人做智能药盒"
• "Reddit 上的人怎么看 AI 写代码工具？跑一下分析"
• "我想做美国市场的二手 Labubu 交易平台，调研一下"

Claude 会自动识别你的意图，跑这个 skill，整个过程：

1. 预检环境（5 秒）：检查 .env、依赖、API 连通性
2. 选参数档位：默认 standard（10-15 分钟），或根据你的提示选 fast / deep
3. 后台跑流水线：抓取 → 分析 → 生成报告
4. 回报结果：告诉你评分、3 大痛点、3 大机会、报告路径

三档参数（Claude 会按需选）

最终产出

跑完后你会拿到：

一份 HTML 报告，存在 reports/<想法>_<时间戳>.html，里面有：

• 🎯 综合评分（0-100）+ 一句话定性（强 / 有潜力 / 弱 / 不建议）
• 📊 数据统计：抓了多少帖子、评论，情感分布，活跃 subreddit
• 🔥 核心痛点（5-10 条，按重要性排序）
• 🛠️ 现有方案：用户现在都怎么解决这个问题
• 💡 市场机会：哪些需求没被满足
• 📋 行动建议：下一步该做什么
• 🏷️ 评论标签分析：四象限（人群 / 功能价值 / 保障价值 / 体验价值）
• 👥 用户画像

评分参考：

常见问题

Q: 报告里说 "0 results" / "no posts found"

说明 Reddit 上几乎没人讨论你这个关键词。可能原因：

• 关键词太冷门 → 换个更宽泛的英文词
• 关键词是中文 → 译成英文再跑
• 本身就是个空市场 → 这其实是个有价值的负面信号

Q: Reddit 报 401 / Unauthorized

你的 Reddit 应用类型选错了。去 https://www.reddit.com/prefs/apps 重新创建一个 "script" 类型的应用（不是 "web app" 或 "installed app"）。

Q: 报告超时 / 跑不完

• 换 fast 档位
• 或加 --max-posts 10 减少分析量
• 或换更快的 LLM 模型（比如 gpt-4o-mini）

Q: 网络错误（network_unreachable）

你的网络访问不了 Reddit。设代理：

export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890

Q: 跑到一半失败了，要全部重来吗？

不用！用恢复功能：

# 看看上次跑到哪一步了
python .claude/skills/reddit-business-idea-validator/scripts/recover.py --list

# 从最近一次失败处续跑
python .claude/skills/reddit-business-idea-validator/scripts/recover.py \
    --resume-last --idea "你的想法"

文件结构

.claude/skills/reddit-business-idea-validator/
├── README.md                     # ← 你正在看的这份（给人看）
├── SKILL.md                      # 给 Claude 看的指令书
├── scripts/                      # 实际跑的脚本
│   ├── preflight.py              # 预检
│   ├── run_pipeline.py           # 主运行器
│   ├── recover.py                # 失败恢复
│   └── extract_report.py         # 抽取结果
└── references/                   # 详细参考文档
    ├── failure-recovery.md       # 错误对照表
    ├── param-matrix.md           # 参数详解
    └── report-anatomy.md         # 报告章节详解

高级用法（命令行直跑）

如果你不想通过 Claude，也可以直接命令行跑：

# 1. 先预检
python .claude/skills/reddit-business-idea-validator/scripts/preflight.py

# 2. 跑流水线（后台运行推荐，因为要 10+ 分钟）
python .claude/skills/reddit-business-idea-validator/scripts/run_pipeline.py \
    "你的创业想法" --profile standard

# 3. 查看历史所有 run
python .claude/skills/reddit-business-idea-validator/scripts/recover.py --list

# 4. 提取某个 run 的摘要（不打开 HTML）
python .claude/skills/reddit-business-idea-validator/scripts/extract_report.py \
    --run-id "完整的run_id"

每个脚本都支持 --help 查看完整参数。

设计理念

这个 skill 不重新发明轮子。所有业务逻辑（抓取、分析、报告生成）都在项目的 agents/ 和 mcp_servers/ 目录里，skill 只是：

• 一份使用说明书（SKILL.md）告诉 Claude 怎么操作这套系统
• 四个薄壳脚本做预检、运行、恢复、结果提取
• 三份参考文档应对失败、解释参数、解读报告

所以未来如果你升级了底层流水线（比如换更强的 LLM、加小红书数据源），这个 skill 自动跟着升级，不需要改 skill 代码。

反馈与改进

• 发现 bug 或想加新功能：直接告诉 Claude "这个 skill 有个问题：..."
• 想了解每个脚本怎么实现的：读 SKILL.md 和 references/ 里的文档
• 想看真实跑过的案例：agent_context/checkpoints/ 下有历史 run，可以用 recover.py --show <run_id> 查看

特别感谢

https://linux.do 社区佬友