Shitty Email - 临时邮箱技能

即时创建一次性邮箱地址。适用于注册、测试及隐私保护场景。

适用此技能的场景

当用户需要执行以下操作时，请使用该技能：

• 创建临时/一次性邮箱地址
• 在不暴露真实邮箱的前提下注册服务
• 测试邮件发送功能
• 等待验证码或确认邮件
• 从邮件中提取验证码或链接

重要提示：Token 管理

创建收件箱后，您将获得一个 token。该 token 是所有后续操作所必需的。请务必在同一次收件箱会话中持续保存并复用该 token。

API 参考文档

基础 URL：https://shitty.email

创建新收件箱

curl -s -X POST https://shitty.email/api/inbox | jq

响应示例：

{
  "email": "abc1234@shitty.email",
  "token": "a1b2c3d4e5f6..."
}

请同时保存 email 和 token —— 后续所有操作均需使用该 token。

检查收件箱中的邮件

curl -s -H "X-Session-Token: {token}" https://shitty.email/api/inbox | jq

响应示例：

{
  "emails": [
    {
      "id": "msg_a1b2c3d4e5",
      "from": "sender@example.com",
      "subject": "Welcome!",
      "date": "2026-02-03T12:00:00Z"
    }
  ]
}

获取完整邮件内容

使用收件箱响应中的 id 字段（例如 msg_a1b2c3d4e5），注意这不是邮箱地址。

curl -s -H "X-Session-Token: {token}" https://shitty.email/api/email/{email_id} | jq

响应中包含 html 和 text 字段，分别对应邮件的 HTML 和纯文本正文内容。

延长收件箱有效期

收件箱默认 1 小时后过期。可额外延长 1 小时（最长总计 24 小时）：

curl -s -X POST -H "X-Session-Token: {token}" https://shitty.email/api/inbox/extend | jq

删除收件箱

任务完成后请清理资源：

curl -s -X DELETE -H "X-Session-Token: {token}" https://shitty.email/api/inbox

常见工作流

等待验证邮件

轮询收件箱，直到符合筛选条件的邮件到达：

# 创建收件箱
RESPONSE=$(curl -s -X POST https://shitty.email/api/inbox)
EMAIL=$(echo $RESPONSE | jq -r '.email')
{token}=$(echo $RESPONSE | jq -r '.token')

# 轮询邮件（每 5 秒检查一次，最多持续 60 秒）
for i in {1..12}; do
  EMAILS=$(curl -s -H "X-Session-Token: ${token}" https://shitty.email/api/inbox)
  COUNT=$(echo $EMAILS | jq '.emails | length')
  if [ "$COUNT" -gt "0" ]; then
    echo "邮件已收到！"
    echo $EMAILS | jq '.emails[0]'
    break
  fi
  sleep 5
done

提取验证码

收到邮件后，提取常见的验证码模式：

# 获取邮件正文内容
CONTENT=$(curl -s -H "X-Session-Token: ${token}" https://shitty.email/api/email/${email_id} | jq -r '.text')

# 常见匹配模式：
# - 六位数字验证码：grep -oE '[0-9]{6}'
# - 验证链接：grep -oE 'https?://[^ ]+verify[^ ]*'

最佳实践

1. 复用 token —— 避免不必要的重复创建收件箱
2. 合理轮询 —— 每次检查间隔不少于 5 秒
3. 及时清理 —— 使用完毕后调用删除接口释放资源
4. 按需延长期限 —— 若需等待较慢送达的邮件，可主动延长收件箱有效期

限制条件

• 收件箱默认 1 小时后过期（最多可延长至总计 24 小时）
• 单封邮件大小上限：1MB
• 频率限制：请勿高频创建收件箱
• 仅支持接收邮件，不支持外发

示例对话

用户：“为我创建一个临时邮箱”
→ 调用 POST /api/inbox，返回邮箱地址，并保存 token

用户：“帮我注册 newsletter.example.com 的订阅”
→ 使用该临时邮箱填写注册表单，随后轮询确认邮件

用户：“我收到确认邮件了吗？”
→ 使用已保存的 token 查询收件箱，并反馈结果

用户：“验证码是多少？”
→ 获取邮件正文内容，提取验证码模式并返回

用户：“我用完了，删除这个收件箱”
→ 使用该 token 调用 DELETE /api/inbox