⚠️

重要前提

安装AI Skills的关键前提是：必须科学上网，且开启TUN模式，这一点至关重要，直接决定安装能否顺利完成，在此郑重提醒三遍：科学上网，科学上网，科学上网。查看完整安装教程 →

Mailsac API 使用指南：临时邮箱管理、邮件测试与自动化验证

mailsac by vm0-ai/vm0-skills

64 周安装量

48 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/vm0-ai/vm0-skills --skill mailsac

自动化测试 API

🇨🇳中文介绍

Mailsac

通过直接使用 curl 命令调用 Mailsac API，管理用于测试和QA自动化的临时电子邮件地址。

官方文档：https://docs.mailsac.com/

使用场景

在以下场景中使用此技能：

在临时收件箱中接收测试邮件
验证电子邮件地址（检查格式和临时地址状态）
在端到端测试中自动化邮件验证流程
配置Webhook以实现实时邮件通知
为测试管理私有电子邮件地址

先决条件

在 https://mailsac.com/ 注册
从仪表板获取你的API密钥（账户 > API密钥）

export MAILSAC_API_KEY="your-api-key"

使用方法

以下所有示例均假设你已设置 MAILSAC_API_KEY 环境变量。

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

1. 消息 - 读取邮件

从任意收件箱检索和读取邮件。

列出收件箱中的消息

curl -s "https://mailsac.com/api/addresses/test@mailsac.com/messages" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" | jq .

读取消息内容（纯文本）

将 <message-id> 替换为列表中实际的 messageId：

curl -s "https://mailsac.com/api/text/test@mailsac.com/<message-id>" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)"

读取消息内容（HTML）

curl -s "https://mailsac.com/api/body/test@mailsac.com/<message-id>" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)"

获取原始SMTP消息（包含头部和附件）

curl -s "https://mailsac.com/api/raw/test@mailsac.com/<message-id>" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)"

以JSON格式获取消息头部

curl -s "https://mailsac.com/api/headers/test@mailsac.com/<message-id>" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" | jq .

消息格式端点：

端点	描述
`/api/text/{email}/{messageId}`	纯文本正文
`/api/body/{email}/{messageId}`	经过清理的HTML正文
`/api/dirty/{email}/{messageId}`	未经清理的HTML（包含内联图片）
`/api/raw/{email}/{messageId}`	完整的SMTP消息
`/api/headers/{email}/{messageId}`	JSON格式的头部信息

删除单条消息或清空整个收件箱。

curl -s -X DELETE "https://mailsac.com/api/addresses/test@mailsac.com/messages/<message-id>" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)"

清空整个收件箱（仅限增强地址）

curl -s -X DELETE "https://mailsac.com/api/addresses/test@mailsac.com/messages" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)"

注意：已加星标的消息不会被清空。如果你想删除所有内容，请先取消星标。

删除自定义域名下的所有消息

curl -s -X PUT "https://mailsac.com/api/domains/yourdomain.com/delete-all-domain-mail" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)"

3. 私有地址 - 预留和释放

管理供独占使用的私有电子邮件地址。

预留一个私有地址

curl -s -X POST "https://mailsac.com/api/addresses/mytest@mailsac.com" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" | jq .

{
  "_id": "mytest@mailsac.com",
  "owner": "your-username",
  "forward": null,
  "webhook": null,
  "webhookSlack": null,
  "enablews": false,
  "created": "2024-01-01T00:00:00.000Z",
  "updated": "2024-01-01T00:00:00.000Z"
}

列出你的私有地址

curl -s "https://mailsac.com/api/addresses" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" | jq .

释放一个私有地址

curl -s -X DELETE "https://mailsac.com/api/addresses/mytest@mailsac.com" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)"

释放地址并删除所有消息

curl -s -X DELETE "https://mailsac.com/api/addresses/mytest@mailsac.com?deleteAddressMessages=true" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)"

配置Webhook以实时接收邮件通知。

为私有地址设置Webhook

写入 /tmp/mailsac_webhook.json：

{
  "webhook": "https://your-server.com/email-webhook"
}

curl -s -X PUT "https://mailsac.com/api/private-address-forwarding/mytest@mailsac.com" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" --header "Content-Type: application/json" -d @/tmp/mailsac_webhook.json | jq .

写入 /tmp/mailsac_webhook.json：

curl -s -X PUT "https://mailsac.com/api/private-address-forwarding/mytest@mailsac.com" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" --header "Content-Type: application/json" -d @/tmp/mailsac_webhook.json | jq .

Webhook 负载格式：

{
  "text": "Email body content",
  "subject": "Email subject",
  "from": [{"address": "sender@example.com", "name": "Sender Name"}],
  "to": [{"address": "recipient@mailsac.com", "name": ""}],
  "headers": {},
  "messageId": "unique-message-id",
  "date": "2024-01-01T00:00:00.000Z",
  "receivedDate": "2024-01-01T00:00:00.000Z",
  "raw": "Full RFC-formatted email"
}

5. 电子邮件验证

验证电子邮件地址并检测临时邮件服务。

验证单个电子邮件

curl -s "https://mailsac.com/api/validations/addresses/test@example.com" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" | jq .

{
  "email": "test@example.com",
  "isValidFormat": true,
  "isDisposable": false,
  "disposableDomains": [],
  "aliases": [],
  "domain": "example.com",
  "local": "test"
}

检查电子邮件是否为临时地址

curl -s "https://mailsac.com/api/validations/addresses/test@mailsac.com" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" | jq '{email, isDisposable}'

验证响应字段：

字段	描述
`isValidFormat`	电子邮件语法有效
`isDisposable`	电子邮件来自临时服务
`disposableDomains`	已识别的临时域名列表
`aliases`	域名别名和IP地址
`domain`	电子邮件的域名部分
`local`	电子邮件的本地部分

6. 发送邮件（外发）

通过API发送邮件（需要外发消息额度）。

写入 /tmp/mailsac_outgoing.json：

{
  "to": "recipient@example.com",
  "from": "sender@mailsac.com",
  "subject": "Test Email",
  "text": "This is the email body content."
}

curl -s -X POST "https://mailsac.com/api/outgoing-messages" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" --header "Content-Type: application/json" -d @/tmp/mailsac_outgoing.json | jq .

注意：发送邮件需要购买额度，除非是在你的自定义域名内发送。

从接收的邮件中下载附件。

通过MD5哈希获取附件

curl -s "https://mailsac.com/api/addresses/test@mailsac.com/messages/<message-id>/attachments/<attachment-md5>" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" > attachment.bin

获取原始消息并解析附件

curl -s "https://mailsac.com/api/raw/test@mailsac.com/<message-id>" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" > message.eml

注意：对于公共地址，附件必须通过API下载；它们在网站上不可见。

8. 星标/保存消息

通过为消息加星标来防止其被自动删除。

curl -s -X PUT "https://mailsac.com/api/addresses/test@mailsac.com/messages/<message-id>/star" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" | jq .

等待邮件并提取验证码

EMAIL="test-$(date +%s)@mailsac.com"
echo "Use this email for registration: $EMAIL"

# 轮询新消息（每5秒检查一次，最多60秒）
for i in $(seq 1 12); do
  MESSAGES=$(curl -s "https://mailsac.com/api/addresses/$EMAIL/messages" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)")
  COUNT=$(echo "$MESSAGES" | jq 'length')
  if [ "$COUNT" -gt "0" ]; then
    MESSAGE_ID=$(echo "$MESSAGES" | jq -r '.[0]._id')
    echo "Message received: $MESSAGE_ID"
    curl -s "https://mailsac.com/api/text/$EMAIL/$MESSAGE_ID" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)"
    break
  fi
  echo "Waiting for email... ($i/12)"
  sleep 5
done

列出最近的消息（包含主题和发件人）

curl -s "https://mailsac.com/api/addresses/test@mailsac.com/messages" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" | jq '.[] | {subject, from: .from[0].address, received: .received}'

在测试前清理测试收件箱

curl -s -X DELETE "https://mailsac.com/api/addresses/test@mailsac.com/messages" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)"
echo "Inbox purged"

检查邮件服务是否为临时服务

curl -s "https://mailsac.com/api/validations/addresses/user@tempmail.com" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" | jq 'if .isDisposable then "DISPOSABLE" else "LEGITIMATE" end'

[
  {
    "_id": "message-id-here",
    "from": [{"address": "sender@example.com", "name": "Sender"}],
    "to": [{"address": "test@mailsac.com", "name": ""}],
    "subject": "Email Subject",
    "received": "2024-01-01T00:00:00.000Z",
    "size": 1234,
    "attachments": []
  }
]

{
  "email": "test@mailsac.com",
  "isValidFormat": true,
  "isDisposable": true,
  "disposableDomains": ["mailsac.com"],
  "aliases": ["104.197.186.12"],
  "domain": "mailsac.com",
  "local": "test"
}

类型	限制
公共地址消息保留时间	4天
公共收件箱最大消息数	6
最大消息大小	2.5 MB
操作配额重置时间	每月1日（UTC）

公共 vs 私有：公共地址任何人都可以访问；对于敏感测试数据请使用私有地址
已加星标的消息：为重要消息加星标以防止自动删除
速率限制：免费账户可能会遇到限流；付费计划有更高的限制
Webhook可靠性：查看“最近活动”页面进行Webhook调试
附件安全性：出于安全原因，公共地址上的附件需要API访问权限
操作计数：列出消息 + 读取内容 = 2次API操作

🇺🇸English

Mailsac

Use the Mailsac API via direct curl calls to manage disposable email addresses for testing and QA automation.

Official docs: https://docs.mailsac.com/

When to Use

Use this skill when you need to:

Receive test emails in disposable inboxes
Validate email addresses (check format and disposable status)
Automate email verification flows in E2E tests
Configure webhooks for real-time email notifications
Manage private email addresses for testing

Prerequisites

Sign up at https://mailsac.com/
Get your API key from the dashboard (Account > API Key)

export MAILSAC_API_KEY="your-api-key"

How to Use

All examples below assume you have MAILSAC_API_KEY set.

Base URL: https://mailsac.com

1. Messages - Read Emails

Retrieve and read emails from any inbox.

List Messages in Inbox

curl -s "https://mailsac.com/api/addresses/test@mailsac.com/messages" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" | jq .

Read Message Content (Plain Text)

Replace <message-id> with the actual messageId from the list:

curl -s "https://mailsac.com/api/text/test@mailsac.com/<message-id>" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)"

Read Message Content (HTML)

curl -s "https://mailsac.com/api/body/test@mailsac.com/<message-id>" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)"

Get Raw SMTP Message (with headers and attachments)

curl -s "https://mailsac.com/api/raw/test@mailsac.com/<message-id>" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)"

Get Message Headers as JSON

curl -s "https://mailsac.com/api/headers/test@mailsac.com/<message-id>" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" | jq .

Message Format Endpoints:

Endpoint	Description
`/api/text/{email}/{messageId}`	Plain text body
`/api/body/{email}/{messageId}`	Sanitized HTML body
`/api/dirty/{email}/{messageId}`	Unsanitized HTML with inlined images
`/api/raw/{email}/{messageId}`	Complete SMTP message
`/api/headers/{email}/{messageId}`	JSON headers

2. Messages - Delete

Delete single messages or purge entire inboxes.

Delete Single Message

curl -s -X DELETE "https://mailsac.com/api/addresses/test@mailsac.com/messages/<message-id>" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)"

Purge Entire Inbox (Enhanced Address only)

curl -s -X DELETE "https://mailsac.com/api/addresses/test@mailsac.com/messages" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)"

Note: Starred messages will NOT be purged. Unstar them first if you want to delete everything.

Delete All Messages in Custom Domain

curl -s -X PUT "https://mailsac.com/api/domains/yourdomain.com/delete-all-domain-mail" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)"

3. Private Addresses - Reserve and Release

Manage private email addresses for exclusive use.

Reserve a Private Address

curl -s -X POST "https://mailsac.com/api/addresses/mytest@mailsac.com" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" | jq .

Response:

{
  "_id": "mytest@mailsac.com",
  "owner": "your-username",
  "forward": null,
  "webhook": null,
  "webhookSlack": null,
  "enablews": false,
  "created": "2024-01-01T00:00:00.000Z",
  "updated": "2024-01-01T00:00:00.000Z"
}

List Your Private Addresses

curl -s "https://mailsac.com/api/addresses" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" | jq .

Release a Private Address

curl -s -X DELETE "https://mailsac.com/api/addresses/mytest@mailsac.com" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)"

Release Address and Delete All Messages

curl -s -X DELETE "https://mailsac.com/api/addresses/mytest@mailsac.com?deleteAddressMessages=true" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)"

4. Webhook Forwarding

Configure webhooks to receive email notifications in real-time.

Set Webhook for Private Address

Write to /tmp/mailsac_webhook.json:

{
  "webhook": "https://your-server.com/email-webhook"
}

Then run:

curl -s -X PUT "https://mailsac.com/api/private-address-forwarding/mytest@mailsac.com" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" --header "Content-Type: application/json" -d @/tmp/mailsac_webhook.json | jq .

Remove Webhook

Write to /tmp/mailsac_webhook.json:

{
  "webhook": ""
}

Then run:

curl -s -X PUT "https://mailsac.com/api/private-address-forwarding/mytest@mailsac.com" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" --header "Content-Type: application/json" -d @/tmp/mailsac_webhook.json | jq .

Webhook Payload Format:

{
  "text": "Email body content",
  "subject": "Email subject",
  "from": [{"address": "sender@example.com", "name": "Sender Name"}],
  "to": [{"address": "recipient@mailsac.com", "name": ""}],
  "headers": {},
  "messageId": "unique-message-id",
  "date": "2024-01-01T00:00:00.000Z",
  "receivedDate": "2024-01-01T00:00:00.000Z",
  "raw": "Full RFC-formatted email"
}

5. Email Validation

Validate email addresses and detect disposable email services.

Validate Single Email

curl -s "https://mailsac.com/api/validations/addresses/test@example.com" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" | jq .

Response:

{
  "email": "test@example.com",
  "isValidFormat": true,
  "isDisposable": false,
  "disposableDomains": [],
  "aliases": [],
  "domain": "example.com",
  "local": "test"
}

Check if Email is Disposable

curl -s "https://mailsac.com/api/validations/addresses/test@mailsac.com" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" | jq '{email, isDisposable}'

Validation Response Fields:

Field	Description
`isValidFormat`	Email syntax is valid
`isDisposable`	Email is from a disposable service
`disposableDomains`	List of identified disposable domains
`aliases`	Domain aliases and IP addresses
`domain`	Domain part of email
`local`	Local part of email

6. Send Email (Outgoing)

Send emails via API (requires outgoing message credits).

Write to /tmp/mailsac_outgoing.json:

{
  "to": "recipient@example.com",
  "from": "sender@mailsac.com",
  "subject": "Test Email",
  "text": "This is the email body content."
}

Then run:

curl -s -X POST "https://mailsac.com/api/outgoing-messages" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" --header "Content-Type: application/json" -d @/tmp/mailsac_outgoing.json | jq .

Note: Sending requires purchased credits unless sending within your custom domain.

7. Attachments

Download attachments from received emails.

Get Attachment by MD5 Hash

curl -s "https://mailsac.com/api/addresses/test@mailsac.com/messages/<message-id>/attachments/<attachment-md5>" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" > attachment.bin

Get Raw Message and Parse Attachments

curl -s "https://mailsac.com/api/raw/test@mailsac.com/<message-id>" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" > message.eml

Note: For public addresses, attachments must be downloaded via API; they are not viewable on the website.

8. Star/Save Messages

Prevent messages from being auto-deleted by starring them.

Star a Message

curl -s -X PUT "https://mailsac.com/api/addresses/test@mailsac.com/messages/<message-id>/star" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" | jq .

Practical Examples

Wait for Email and Extract Verification Code

EMAIL="test-$(date +%s)@mailsac.com"
echo "Use this email for registration: $EMAIL"

# Poll for new message (check every 5 seconds, max 60 seconds)
for i in $(seq 1 12); do
  MESSAGES=$(curl -s "https://mailsac.com/api/addresses/$EMAIL/messages" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)")
  COUNT=$(echo "$MESSAGES" | jq 'length')
  if [ "$COUNT" -gt "0" ]; then
    MESSAGE_ID=$(echo "$MESSAGES" | jq -r '.[0]._id')
    echo "Message received: $MESSAGE_ID"
    curl -s "https://mailsac.com/api/text/$EMAIL/$MESSAGE_ID" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)"
    break
  fi
  echo "Waiting for email... ($i/12)"
  sleep 5
done

List Recent Messages with Subject and Sender

curl -s "https://mailsac.com/api/addresses/test@mailsac.com/messages" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" | jq '.[] | {subject, from: .from[0].address, received: .received}'

Clean Up Test Inbox Before Tests

curl -s -X DELETE "https://mailsac.com/api/addresses/test@mailsac.com/messages" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)"
echo "Inbox purged"

Check if Email Service is Disposable

curl -s "https://mailsac.com/api/validations/addresses/user@tempmail.com" --header "Mailsac-Key: $(printenv MAILSAC_API_KEY)" | jq 'if .isDisposable then "DISPOSABLE" else "LEGITIMATE" end'

Response Format

Message List Response

[
  {
    "_id": "message-id-here",
    "from": [{"address": "sender@example.com", "name": "Sender"}],
    "to": [{"address": "test@mailsac.com", "name": ""}],
    "subject": "Email Subject",
    "received": "2024-01-01T00:00:00.000Z",
    "size": 1234,
    "attachments": []
  }
]

Validation Response

{
  "email": "test@mailsac.com",
  "isValidFormat": true,
  "isDisposable": true,
  "disposableDomains": ["mailsac.com"],
  "aliases": ["104.197.186.12"],
  "domain": "mailsac.com",
  "local": "test"
}

Limits and Quotas

Type	Limit
Public address message retention	4 days
Public inbox max messages	6
Max message size	2.5 MB
Operations quota reset	1st of each month (UTC)

Guidelines

Public vs Private : Public addresses are accessible by anyone; use private addresses for sensitive test data
Starred messages : Star important messages to prevent auto-deletion
Rate limits : Free accounts may experience throttling; paid plans have higher limits
Webhook reliability : Check Recent Activity page for webhook debugging
Attachments security : For security reasons, attachments on public addresses require API access
Operations count : Listing messages + reading content = 2 API operations

Weekly Installs

Repository

vm0-ai/vm0-skills

GitHub Stars

First Seen

Jan 24, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

opencode55

gemini-cli55

cursor53

codex53

cline52

github-copilot52

通过 LiteLLM 代理让 Claude Code 对接 GitHub Copilot 运行 | 高级变通方案指南

48,700 周安装

Mailsac API 使用指南：临时邮箱管理、邮件测试与自动化验证

🇨🇳中文介绍

Mailsac

使用场景

先决条件

使用方法

相关 Skills

1. 消息 - 读取邮件

列出收件箱中的消息

读取消息内容（纯文本）

读取消息内容（HTML）

获取原始SMTP消息（包含头部和附件）

以JSON格式获取消息头部

2. 消息 - 删除

删除单条消息

清空整个收件箱（仅限增强地址）

删除自定义域名下的所有消息

3. 私有地址 - 预留和释放

预留一个私有地址

列出你的私有地址

释放一个私有地址

释放地址并删除所有消息

4. Webhook 转发

为私有地址设置Webhook

移除Webhook

5. 电子邮件验证

验证单个电子邮件

检查电子邮件是否为临时地址

6. 发送邮件（外发）

7. 附件

通过MD5哈希获取附件

获取原始消息并解析附件

8. 星标/保存消息

为消息加星标

实用示例

等待邮件并提取验证码

列出最近的消息（包含主题和发件人）

在测试前清理测试收件箱

检查邮件服务是否为临时服务

响应格式

消息列表响应

验证响应

限制与配额

指南

🇺🇸English

Mailsac

When to Use

Prerequisites

How to Use

1. Messages - Read Emails

List Messages in Inbox

Read Message Content (Plain Text)

Read Message Content (HTML)

Get Raw SMTP Message (with headers and attachments)

Get Message Headers as JSON

2. Messages - Delete

Delete Single Message

Purge Entire Inbox (Enhanced Address only)

Delete All Messages in Custom Domain

3. Private Addresses - Reserve and Release

Reserve a Private Address

List Your Private Addresses

Release a Private Address

Release Address and Delete All Messages

4. Webhook Forwarding

Set Webhook for Private Address

Remove Webhook

5. Email Validation

Validate Single Email

Check if Email is Disposable

6. Send Email (Outgoing)

7. Attachments

Get Attachment by MD5 Hash

Get Raw Message and Parse Attachments

8. Star/Save Messages

Star a Message

Practical Examples

Wait for Email and Extract Verification Code

List Recent Messages with Subject and Sender

Clean Up Test Inbox Before Tests