ethanplusai/sellbird

项目介绍

Sellbird 是一个自托管的销售外呼平台，覆盖从找线索到处理回复的完整流程：按目标客户画像搜索公司，读取其官网判断购买信号，从官网页面找到老板或经理，摸清公司邮箱命名规律并验证一个可送达地址，根据已有信息写出简短的个性化邮件序列，通过你自己的邮箱在每日限额和对方工作时间内发送，读取回复并起草答案，同时立即执行退订请求。

每一步都可以独立运行或中途停止。只需要名单时，可以在验证后停下，用 sellbird export 导出可导入邮件序列工具的 CSV。不想自己部署的人可以使用 sellbird.ai 的托管版，目前处于早期访问阶段。

项目通过 Claude Code CLI 调用 Claude Pro 或 Max 计划，或通过 Codex 使用 ChatGPT 计划，不需要模型 API Key，也没有按 token 计费。默认找公司用 OpenStreetMap，免费；付费数据源在搜索前会显示成本。邮箱地址会标记为 verified、risky、guess 或 invalid，只向可送达地址发送。发现、画像、补全和验证各阶段见外呼流水线文档。

快速使用

准备条件：Python 3.11 或更高版本；已登录的 Claude CLI（claude login）且使用 Pro/Max 计划，或 Codex CLI 配 ChatGPT 计划；一个用于发送的邮箱，最好放在独立的发信域名上。开始冷邮件前建议对新邮箱做预热。

在克隆后的仓库目录中手动安装：

python3.13 -m venv .venv && source .venv/bin/activate && pip install -e .
cp .env.example .env && $EDITOR .env
sellbird train https://your-company.com
sellbird signals --confirm free
sellbird discover
sellbird dashboard   # 输出 http://127.0.0.1:5555 的私有链接
sellbird run

README 提醒 macOS 自带的可能是 Python 3.9，需要先安装新版本。sellbird train 读取你的官网学习产品信息并写入 sellbird.local.yaml；sellbird signals --confirm free 确认哪些购买信号算合格线索；sellbird discover 从默认免费源搜索公司；sellbird dashboard 在本地启动面板，sellbird run 开始外呼循环。Linux 上也可以选择用 Docker 运行。偏好引导式安装时，克隆仓库后启动 claude，让它完成安装，仓库里的 CLAUDE.md 会作为安装向导。

审批与发送

在你主动开启自动发送之前，所有外发邮件都停在 Outbox 等待批准。发送前的检查不调用模型，会拦截未填充的合并字段、违禁短语、过长邮件、多余链接和不可送达地址。自动发送模式下，指向非自有域名或引用 Sellbird 自身指令的邮件仍会被扣下。sellbird sending pause 可以立即停止发送。细节见审批与发送。

使用约束

需要 Claude Pro/Max 或 ChatGPT 订阅及对应 CLI，以及 Gmail、Microsoft 365 或 SMTP 邮箱。发送受项目内配置的每日限额和收件人工作时间限制。配置分布在 .env、sellbird.yaml 和 sellbird.local.yaml 中，配置文档列出了变量和命令，Microsoft 365 和 Codex 有单独设置指南。

项目采用 AGPL-3.0 许可证；Harvey 时期 0.3.x 及以前的版本为 MIT，并保留相应声明。README 还说明 TrulyInbox 推荐链接是联盟链接，评估邮箱预热建议时可以把这层收益关系纳入判断。冷邮件外呼涉及法律和送达率要求，送达率指南说明了发送规则和预热背景。从 Harvey 升级的用户应参考迁移说明，其中介绍了配置和数据库文件改名，以及旧的 HARVEY_* 变量仍然生效的情况。

HotRepo 点评

Sellbird 出现在 HotRepo 2026-11-07 当周的 Python 周榜第 12 名，当周新增 1,163 星，总星数 4,618。这只是单条周榜记录，不是全部语言日榜名次，能说明那一周增长较强，不足以判断更长期趋势。技术上值得注意的组合是：流水线跑在消费级 Claude 或 ChatGPT 订阅上而不是按量计费的 API，默认数据源免费，也不依赖 Apollo、ZoomInfo 这类付费线索工具。对销售工具而言，默认先审批的 Outbox 和不调用模型的发送前检查，在开启自动发送前提供了实用的安全边界。