Shitty Email - Temporary Inbox Skill
Create disposable email addresses instantly. Perfect for signups, testing, and privacy.
When to Use This Skill
Use this skill when the user needs to:
- - Create a temporary/disposable email address
- Sign up for a service without using their real email
- Test email sending functionality
- Wait for a verification or confirmation email
- Extract codes or links from emails
Important: Token Management
When you create an inbox, you receive a token. This token is required for ALL subsequent operations. Always store and reuse the token for the same inbox session.
API Reference
Base URL: INLINECODE0
Create a New Inbox
CODEBLOCK0
Response:
CODEBLOCK1
Store both the email and token - you need the token for all other operations.
Check Inbox for Emails
CODEBLOCK2
Response:
CODEBLOCK3
Get Full Email Content
Use the id field from the inbox response (e.g. msg_a1b2c3d4e5). This is NOT the email address.
CODEBLOCK4
Response includes html and text fields with the email body.
Extend Inbox Lifetime
Inboxes expire after 1 hour by default. Extend by 1 hour (max 24 hours total):
CODEBLOCK5
Delete Inbox
Clean up when done:
CODEBLOCK6
Common Workflows
Wait for a Verification Email
Poll the inbox until an email matching criteria arrives:
CODEBLOCK7
Extract Verification Code
After receiving an email, extract common verification patterns:
CODEBLOCK8
Best Practices
- 1. Reuse tokens - Don't create new inboxes unnecessarily
- Poll responsibly - Wait 5 seconds between checks
- Clean up - Delete inbox when done to free resources
- Extend if needed - If waiting for slow emails, extend the inbox
Limitations
- - Inboxes expire after 1 hour (extendable to 24 hours max)
- Email size limit: 1MB
- Rate limited: Don't spam inbox creation
- No outbound email - receive only
Example Conversation
User: "Create a temp email for me"
→ Call POST /api/inbox, return the email address, store the token
User: "Sign me up for newsletter.example.com"
→ Use the temp email to fill the signup form, then poll for confirmation
User: "Did I get the confirmation?"
→ Check inbox using stored token, report results
User: "What's the verification code?"
→ Fetch email content, extract the code pattern, return it
User: "I'm done, delete the inbox"
→ Call DELETE /api/inbox with the token
垃圾邮箱 - 临时收件箱技能
即时创建一次性邮箱地址。适用于注册、测试和隐私保护。
何时使用此技能
当用户需要以下操作时使用此技能：
- - 创建临时/一次性邮箱地址
- 在不使用真实邮箱的情况下注册服务
- 测试邮件发送功能
- 等待验证或确认邮件
- 从邮件中提取验证码或链接
重要提示：令牌管理
创建收件箱时，您将收到一个令牌。所有后续操作都需要此令牌。请始终存储并在同一收件箱会话中重复使用该令牌。
API 参考
基础 URL：https://shitty.email
创建新收件箱
bash
curl -s -X POST https://shitty.email/api/inbox | jq
响应：
json
{
email: abc1234@shitty.email,
token: a1b2c3d4e5f6...
}
同时存储邮箱和令牌 - 所有其他操作都需要令牌。
检查收件箱中的邮件
bash
curl -s -H X-Session-Token: {token} https://shitty.email/api/inbox | jq
响应：
json
{
emails: [
{
id: msg_a1b2c3d4e5,
from: sender@example.com,
subject: 欢迎！,
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
创建收件箱
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
提取验证码
收到邮件后，提取常见的验证模式：
bash
获取邮件内容
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. 重复使用令牌 - 不要不必要地创建新收件箱
- 合理轮询 - 每次检查间隔5秒
- 及时清理 - 完成后删除收件箱以释放资源
- 必要时延长 - 如果等待慢速邮件，请延长收件箱有效期
限制说明
- - 收件箱1小时后过期（最长可延长至24小时）
- 邮件大小限制：1MB
- 速率限制：不要频繁创建收件箱
- 仅接收邮件，不支持发送
对话示例
用户：帮我创建一个临时邮箱
→ 调用 POST /api/inbox，返回邮箱地址，存储令牌
用户：帮我注册 newsletter.example.com
→ 使用临时邮箱填写注册表单，然后轮询确认邮件
用户：我收到确认邮件了吗？
→ 使用存储的令牌检查收件箱，报告结果
用户：验证码是什么？
→ 获取邮件内容，提取验证码模式，返回结果
用户：我完成了，删除收件箱
→ 使用令牌调用 DELETE /api/inbox
