shield_lock
JinDaGe
← Back to skills
extension
Category: Data & AnalyticsAPI key required

reddit-business-idea-validator

Validate a business idea by scraping Reddit posts/comments and running a multi-agent LLM analysis pipeline that produces a scored HTML report. Use whenever the user says things like "验证创业想法", "调研 XX 在 Reddit 上的反响", "这个产品有市场吗", "validate business idea", "is X a good business idea", "analyze market demand for X", "what pain points do people have around X", or provides a product/niche/idea and wants market signals, pain points, sentiment, competitive landscape, or a go/no-go recommendation. Also use when the user references this repo's pipeline ("跑一下 agent", "用 orchestrator 验证", "生成报告") and asks for a report. Produces an HTML report at reports/{idea}_{timestamp}.html with a 0-100 overall score, pain points, existing solutions, opportunities, recommendations, and a 4-category comment tag analysis.

personAuthor: user_8bb4b4f5hubcommunity
downloadDownload package

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

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

一句话介绍

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

它能帮你做什么

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

适用场景

| ✅ 适合问 | ❌ 不适合问 | |------------------------------------------|----------------------------------| | "XX 在美国有市场吗" | 纯关键词调研 / SEO | | "Reddit 上的人怎么看 XX" | 想要小红书/抖音数据（本项目只支持 Reddit）| | "XX 这个产品的痛点是什么" | 让 AI 凭空头脑风暴（不抓真实数据）| | "我想做 XX，值得做吗" | 中国大陆市场（Reddit 用户主要是英文市场）| | "分析下这个 niche 的竞争格局" | |

前置准备

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 会按需选）

| 档位 | 时间 | 抓取量 | 适合 | |-----------|-----------|---------------------|------------------------------| | 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 | 🔴 Reddit 上几乎没人讨论，或负面 |

常见问题

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 社区佬友