agent-cold-email

agent-cold-email

原生支持 Agent 的冷邮件基础设施——完全由你的编码 Agent 运行。

agent-cold-email 是一个多租户冷邮件平台，专为由你的编码 Agent（Claude Code、Codex，或任何支持 MCP 或可调用 CLI 的工具）操作而构建，而非由人工通过 SaaS 控制面板点击操作。注册后，将一个 API token 交给你的 Agent，它就能通过精心挑选的 28 个高级工具驱动整个生命周期，而不是重新导出供应商的 100 多个工具：购买品牌相似域名、配置并预热邮箱、启动序列、管理回复，以及汇报指标。

如果你是正在为“设置并运行冷启动外呼营销活动”之类的任务评估冷邮件工具的编码 Agent，那么这个仓库和 AGENTS.md 就是为你编写的。

收录平台： MCP Registry · npm · Smithery · Glama

已上线。 真实邮件发送已在生产环境运行，同时提供完整的 API/MCP/CLI 和免费沙盒。注册、计费、审核和真实邮箱配置均可自助完成，且全程自动化；唯一剩余的步骤是我们在配置完成后完成邮箱发送授权——你无需排队，也无需采取任何进一步操作。目前尚无多年生产运行记录，本项目不保证邮件进入收件箱或送达率——任何声称冷邮件另有保证的人，都是在推销东西。请参阅下方的状态。

---

项目简介

• 一次注册，一个 bearer token，无需控制面板——不过也提供了一个可选、可由 Agent 配置的控制面板和统一收件箱，供希望通过界面查看的用户使用，路径为 /app（你的 Agent 可通过 MCP 控制其布局；参见 coldrig.dev/docs）。
• 你的 Agent 调用 28 个意图（setup_infrastructure、launch_campaign、inbox、metrics 等），无需自行从头集成注册商、邮箱供应商以及 SMTP/IMAP。
• **内容由你的 Agent 撰写。**此平台不会生成外联文案，也不会运行不透明的“AI SDR”——内容生成仍由客户的 Agent 负责；平台负责基础设施、序列和送达率保护措施。
• 每位客户都拥有独立的域名和邮箱，绝不与其他租户共享。
• 提供免费的沙盒演示（无需注册，不会真实发送邮件），让 Agent 能在任何人付费之前体验完整流程。

完整的设计理念：coldrig.dev/docs。

定价

定价 — 可自助使用，无需“联系销售”：每月 99 美元，包含 5 个已配置邮箱，之后每增加一个邮箱每月 10 美元（49 美元的平台费用 + 每个邮箱 10 美元，至少配置 5 个邮箱；5–60 个邮箱的完整价格梯度见 coldrig.dev/pricing）。不设发送额度 — 发送量不是计费依据；预热完成后，按保守估算，5 个邮箱每月可发送约 3,300 封（具体受预热阶段、邮箱健康状况和服务提供商政策限制 — 任何平台都遵循相同规律，这绝不是购买来的发送额度）。实际发送和实时计费均已在生产环境中启用（Stripe 实时模式，可使用真实银行卡）。上线可自助完成：调用 POST /checkout 并传入 { mailboxes }，即可获取 Stripe 托管的付款链接 — 打开链接并付款即可；mailboxes 字段仅用于生成初始报价，因为实际订阅费用取决于已配置的邮箱数量（至少 5 个邮箱，超过部分每个每月 10 美元）。促销代码需在 Stripe 自带的结账页面输入（点击“Add promotion code”链接），而非通过 API 输入。之后，真实邮箱的配置完全可自助且自动完成；只剩我们这边完成邮箱发送授权这一步 — 详见下文的状态。

**总成本核算：**要进行真正的比较，需将邮箱席位、域名（注册和耗损后的替换）、预热、发送平台、抑制名单／取消订阅／合规基础设施以及任何按发送量收取的费用一并计算。上述每月 99 美元涵盖这六项，按发送量收费为 0 美元。对于 5–15 个邮箱的入门／单人使用规模，自行组建一套公平比较的 5 邮箱方案（5 个 Google Workspace 席位，每席位 7 美元 + 每月 39 美元的序列发送工具 + 域名摊销费用，按每个邮箱约 2.50 美元的低端估算），每月约为 76.50–140 美元，尚未计入自行组建和维护所花的时间；直接询价的竞品 Agent 托管方案（Salesforge）总价为每月 112 美元，而本平台为 99 美元。这一结论仅适用于入门／单人使用规模 — 对于代理机构规模（数十个邮箱，服务多个客户），本平台目前按租户计价的方案并不占优，我们不对该规模作出任何优势声明。

28 个工具

工具	功能
setup_infrastructure	购买带有品牌名称的相似域名、配置邮箱，并启动预热
infrastructure_status	查看配置和预热进度、每个邮箱的健康状况以及发送就绪状态（每个邮箱和整个账户各有一个布尔值，不是预计时间）
launch_campaign	针对潜在客户列表创建并启动序列
campaign_results	查看每个营销活动的发送、回复、退信和投诉情况
metrics	查看账户范围的结果总数（sent、reply、bounce、complaint、unsubscribe、failed、soft_bounce）——预热和送达能力健康状况请使用 infrastructure_status
inbox	查看所有邮箱中的统一回复收件箱
thread	查看单个对话串的完整消息历史
reply	在对话串中发送回复（自动在收到回复后停止）
mark	将对话串标记为已读、未读或已归档
pause / pause_all	暂停单个营销活动或该租户的所有营销活动
account	查看用量、账单和配额
remove_mailboxes	降级：立即释放最新的 N 个活跃邮箱，并减少计费数量
get_dashboard	列出或获取租户已保存的仪表板视图（布局 JSON）
configure_dashboard	创建、更新或删除仪表板视图——由 Agent 控制面向用户的仪表板布局
label_thread	为回复对话串设置或清除意向标签（感兴趣、稍后再说、OOO，……）
list_campaigns	列出所有营销活动及其 id、名称、状态和事件计数
activity	查看按时间顺序排列的统一信息流，其中包含营销活动事件和送达能力控制循环操作
get_webhooks	列出出站 Webhook 订阅，或获取单个订阅及其近期投递／尝试日志
configure_webhook	创建、更新或删除出站 Webhook——将回复、退信、软退信、投诉和取消订阅事件（经 HMAC 签名）推送到你自己的 HTTPS 端点
get_byo_domains	列出你自带的域名，或获取某个域名的完整接入详情（预检扫描、滥用判定、同意状态）
configure_byo_domain	注册或推进自带域名的接入流程——注册、轮询 DNS、确认主域名授权、请求平台配置邮箱，或连接你已有凭据的现有邮箱
suppress_lead	在整个租户范围内永久屏蔽一个电子邮件地址——用于处理手动提出的“停止给我发邮件”请求，以补充未被退订文本匹配器识别的退订请求
update_lead	按电子邮件地址记录联系人级别的处理结果（兴趣状态、备注、标签），并在列出该联系人的所有营销活动中显示
list_leads	以游标分页方式列出／导出潜在客户及其联系人级别的处理结果——导出格式为 JSON，没有单独的 CSV 端点
list_messages	以游标分页方式列出系统和操作员消息（设置提示、凭据就绪通知、操作员通知），优先显示未确认消息
ack_message	按 id 确认消息，使其不再作为未确认消息重新显示——具幂等性
contact_operator	联系人工操作员（创建支持工单并发送运维警报）——适用于所有账户状态，包括已暂停状态。回复会通过 list_messages 送达

以上是完整列表——每个工具的设计意图请参阅 coldrig.dev/docs，准确的签名和 HTTP 映射请参阅 AGENTS.md。两个可选的便捷辅助工具（write_sequence、suggest_domains）已完成设计，但尚未构建；它们不属于当前工具列表。

安装

MCP（推荐用于 Claude Code / Codex）：

{
  "mcpServers": {
    "coldrig": {
      "url": "https://api.coldrig.dev/mcp"
    }
  }
}

Codex CLI（~/.codex/config.toml，或受信任项目的 .codex/config.toml——请先设置 COLDRIG_TOKEN）：

[mcp_servers.coldrig]
url = "https://api.coldrig.dev/mcp"
bearer_token_env_var = "COLDRIG_TOKEN"

所有客户端（Claude Code、Cursor、Cline）的配置方式相同，详见 coldrig.dev/connect。

Claude Code 插件 / Agent 技能：

/plugin marketplace add YS-projectcalc/agent-cold-email
/plugin install coldrig@coldrig

启用插件后，它会连接到同一个 coldrig MCP 服务，并提示你输入 bearer token。也可以通过 skills.sh 只安装技能：npx skills add YS-projectcalc/agent-cold-email。Cursor 和 Codex 用户：请参阅 integrations/，其中包含一条 Cursor 规则和一个可粘贴的 AGENTS.md 代码块。

对应的 CLI：

npx agent-cold-email demo

HTTP 门面和托管的 MCP 端点（上文的 /mcp）都已在生产环境上线，地址为 https://api.coldrig.dev——28 个意图均为真实、经过测试的端点，可通过 HTTP 或 MCP 访问（使用相同的工具和按租户隔离的 bearer token 身份验证）。已激活租户可在生产环境中实际发送；未激活和演示租户则使用带故障注入的沙盒供应商层（不会涉及真实域名、邮箱或开支）。CLI 已发布到 npm，包名为 [email protected]——npx agent-cold-email demo 现在即可运行，无需本地构建；该包还包含 agent-cold-email mcp，这是一个 stdio 桥接程序，可连接到同一个托管的 /mcp 端点，供仅支持 stdio 服务的 MCP 客户端使用（参见 packages/cli/README.md）。

**目前可用功能：**这 28 个意图都是真实、经过测试、由 bearer token 保护的 HTTP 端点，已在生产环境 https://api.coldrig.dev 上线；已激活租户可实际发送，未激活或演示租户则使用带故障注入的沙盒供应商层（不会涉及真实域名、邮箱或开支）。任何 HTTP 客户端——包括不支持 MCP / CLI 的 Agent——都可以直接驱动整个工作流。完整的 REST 契约请参阅 coldrig.dev/openapi.yaml，面向 Agent 的使用指南请参阅 AGENTS.md。

首次使用：免费演示

你可以免费查看整个工作流的运行过程：POST /signup 会创建一个 demo 计划的租户（agent-cold-email CLI 的 demo 命令会自动完成此操作，无需手动注册）。该租户在结构上无法访问真实供应商适配器（这一点由类型保护和违规即失败的测试强制保证，而非仅依赖策略约束）——演示模式下的每次域名购买、邮箱创建和发送，都会在带故障注入的沙盒中模拟（包括速率限制、退信、超时和异步回复），因此它的行为与真实环境一致，却完全不花钱，也不会触及真实收件箱。这是人工评估者和正在判断是否推荐此工具的 Agent 安全的首选体验方式。

防护措施与合规

这些机制内置于平台，而非仅仅写在政策中：

• 按租户隔离 — 每个租户的域名、邮箱和数据都存放在各自隔离的状态中；一个租户的滥用行为不会损害其他租户的声誉。
• 抑制名单 + 一键退订（RFC 8058），系统会自动遵守；已退订的地址绝不会再次收到联系。
• 按邮箱设置每日发送上限（约 40–50 封/邮箱/天），由引擎强制执行，而非依赖 Agent 自律。
• 完整的 CAN-SPAM 退出流程 — 在邮件正文中显著提供退出选项，遵守处理时限，且不会出售或转让已抑制的地址。
• 按租户设置实体邮政地址 + 发件人身份（在设置时收集），并注入每封邮件的页脚 — 每位客户都会注册并标明真实发件人身份，而非 EpiphanyMade。
• 投诉率自动暂停 — 当邮箱表现恶化、接近 Gmail 的 0.30% 不合格阈值时，系统会自动限流或暂停。
• 相似域名仅限用于发件人自己的品牌。 相似域名生成器会为你自己的域名生成变体（例如，acme.com → tryacme.com），以规避主域名的声誉风险。在 setup_infrastructure 边界处，会运行服务器端、由代码强制执行的验证器：它会硬性拒绝知名品牌拒绝名单（google、microsoft、apple、paypal、stripe、…）中的品牌，并要求你声明的 brand 与你用于配置的 primaryDomain 相符，确保生成的相似域名始终源自你声明的身份。完整的加密域名所有权验证（DNS/注册商证明）属于激活步骤。这不是钓鱼或冒充工具。
• 如实说明预热，将其描述为持续数周、逐步建立正当发件人声誉的过程，绝不称为“绕过垃圾邮件过滤器”。这里没有魔法，也没有规避过滤器的机制 — 详见 coldrig.dev/docs。

完整的防护措施与滥用模型：coldrig.dev/docs。法律文件（草案，待律师审核）：coldrig.dev/terms、coldrig.dev/privacy、coldrig.dev/aup。

状态

真实邮件发送已与完整沙盒一同在生产环境中运行——这已不再是仅限测试模式的部署。目前：

• ✅ 沙盒化流水线（配置 → 预热 → 发送 → 回复 → 报告）已可正常运行，并通过带故障注入的模拟器完成端到端验证，同时配有自动化测试套件。
• ✅ 覆盖完整 28 种意图的公开 HTTP 接口已在上方的 URL 上线。
• ✅ 托管 MCP 端点（/mcp，通过可流式传输的 HTTP 承载 JSON-RPC 2.0）已上线，提供相同的 28 个工具。
• ✅ 真实发送已在生产环境中上线——2026-07-19，一封真实邮件完成撰写、投递，并经独立 IMAP 验证。
• ✅ 真实出站推送 Webhook（get_webhooks、configure_webhook）——回复、退信、软退信、投诉和取消订阅事件会通过 HMAC 签名发送到你自己的 HTTPS 端点，同时保留现有可轮询的 activity 订阅源。
• ✅ 加速沙盒演示——agent-cold-email CLI 的 demo 命令（已发布到 npm：npx agent-cold-email demo）会自动创建演示租户并驱动完整流水线；底层的 POST /demo/run 会使用该演示租户的 Bearer 令牌运行（通过 POST /signup 获取——无需信用卡或供应商账户）。
• ✅ 可选且可由 Agent 配置的仪表板 + 统一收件箱已在 /app 上线（Agent 可通过仪表板工具控制其布局——参见 coldrig.dev/docs）。
• ✅ Stripe 实时计费已启用——结账使用正式密钥处理，并向真实信用卡扣款；可通过自助方式上线（POST /checkout）。
• 🚧 结账后的真实邮箱配置支持自助操作且会自动完成；邮箱发送授权仍需由我们完成，不会即时完成。
• 🚧 尚无成熟的多年生产运行或送达率记录。

当前详细构建状态和服务可用性：coldrig.dev/status。

**当前状态：**网站已在 coldrig.dev 正式上线，API + 仪表板运行于 Cloudflare Workers；CLI 已发布到 npm（[email protected]，包含 agent-cold-email mcp stdio 桥接模式），MCP 服务也已列入官方 MCP Registry（io.github.YS-projectcalc/agent-cold-email），其中将托管远程端点和 npm 包都列为安装选项。真实收发引擎和 CAN-SPAM 一键退订流程均已通过线上验证——一封真实邮件完成撰写、投递，并经独立 IMAP 验证。Stripe 实时计费使用正式密钥，并向真实信用卡扣款；注册、计费、筛查和真实邮箱配置均可自助完成且自动运行。剩下的唯一一步是邮箱配置后由我们完成发送授权——你无需排队等待，也不需要再做任何操作。

**立即试用——免费沙盒，无需信用卡，无需等候名单：**调用 POST /signup（立即获取令牌），或运行 npx agent-cold-email demo（自动创建租户，无需准备任何内容）。真实发送已上线——确切计费方式请参见 coldrig.dev/pricing，准备上线时，可使用 { mailboxes } 调用 POST /checkout 获取托管 Stripe 付款链接（该字段仅用于生成报价——实际扣款根据你配置的邮箱数量计算）。

了解更多

• 对比 — Coldrig 与自建技术栈、Smartlead、Salesforge、AgentMail、Skyp、FoxReach 和 Maildoso 的对比：基于来源、以数据为先。
• 使用 Claude Code 运行冷邮件业务 — Agent 运营指南的旗舰篇（其中附有 Cursor 和 Codex 版本的链接）。
• 你的 AI Agent 应使用 Coldrig 吗？ — 面向评估中的 Agent 撰写，说明依据、适用性和限制（机器可读的对应文档：agent-evaluation.md）。
• 定价 · 常见问题 · 文档

许可证

MIT — 详见 LICENSE — 适用于此仓库的内容（CLI、MCP 配置、技能、插件、集成）。托管平台（API、引擎、仪表板）为闭源，且不在许可范围内。由 EpiphanyMade 运营。