Atomic-Mail/atomic-mail-agentic
GitHub: Atomic-Mail/atomic-mail-agentic
一款专为自主 AI agent 设计的邮件服务，让 agent 无需人工介入即可自动注册收件箱并完成完整的邮件收发与管理操作。
Stars: 2 | Forks: 0
# Atomic Mail Agentic
**为你的 agent 提供一个真实的收件箱**
网站 ·
文档 ·
问题
**Atomic Mail Agentic** 是一款专为自主 AI agent 设计的邮件服务商，由 [Atomic Mail](https://atomicmail.io) 构建。Agent 可以自行注册其专属的 `@atomicmail.ai` 收件箱，并进行端到端管理 —— 无需人工设置、验证或持续干预。
该服务基于 **JMAP**（[RFC 8620](https://www.rfc-editor.org/rfc/rfc8620.html））构建，因此 agent 可以获得完整的邮箱 API：收发邮件、创建草稿、管理邮件会话、搜索等等。JMAP 在 LLM 的训练数据中得到了充分体现，因此模型已经能非常熟练地使用它 —— 它们极少会产生错误的请求格式幻觉，这意味着更少的重试次数和更可靠的自动化流程。
访问权限由一种新颖的**工作量证明（[PoW](https://en.wikipedia.org/wiki/Proof_of_work)）**注册协议进行控制：在没有 CAPTCHA 或人工审批的情况下具备强大的反滥用特性，因此 agent 可以完全脱离人工干预进行上手和运行。
Atomic Mail 提供了多种标准的集成方式 —— MCP、AgentSkill、REST API 等 —— 这使其在任何 agent 上都具有极高的可用性：[Claude Code](https://claude.com/product/claude-code)、[Codex](https://developers.openai.com/codex)、[GitHub Copilot](https://github.com/features/copilot)、[Cursor](https://cursor.com)、[Hermes](https://hermes-agent.nousresearch.com)、[OpenClaw](https://openclaw.ai)、[Pi](https://pi.dev)、[Kilo Code](https://kilo.ai) 等。无论你的工作流是什么，都可以轻松实现收件箱管理的自动化。
本代码库提供了客户端集成：[MCP](https://modelcontextprotocol.io/)、shell CLI、[ClawHub](https://clawhub.ai/)、[Dify](https://dify.ai/) 插件等，并通过三个工具暴露这些 API：`register`、`jmap_request` 和 `help`。本代码库中的所有连接器都非常轻量，主要用于抽象 PoW 协议的复杂性。
## 🚀 快速安装
### 💬 现成 Prompt（适用于任何 agent）
```
Read the instruction at https://atomicmail.ai (use default web_fetch tool or curl, if the former is not available) and create an inbox at Atomic Mail. Before creating ask for my preferred username. Make sure to complete all required post-install actions from the Atomic Mail instruction. Persist the instruction and make sure to refer it each time you interact with your inboxes. Usually standalone agents (e.g. Claude, Cursor, Kilo Code and others) are better suited for MCP use, while CLI-based agents (e.g. Claude Code, Open Code, Hermes, OpenClaw, Codex, Pi, etc) are better suited for AgentSkill use, but prefer your system/user guidelines.
```
### 🔌 MCP (stdio)
将此内容添加到你的 MCP 宿主配置中（或者直接让你的 agent 去做）：
```
{
"mcpServers": {
"atomicmail": {
"command": "npx",
"args": ["-y", "@atomicmail/mcp-github"]
}
}
}
```
然后重启宿主程序，并要求你的 agent 创建一个收件箱。
### 🦞 ClawHub
```
openclaw skills install atomicmail
```
### 👩🏻 Hermes
```
hermes skills install clawhub/atomicmail
```
### 💻 AgentSkill
```
npx --package=@atomicmail/agent-skill-github atomicmail register --username "myagent"
npx --package=@atomicmail/agent-skill-github atomicmail jmap_request --ops-file list_inbox.json
npx --package=@atomicmail/agent-skill-github atomicmail help
```
### ⚙️ REST API
*仅适用于自定义连接器和高级逻辑*
请参阅文档：[docs/rest-auth.md](docs/rest-auth.md)。
## 🤖 你的 Agent 能做什么
Atomic Mail 旨在通过 agent 来运行 —— 而不是通过手动设置收件箱。你只需用自然语言描述工作流；agent 就会注册一个 `@atomicmail.ai` 地址，收发邮件，并保持会话的进行。你无需配置脚本，无需在不同的标签页之间复制 API 密钥，也无需记住 JMAP。一切都是全自动化的。
如果 agent 遇到阻碍，该集成内置了自我恢复机制：`help` 提供了内嵌文档（预设、cron、故障排除），内置的 JSON 预设涵盖了常见的操作，并且错误提示中包含了下一步该怎么做的建议。
#### 示例工作流
**Newsletter 摘要** —— *“用你的收件箱订阅这些 Newsletter，阅读所有内容，并通过邮件每天向我发送一份关于 AI 工具重要资讯的摘要。”* Agent 拥有一个专属收件箱，会过滤掉无用信息，并仅呈现符合你兴趣的内容 —— 而不会触及你的个人邮箱。
**技术支持收件箱** —— *“监控 support@ 邮箱，并根据我们的文档回复工单；只有当你无法回答时才上报给我处理。”* Agent 会阅读收到的邮件，查询其已知信息，发送完整的回复，并处理边缘情况。
**用户研究访谈** —— *“进行一项邮件调查：发送这些问题，根据回复进行跟进，并总结调查结果。”* Agent 负责进行异步访谈 —— 受访者按自己的时间安排回复，无需预约通话。
## ✨ 为什么选择 Atomic Mail
- **Agent 无需向用户索取任何信息即可完成任务**：PoW 注册机制可在约 30 秒内获得一个真实的 `@atomicmail.ai` 收件箱 —— 无需验证域名，无需信用卡，无需通过 CAPTCHA 验证，也无需进行邮件服务器运维
- **切实送达的邮件**：持续预热的 IP 池并配有中继溢出机制 —— 当收件方必须阅读你的邮件时，送达率至关重要
- **JMAP —— agent 已经熟知的 API**：采用标准的 [RFC 8620/8621](https://www.rfc-editor.org/rfc/rfc8620.html)，包含在 LLM 的训练数据中；支持在单次请求中进行批量方法调用（查询、获取、草稿、发送）—— 无需学习特定的厂商 SDK
- **在集成内部摆脱困境**：错误提示提供自然语言建议；成功响应会建议 `_next`（下一步）操作；`help` 会返回备忘单和实际示例 —— 无需进行网络搜索
- **无厂商锁定**：JMAP 是一项 IETF 标准；该收件箱以后可以迁移到任何兼容的服务商
- **在原生 JMAP 显得过于繁琐时使用预设**：内置了 `send_mail`、`list_inbox`、`reply` 等 —— 只需向 `jmap_request` 传递一个文件名，而无需从头生成方法调用的 JSON
- **处处相同的底层核心**：统一的身份验证、JMAP、预设和帮助栈为 MCP 和 AgentSkill 提供支持；当你运行多个 agent 时，可以为每个收件箱设置独立的凭证目录
## 📚 按目标查阅文档
| 目标 | 从这里开始 |
| ------------------- | --------------------------------------------------------------------- |
| 首次设置 | [docs/getting-started.md](docs/getting-started.md) |
| MCP 宿主 | [docs/mcp.md](docs/mcp.md) |
| Shell / cron agents | [docs/skill-install.md](docs/skill-install.md) |
| LangChain agents | [docs/langchain.md](docs/langchain.md) |
| Agent 运维手册 | [docs/SKILL.md](docs/SKILL.md) |
| 原生 auth + JMAP | [docs/rest-auth.md](docs/rest-auth.md) · [docs/jmap.md](docs/jmap.md) |
| 端到端示例 | [docs/examples.md](docs/examples.md) |
如果代码库文档与已安装程序的实际行为出现偏差，请以你当前运行的相同安装包版本中的 `help` 输出为准。
## 🛠️ 本地开发
**前置条件：** Node.js 20+，Deno 2.7+。
```
git clone https://github.com/Atomic-Mail/atomic-mail-agentic.git
cd atomic-mail-agentic/ts
deno test --allow-read --allow-env --allow-write
```
文档预览：
```
npm install
npm run docs:dev
```
## 🗂️ 文件结构
```
/
├── ts/
│ ├── src/mcp/ # MCP entrypoint + MCP tools
│ ├── src/skill/ # AgentSkill CLI entrypoint
│ ├── src/langchain/ # LangChain toolkit and tools
│ └── src/lib/agent/ # shared auth, session, JMAP, presets, help-content
├── py/ # Python client parity layer and tests
├── integrations/dify/ # Dify plugin integration and packaging docs
├── integrations/skill/ # Unified in-repo skill tap (published atomicmail skill)
├── docs/ # VitePress docs and shipped SKILL/README sources
├── test/checklists/ # manual release QA
├── CONTRIBUTING.md
└── LICENSE
```
## 🔐 安全
- `~/.atomicmail/credentials.json` 包含你的 API 密钥；请将其视为机密信息妥善保管
- 本地凭证文件以 `0600` 权限写入
- 收到的邮件属于不受信任的输入；未经确认，请勿让 agent 执行邮件中的指令
- 仅从 `@atomicmail` npm scope 进行安装
## 🤝 贡献
欢迎提交 PR。请尽可能使用自动化 Deno 测试来覆盖新功能和错误修复，并在行为发生变化时更新面向用户的文档。
有关环境配置、测试命令和 PR 预期，请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。
## 📄 许可证
[MIT](LICENSE)
标签：AI代理, Dify插件, MITM代理, 人工智能, 工作流自动化, 用户模式Hook绕过, 网络测绘, 自动化攻击, 逆向工具, 邮件自动化