Email OTP 技能

一项用于创建临时邮箱地址，并自动从收件箱邮件中提取一次性密码（OTP）验证码及验证链接的技能。使用免费的 mail.tm API（无需 API 密钥）。

适用场景

当用户提出以下请求时，可调用该技能：

• 创建临时邮箱地址
• 为注册/验证获取一次性邮箱
• 检查 OTP（一次性密码）验证码
• 等待邮箱验证链接
• 监控收件箱以获取身份验证代码

快速开始

# 创建新的临时邮箱
python3 scripts/tempmail_otp.py create

# 监控 OTP 验证码（超时 5 分钟）
python3 scripts/tempmail_otp.py check

# 列出当前账号及所有邮件
python3 scripts/tempmail_otp.py list

命令

创建账号

python3 scripts/tempmail_otp.py create [OPTIONS]

选项：

• -e, --email ADDRESS — 自定义完整邮箱地址
• -d, --domain DOMAIN — 指定要使用的域名
• -p, --password PASSWORD — 账号密码（若未指定则自动生成）
• --json — 以 JSON 格式输出

示例：

python3 scripts/tempmail_otp.py create --domain "marcilzo.com"

检查 OTP / 验证链接

python3 scripts/tempmail_otp.py check [OPTIONS]

选项：

• --timeout SECONDS — 最大等待时间（秒），默认值：300
• --poll SECONDS — 轮询间隔（秒），默认值：3
• --sender EMAIL — 仅接受来自该发件人的邮件
• --subject TEXT — 仅接受主题中包含该文本的邮件
• --pattern REGEX — 自定义正则表达式模式用于 OTP 提取
• --once — 找到首个 OTP 后立即退出
• --json — 以 JSON 格式输出邮件内容

示例：

# 最多等待 2 分钟获取 OTP
python3 scripts/tempmail_otp.py check --timeout 120

# 仅接受来自 noreply@example.com 的邮件
python3 scripts/tempmail_otp.py check --sender "noreply@example.com"

# 找到 OTP 后立即退出
python3 scripts/tempmail_otp.py check --once

列出账号与邮件

python3 scripts/tempmail_otp.py list

显示当前账号详情以及收件箱中所有邮件（含已提取的验证链接）。

列出可用域名

python3 scripts/tempmail_otp.py domains [--json]

输出文件

当检测到 OTP 或验证链接时，脚本会自动将其保存至统一状态目录：

• ~/.tempmail_otp/last_otp — 存储最近一次提取的 OTP 验证码
• ~/.tempmail_otp/last_link — 存储首次发现的有效验证链接
• ~/.tempmail_otp/account.json — 账号凭证（JWT token、邮箱地址、密码）

所有状态文件均存储于 ~/.tempmail_otp/ 目录下，并设置严格文件权限（0600）。

OTP 检测模式

脚本自动使用以下模式识别 OTP 验证码：

• 6–8 位数字（最常见）
• 4 位数字
• 格式为 code: XXXXXX
• 格式为 verification: XXXXXX
• 格式为 otp: XXXXXX

链接提取

脚本从邮件 HTML 中提取全部 HTTP/HTTPS 链接，并过滤掉以下类型：

• 退订链接（unsubscribe links）
• 追踪链接（tracking links）
• 图片文件（.png、.jpg、.gif）

状态管理

所有状态信息均集中存储于统一目录：~/.tempmail_otp/

• account.json — 账号凭证与 JWT token（由 create 命令生成）
• last_otp — 最近一次提取的 OTP 验证码（由 check 命令生成）
• last_link — 首次提取的验证链接（由 check 命令生成）

所有文件均设置受限权限（0600）以保障安全性。check 和 list 命令会自动读取已保存的凭证。

设计依据

采用统一状态目录符合 CLI 工具的最佳实践：

1. 避免项目污染 — 不在当前工作目录中创建任何临时文件
2. 位置可预测 — 所有状态集中存放，便于查找与清理
3. 跨会话持久化 — 可在系统任意路径下运行并正常工作
4. 权限安全 — 敏感凭证文件具备恰当的访问控制权限

如需重置全部状态，请执行：rm -rf ~/.tempmail_otp/

典型工作流程

1. 创建账号 — 生成新的临时邮箱地址
2. 使用邮箱 — 在目标服务注册过程中提供该邮箱
3. 监控收件箱 — 运行 check 命令等待 OTP 或验证链接到达
4. 提取验证码 — OTP 将自动显示，并保存至 ~/.tempmail_otp/last_otp
5. 完成验证 — 使用提取的 OTP 或链接完成账户验证流程

示例会话

# 创建临时邮箱
$ python3 scripts/tempmail_otp.py create
Email: a3b7c9d4@marcilzo.com
Password: f8e4d2a1-1234-5678-9abc-123456789abc
Domain: marcilzo.com

Account saved to /home/user/.tempmail_otp/account.json

# 在另一终端中等待 OTP
$ python3 scripts/tempmail_otp.py check --once
Monitoring: a3b7c9d4@marcilzo.com
Timeout: 300s | Poll interval: 3s
--------------------------------------------------

📧 New email from: noreply@service.com
   Subject: Your verification code

✅ OTP FOUND: 842197
OTP saved to /home/user/.tempmail_otp/last_otp
--------------------------------------------------

错误处理

• 若邮箱地址已被占用，脚本将自动重试并生成新用户名
• 网络错误会被记录日志，脚本将继续轮询
• 若账号状态异常，将提示用户重新创建账号

API

本技能使用 mail.tm REST API：

• 基础 URL：https://api.mail.tm
• 认证方式：JWT Bearer token
• 无需 API 密钥

注意事项

• 临时邮箱可能因长时间无活动而过期
• 部分服务可能屏蔽临时邮箱域名
• 脚本自动处理账号创建及 JWT token 管理
• OTP 检测模式覆盖绝大多数常见格式；如需特殊匹配，可通过 --pattern 参数传入自定义正则表达式