介绍
# Shitty Email - Temporary Inbox Skill
即时创建一次性电子邮件地址。非常适合注册、测试和保护隐私。
## 何时使用此技能
当用户需要以下情况时使用此技能： - 创建临时/一次性电子邮件地址 - 在不使用真实电子邮件的情况下注册服务 - 测试电子邮件发送功能 - 等待验证或确认电子邮件 - 从电子邮件中提取代码或链接
## 重要：令牌管理
当您创建一个收件箱时，您会收到一个 **令牌 (token)**。此令牌是所有后续操作所必需的。请始终存储并为同一收件箱会话重用该令牌。
## API 参考
Base URL: `https://shitty.email`
### 创建新收件箱
```bash curl -s -X POST https://shitty.email/api/inbox | jq ```
响应： ```json { "email": "[email protected]", "token": "a1b2c3d4e5f6..." } ```
**同时存储电子邮件和令牌** - 您需要令牌来进行所有其他操作。
### 检查收件箱中的电子邮件
```bash curl -s -H "X-Session-Token: {token}" https://shitty.email/api/inbox | jq ```
响应： ```json { "emails": [ { "id": "msg_a1b2c3d4e5", "from": "[email protected]", "subject": "Welcome!", "date": "2026-02-03T12:00:00Z" } ] } ```
### 获取完整电子邮件内容
使用收件箱响应中的 `id` 字段（例如 `msg_a1b2c3d4e5`）。这不是电子邮件地址。
```bash curl -s -H "X-Session-Token: {token}" https://shitty.email/api/email/{email_id} | jq ```
响应包含带有电子邮件正文的 `html` 和 `text` 字段。
### 延长收件箱有效期
收件箱默认在 1 小时后过期。延长 1 小时（最多总共 24 小时）：
```bash curl -s -X POST -H "X-Session-Token: {token}" https://shitty.email/api/inbox/extend | jq ```
### 删除收件箱
完成后进行清理：
```bash curl -s -X DELETE -H "X-Session-Token: {token}" https://shitty.email/api/inbox ```
## 常见工作流
### 等待验证电子邮件
轮询收件箱，直到收到符合条件的电子邮件：
```bash # Create inbox RESPONSE=$(curl -s -X POST https://shitty.email/api/inbox) EMAIL=$(echo $RESPONSE | jq -r '.email') {token}=$(echo $RESPONSE | jq -r '.token')
# Poll for emails (check every 5 seconds, max 60 seconds) 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 "Email received!" echo $EMAILS | jq '.emails[0]' break fi sleep 5 done ```
### 提取验证码
收到电子邮件后，提取常见的验证模式：
```bash # Get email content CONTENT=$(curl -s -H "X-Session-Token: ${token}" https://shitty.email/api/email/${email_id} | jq -r '.text')
# Common patterns to look for: # - 6-digit codes: grep -oE '[0-9]{6}' # - Verification links: grep -oE 'https?://[^ ]+verify[^ ]*' ```
## 最佳实践
1. **重用令牌** - 不要不必要地创建新收件箱 2. **负责任地轮询** - 检查之间等待 5 秒 3. **清理** - 完成后删除收件箱以释放资源 4. **如需则延长** - 如果正在等待慢速电子邮件，请延长收件箱
## 限制
- 收件箱在 1 小时后过期（可延长至最长 24 小时） - 电子邮件大小限制：1MB - 速率限制：不要频繁创建收件箱 - 无外发电子邮件 - 仅接收
## 示例对话
用户：“给我创建一个临时电子邮件” → 调用 POST /api/inbox，返回电子邮件地址，存储令牌
用户：“帮我注册 newsletter.example.com” → 使用临时电子邮件填写注册表单，然后轮询等待确认
用户：“我收到确认了吗？” → 使用存储的令牌检查收件箱，报告结果
用户：“验证码是多少？” → 获取电子邮件内容，提取代码模式，返回它
用户：“我完成了，删除收件箱” → 使用令牌调用 DELETE /api/inbox