内容
# 成本审计代理
**英文** | [中文](README.zh-CN.md)
> 独立创始人操作系统代理 #11 — 跨独立创始人使用的SaaS堆栈的每月账单审计。标记未充分利用的订阅、支出峰值和特定的浪费建议，并附有预估的美元节省。
[](LICENSE)
[](https://pypi.org/project/cost-audit-agent/)
[](#)
由 [Alex Ji](https://github.com/alex-jb) 构建。源自以下思考：
> *我订阅了 14 个 SaaS 工具。我不知道哪些工具我真正有足够的理由继续使用。每个月的第二天，我应该准确地知道哪些工具值得保留。*
## 它做什么
从每个提供商拉取到月度使用情况 + 支出，运行启发式算法，输出带有特定美元标记建议的 Markdown 报告：
```
## 🔍 浪费发现 — 潜在节省：$42.00/月
- ⚠️ **[vercel]** Vercel Pro 未充分利用（~$20.00/月）
- 本月仅 3 次部署，在 $20.00/月 Pro 计划上。如果您可以等待 45 秒更长时间构建，Hobby 计划是免费的。
- 💡 **[anthropic]** Sonnet-heavy 使用 — 考虑为日常任务使用 Haiku（~$22.00/月）
- 73 次 Sonnet 4.6 调用（$33.40）vs 仅 12 次 Haiku 调用。对于差异审查、总结、分类，Haiku 的价格是 Sonnet 的三分之一，质量相当。
```
## 安装
```bash
git clone https://github.com/alex-jb/cost-audit-agent.git
cd cost-audit-agent
pip install -e .
cp .env.example .env # 填写 VERCEL_TOKEN 等
```
## 用法
```bash
# 一次性报告到 stdout
cost-audit-agent
# 写入您的 Obsidian 保险库在每月的第二天（cron 友好）
cost-audit-agent --out ~/Documents/Obsidian/.../cost-$(date +%Y-%m).md
# 限制为一个提供商
cost-audit-agent --provider vercel
```
## 提供商（v0.1）
| 提供商 | 读取内容 | 认证 |
|---|---|---|
| **vercel** | 部署 + 构建分钟估计 + Pro 计划基准 | `VERCEL_TOKEN` |
| **anthropic** | 本地代理使用日志（`~/.build-quality-agent/usage.jsonl`，`~/.funnel-analytics-agent/usage.jsonl`）；如果提供管理员密钥，则组织范围 | 可选 `ANTHROPIC_ADMIN_KEY` + `ANTHROPIC_ORG_ID` |
## 为什么 Anthropic 使用本地日志回退
Anthropic 的组织计费 API 需要管理员范围的密钥，而大多数独立创始人不愿意创建。但是，build-quality-agent 和 funnel-analytics-agent 都将每次调用的使用情况写入 `~/.<agent>/usage.jsonl`。对于运行 2-3 个代理的独立创始人，这些日志涵盖了约 95% 的每月 Anthropic 支出。我们使用发布的 Haiku/Sonnet/Opus 价格按月汇总它们。
## 路线图
- [x] **v0.1** — Vercel + Anthropic 提供商 · Markdown 报告 · 浪费启发式算法 · 14 个测试
- [x] **v0.3** — OpenPanel, HyperDX, Supabase, GitHub Actions 提供商
- [x] **v0.4** — MCP 服务器：查询 Claude Desktop 的每月支出 + 顶部节省
- [ ] **v0.5** — 3 个月的 trailing 基线 · 峰值检测
- [ ] **v0.6** — 报告顶部的 Claude 总结的执行叙述
- [ ] **v0.7** — 自动取消按钮（一个点击的 webhook 到提供商的取消端点，当发现节省 > $10/月，通过 vc-outreach 等 HITL 控制）
## MCP 服务器（Claude Desktop / Cursor / Zed）
询问您的 AI 助手“这个月我最大的浪费是什么？”并让它调用审计器。
```bash
pip install 'cost-audit-agent[mcp]'
```
然后在 `~/Library/Application Support/Claude/claude_desktop_config.json` 中：
```json
{
"mcpServers": {
"cost-audit": {
"command": "cost-audit-mcp",
"env": {
"VERCEL_TOKEN": "...",
"VERCEL_PLAN_USD": "20",
"ANTHROPIC_ADMIN_KEY": "...",
"ANTHROPIC_ORG_ID": "...",
"OPENPANEL_CLIENT_ID": "...",
"OPENPANEL_CLIENT_SECRET": "...",
"HYPERDX_API_KEY": "...",
"SUPABASE_PERSONAL_ACCESS_TOKEN": "...",
"SUPABASE_PROJECT_REF": "...",
"GITHUB_TOKEN": "...",
"GITHUB_REPO": "alex-jb/vibex"
}
}
}
}
```
工具：
- `get_monthly_report()` — 完整的 Markdown 审计，所有提供商
- `get_provider(name)` — 一个提供商的支出 + 浪费发现
- `top_savings(n=5)` — 按估计的 $/月排序的前 N 个发现
## 许可证
MIT。
## 🧩 [独立创始人操作系统](https://github.com/alex-jb/solo-founder-os) 堆栈的一部分
一个不断增长的 MIT 许可代理集合，它们共享 `solo-founder-os` 作为其基础 — cron、eval、reflexion、AnthropicClient、HITL 队列、通知器。每个代理都独立有用；它们一起涵盖了整个单人公司的工作流程。
🌐 整个堆栈在 [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) | Pre-push Claude 差异审查器 + 本地构建运行器 — 在发货前捕获可能导致 CI 失败的更改。 |
| [customer-discovery-agent](https://github.com/alex-jb/customer-discovery-agent) | Reddit 痛点刮刀 + Claude 聚类用于产品验证。 |
| [funnel-analytics-agent](https://github.com/alex-jb/funnel-analytics-agent) | 每日创始人简报 + 9 个来源的实时 PH 日警报。 |
| [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 合并的 customer-outreach）。HITL 队列 + SMTP 发送器。 |
| [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>`。*
