ShellMail 是一款专为 AI 代理设计的电子邮件 API 服务，旨在为自动化流程提供便捷的邮件收发能力。通过简单的命令行工具与 RESTful API 接口，开发者可以轻松创建专属邮箱地址、接收邮件、自动提取验证码（OTP），并对收件箱进行搜索与管理。该服务特别适合需要模拟用户注册、验证或通信行为的 AI 应用场景，例如自动化测试、账户注册流程或身份验证环节。使用 ShellMail，AI 代理无需依赖传统邮箱客户端，即可高效处理与外部系统的邮件交互。 首次配置时，系统会引导用户生成唯一的邮箱地址（可自定义名称或使用随机生成），并通过 recovery email 完成账户绑定。随后，用户需将生成的访问令牌（SHELLMAIL_TOKEN）保存至代理配置中，以实现持久化访问权限。这一过程虽涉及敏感信息，但设计初衷是为了让 AI 在长期运行中持续监控指定邮箱，而无需反复手动授权。值得注意的是，该令牌拥有对收件箱的完全控制权，包括读取所有邮件和提取一次性密码，因此建议仅用于可信场景，并配合良好的安全实践，如使用临时邮箱或定期撤销访问权限。 ShellMail 提供了丰富的命令接口，支持检查未读邮件、读取特定邮件内容、等待并捕获 OTP 验证码，以及按发件人、关键词或是否包含验证码等条件进行邮件搜索。此外，还支持标记已读、归档和删除邮件等功能，便于构建灵活的自动化工作流。其底层 API 基于 HTTPS，采用 Bearer Token 认证机制，确保通信安全性。整体架构简洁高效，适合集成到各类 AI 代理系统中，作为其与外部服务进行异步通信的关键组件。
核心功能特点
- 支持创建专属邮箱地址，可用于 AI 代理的身份模拟与注册验证
- 自动检测并提取邮件中的 OTP 验证码，支持按发件人和超时时间过滤
- 提供完整的收件箱管理功能，包括查看未读邮件、搜索特定内容、标记已读或删除邮件
- 通过命令行工具和 RESTful API 实现无缝集成，易于嵌入自动化脚本和代理系统
- 使用 recovery email 保障账户恢复能力，支持在丢失访问时重新获取令牌
- 具备健康状态检查接口，便于监控系统运行状况与连接稳定性
适用场景
ShellMail 最典型的应用场景是 AI 代理在执行需要真实邮箱交互的任务时，例如批量注册新账号、参与在线服务验证或监控第三方通知。想象一个自动化机器人负责在多个平台注册试用账户，它可以通过 ShellMail 创建独立邮箱地址，接收各平台发送的确认邮件和验证码，并自动提取 OTP 完成登录流程。这种场景下，ShellMail 不仅能提升效率，还能避免因频繁使用同一邮箱导致被识别为机器行为的风险。 另一个常见用途是在开发或测试环境中模拟用户行为。例如，当某个 SaaS 产品要求通过邮箱激活账户时，QA 团队可以利用 ShellMail 快速生成临时邮箱，触发激活链接，并在几秒内完成整个注册-验证闭环，大幅缩短测试周期。此外，对于需要与 GitHub、Stripe、Slack 等服务集成的 CI/CD 流水线，ShellMail 可作为可靠的中间层，接收 webhook 通知或验证邮件，使自动化部署更加智能和响应及时。 在企业级应用中，ShellMail 还可用于构建客服工单系统或内部通知机制。AI 客服助手可通过监听特定邮箱来接收客户反馈或系统警报，并根据邮件内容自动分类和处理。由于 ShellMail 支持按关键词或发件人精准搜索，因此即使在高并发环境下也能快速定位关键信息。同时，结合其安全策略（如仅授权必要权限、支持随时撤销访问），企业可以在享受自动化便利的同时，有效控制数据暴露面，确保符合隐私合规要求。