名称： shitty-email
描述： 创建和管理临时的一次性邮箱
emoji: 📧
bins: [curl, jq]
os: [macos, linux, windows]

Shitty Email - 临时邮箱技能

即时创建一次性邮箱地址。非常适合用于注册、测试和保护隐私。

何时使用此技能

当用户需要时，请使用此技能：
- 创建一个临时/一次性邮箱地址
- 注册服务而无需使用真实邮箱
- 测试邮件发送功能
- 等待验证或确认邮件
- 从邮件中提取验证码或链接

重要提示：令牌管理

创建收件箱时，你会收到一个令牌。所有后续操作都需要此令牌。请务必为同一个收件箱会话保存并重复使用此令牌。

API 参考

基础 URL: https://shitty.email

创建新收件箱

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

响应：

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

请同时保存邮箱地址和令牌 - 所有其他操作都需要令牌。

检查收件箱邮件

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 字段，即邮件正文。

延长收件箱有效期

收件箱默认 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')

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

最佳实践

1. 重复使用令牌 - 避免不必要地创建新收件箱
2. 合理轮询 - 每次检查间隔至少 5 秒
3. 及时清理 - 完成后删除收件箱以释放资源
4. 必要时延长 - 如果等待邮件时间较长，请延长收件箱有效期

限制

• 收件箱默认 1 小时后过期（最长可延长至 24 小时）
• 邮件大小限制：1MB
• 存在速率限制：请勿频繁创建收件箱
• 仅支持接收邮件，不支持发送

示例对话

用户："给我创建一个临时邮箱"
→ 调用 POST /api/inbox，返回邮箱地址，并保存令牌

用户："帮我注册 newsletter.example.com"
→ 使用临时邮箱填写注册表单，然后轮询等待确认邮件

用户："我收到确认邮件了吗？"
→ 使用保存的令牌检查收件箱，并报告结果

用户："验证码是什么？"
→ 获取邮件内容，提取验证码模式，并返回

用户："我完成了，删除收件箱吧"
→ 使用令牌调用 DELETE /api/inbox