temp-mail 是一个基于 Python 的命令行工具，通过调用 Vortex API 提供一次性邮箱（Temp Mail）的完整生命周期管理。它专为开发、测试或临时注册场景设计，能够快速生成随机邮箱地址，并实时获取、轮询和清理该地址收到的邮件内容。该工具支持多种域名选择，默认使用 skyfall.dev 等可信公共实例，确保生成的邮箱具备真实收件能力。用户可通过简单的命令行操作完成从创建到清理的全流程，无需依赖图形界面或复杂配置。其轻量级架构采用 uv 作为运行方式，自动处理虚拟环境，极大提升了使用便捷性。此外，脚本内部实现了与前端一致的随机用户名生成逻辑，保证行为一致性。整体而言，temp-mail 为开发者提供了一个高效、可靠且易于集成的临时邮箱解决方案。
核心功能特点
- 一键生成随机一次性邮箱地址，支持自定义域名
- 实时查询指定邮箱的未读邮件列表
- 支持轮询机制，可等待新邮件到达或设置超时
- 提供清空指定邮箱所有邮件的功能
- 基于 httpx 实现稳定 HTTP 请求，兼容主流操作系统
- 使用 uv 运行时自动隔离依赖，避免环境冲突
适用场景
temp-mail 特别适合在需要临时邮箱但又不希望暴露真实邮箱的场景下使用。例如，在网站注册测试、自动化脚本验证、API 接口调试或安全测试中，开发者可以快速创建一个匿名邮箱用于接收验证码或确认邮件，从而保护个人隐私。对于 QA 团队来说，该工具可用于模拟新用户注册流程，批量生成多个临时账号进行功能回归测试。在开发阶段，当第三方服务要求绑定邮箱进行回调验证时，使用 temp-mail 可避免污染生产数据库或触发反垃圾邮件机制。此外，由于其命令行特性，它也能轻松集成到 CI/CD 流水线中，实现无人值守的测试账户创建与数据清理。无论是独立开发者还是企业级应用，都能从中获得高效、安全的临时通信支持。