内容
# 客户发现代理
| [中文](README.zh-CN.md)
> 扫描在线社区以寻找 **创客的痛点**。聚类成主题。获取每周的摘要，了解您未来的用户真正感到沮丧的事情。
[](LICENSE)
[](https://pypi.org/project/customer-discovery-agent/)
[](#)
[](#)
[-FF4500.svg)](#)
由 [Alex Ji](https://github.com/alex-jb) 构建 — 独立创始人，正在开发 [VibeXForge](https://vibexforge.com)，[Orallexa](https://github.com/alex-jb/orallexa-ai-trading-agent)，和 [marketing-agent](https://github.com/alex-jb/orallexa-marketing-agent)。源自以下思考：
> *我一直在猜测独立创客真正需要什么。Reddit 知道。*
## 功能
```bash
customer-discovery-agent scan \
--subreddits SaaS IndieHackers SideProject Entrepreneur \
--hours 168 \
--out digest.md
```
对于每个启用的 subreddit，代理：
1. 拉取最近 `--hours` 窗口内的热门和新帖
2. 通过 **痛点关键词** 过滤（默认为 17 个短语，如 *"我希望"*，*"感到沮丧"*，*"有没有工具"*，*"难以"*）
3. 将匹配结果发送到 Claude Haiku 进行 **主题聚类**（3-7 个聚类）
4. 渲染带有代表性引用和样本 URL 的 markdown 摘要
如果没有 `ANTHROPIC_API_KEY`，则会退回到基于关键词的确定性聚类 — 仍然有用，只是没有那么连贯。
## 示例输出
```markdown
# 客户发现摘要
*窗口：最近 168 小时 · 来源：reddit*
*扫描痛点：47 · 聚类：5*
## 顶级主题
### 创始人对 Vercel 构建分钟数的沮丧
**8 篇帖子 · 平均评分 42.5**
> 本月 130 美元的构建分钟数，一半来自失败的类型检查推送
样本帖子：
- https://reddit.com/r/SaaS/comments/...
- https://reddit.com/r/IndieHackers/comments/...
```
## 安装
```bash
git clone https://github.com/alex-jb/customer-discovery-agent.git
cd customer-discovery-agent
pip install -e .
```
设置 Reddit 凭证（PRAW 脚本应用，网址：https://reddit.com/prefs/apps）：
```bash
export REDDIT_CLIENT_ID=...
export REDDIT_CLIENT_SECRET=...
export REDDIT_USERNAME=...
export REDDIT_PASSWORD=...
export REDDIT_USER_AGENT="customer-discovery-agent/0.1 by yourname"
```
可选：`ANTHROPIC_API_KEY` 用于 LLM 聚类。
## 命令行界面
```
customer-discovery-agent scan
--subreddits SaaS IndieHackers SideProject ... （必填）
--hours 168 （回溯窗口）
--keywords "我希望" "感到沮丧" ... （覆盖默认列表）
--min-score 5 （跳过评分低于此的帖子）
--limit 100 （每个 subreddit 每流的最大帖子数）
--max-clusters 7
--out digest.md （默认：stdout）
```
## 路线图
- [x] **v0.1** — Reddit 抓取器 + 关键词过滤器 + Claude 聚类 + markdown 摘要
- [ ] **v0.2** — IndieHackers RSS，X 时间线，即刻搜索，知乎问题抓取器
- [ ] **v0.3** — 电子邮件投递（Resend / Mailgun），GitHub Actions 每周 cron
- [ ] **v0.4** — 基于嵌入的语义聚类（替换 LLM 聚类调用以降低成本）
- [ ] **v0.5** — 跨周差异 — “这个主题本周增长了 3 倍”
## 为什么存在
独立创始人会在用户研究中犯两个系统性错误：
1. **凭直觉构建**：跳过发现 → 没有买家的产品
2. **手动进行**：滚动 Reddit 数小时 → 要么浪费数周，要么停止发生
该代理在周日晚间作为 cron 运行，周一早晨将摘要放入您的收件箱，您的猜测变成 **您未来用户的真实引用**。在模板模式下，每次扫描的成本约为 0.001 美元，在繁忙的周中使用 LLM 聚类时，每次扫描的成本约为 0.05 美元。
## MCP 服务器（Claude Desktop / Cursor / Zed）
在 AI 助手中内联询问“扫描 IndieHackers 本周的痛点”。
```bash
pip install 'customer-discovery-agent[mcp]'
```
```json
{
"mcpServers": {
"customer-discovery": {
"command": "customer-discovery-mcp",
"env": { "ANTHROPIC_API_KEY": "..." }
}
}
}
```
工具：`scan(subreddits, hours, …)` · `latest_digest(directory)` · `keyword_list()`
## 许可证
MIT — 使用它，fork 它，并添加 IndieHackers 和 即刻。
## 🧩 [Solo Founder OS](https://github.com/alex-jb/solo-founder-os) 栈的一部分
一个不断增长的 MIT 许可代理集合，它们共享 `solo-founder-os` 作为其基础 — cron，eval，reflexion，AnthropicClient，HITL 队列，通知器。每个代理都独立有用；它们一起涵盖了整个一人公司的 workflow。
🌐 整个栈已经在 [vibexforge.com](https://vibexforge.com) 上投入生产。
| 代理 | 功能 |
|---|---|
| [solo-founder-os](https://github.com/alex-jb/solo-founder-os) | 共享基础库（cron · eval · reflexion · 技能库 · DGM-lite）。其他代理都依赖于它。 |
| [build-quality-agent](https://github.com/alex-jb/build-quality-agent) | 预推送 Claude 差异审查器 + 本地构建运行器 — 在发货前捕获可能导致 CI 失败的更改。 |
| [funnel-analytics-agent](https://github.com/alex-jb/funnel-analytics-agent) | 每日报告 + 9 个来源的实时 PH-day 警报。 |
| [orallexa-marketing-agent](https://github.com/alex-jb/orallexa-marketing-agent) | AI 营销代理 — 提交项目一次，获取 X / Reddit / HN / Dev.to / 小红书 + 7 个其他平台的原生帖子。支持 [vibexforge.com](https://vibexforge.com)。 |
| [vc-outreach-agent](https://github.com/alex-jb/vc-outreach-agent) | 冷邮件起草器 — 投资者（vc 模式）或付费客户（客户模式，从 v0.9.0 合并）。HITL 队列 + SMTP 发送器。 |
| [cost-audit-agent](https://github.com/alex-jb/cost-audit-agent) | 6 个提供商（Vercel / Anthropic / OpenPanel / HyperDX / Supabase / GitHub Actions）的月度账单审计，带有美元标记的浪费发现。 |
| [bilingual-content-sync-agent](https://github.com/alex-jb/bilingual-content-sync-agent) | EN ⇄ 中文 i18n 差异 + Claude 翻译 + HITL 应用。批量 API 路径 @ 50% 折扣。 |
| [customer-support-agent](https://github.com/alex-jb/customer-support-agent) | 分类用户消息 → 自动起草回复 → HITL 队列。关闭 L5 客户支持层。 |
| [payments-agent](https://github.com/alex-jb/payments-agent) | 逾期发票提醒起草器。Stripe 形状的类型 + MockProvider 备用 + 硬货币安全提示规则。 |
*每个代理的单独行在其 README 中省略。安装那些能为您解决实际问题的代理 — `pip install <agent-name>`。*
