# Smtp Send

> Send emails via SMTP or Resend API with support for plain text, HTML, and attachments. Use when the user asks to send an email, email someone, or compose and send a message. Supports single recipients and can include file attachments. Works with Gmail, Outlook, Yahoo, QQ Mail, 163 Mail, Resend, and any SMTP server.

- Skill: `modbender/smtp-send` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add modbender/smtp-send`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/smtp-send/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/smtp-send

---


# Email Send

发送邮件，支持 SMTP 和 Resend API 两种方式。

## 🚀 快速使用

```bash
# 发送简单邮件
python3 scripts/send_email.py \
  --to recipient@example.com \
  --subject "Meeting Tomorrow" \
  --body "Hi, let's meet at 2pm tomorrow."

# 发送 HTML 邮件
python3 scripts/send_email.py \
  --to recipient@example.com \
  --subject "Weekly Report" \
  --body "<h1>Report</h1><p>Here are the updates...</p>" \
  --html

# 发送带附件的邮件
python3 scripts/send_email.py \
  --to recipient@example.com \
  --subject "Documents" \
  --body "Please find the attached files." \
  --attachments report.pdf,data.csv

# 指定使用 Resend
python3 scripts/send_email.py \
  --to recipient@example.com \
  --subject "Test" \
  --body "Hello" \
  --provider resend
```

## ⚙️ 配置

在 `~/.smtp_config` 中配置（二选一或两个都配）：

### 方式 1: Resend API（推荐，更简单）

```json
{
    "resend_api_key": "re_xxxxx",
    "resend_from": "you@your-domain.com"
}
```

获取 API key: https://resend.com

**注意**：免费账户只能发给注册邮箱，要发给其他人需要验证域名。

### 方式 2: SMTP（163/QQ/Gmail 等）

```json
{
    "host": "smtp.163.com",
    "port": 465,
    "user": "your-email@163.com",
    "password": "your-auth-code",
    "from": "your-email@163.com",
    "use_ssl": true
}
```

### 两个都配（自动 fallback）

```json
{
    "resend_api_key": "re_xxxxx",
    "resend_from": "you@your-domain.com",
    "host": "smtp.163.com",
    "port": 465,
    "user": "your-email@163.com",
    "password": "your-auth-code",
    "from": "your-email@163.com",
    "use_ssl": true
}
```

配置完后设置权限：
```bash
chmod 600 ~/.smtp_config
```

## 📋 参数

| 参数 | 必填 | 说明 |
|------|------|------|
| `--to` | ✅ | 收件人邮箱 |
| `--subject` | ✅ | 邮件标题 |
| `--body` | ✅ | 邮件内容 |
| `--html` | ❌ | 以 HTML 格式发送 |
| `--attachments` | ❌ | 附件路径，多个用逗号分隔 |
| `--provider` | ❌ | `auto`/`smtp`/`resend`（默认 auto） |

## 🔄 Provider 选择逻辑

- `auto`（默认）：优先 Resend，失败则 fallback 到 SMTP
- `smtp`：强制使用 SMTP
- `resend`：强制使用 Resend API

## 📧 常见 SMTP 配置

| 邮箱 | Host | Port | SSL |
|------|------|------|-----|
| 163 | smtp.163.com | 465 | true |
| QQ | smtp.qq.com | 465 | true |
| Gmail | smtp.gmail.com | 587 | false |
| Outlook | smtp.office365.com | 587 | false |

**注意**：163/QQ/Gmail 都需要使用授权码而非登录密码。

## 🔐 安全

- 凭据存储在 `~/.smtp_config`，权限应设为 600
- API key 和密码不会出现在命令行参数中
- 配置文件不应提交到版本控制

## 🐛 常见问题

**认证失败**：检查授权码是否正确，是否开启了 SMTP 服务

**Resend 403**：免费账户只能发给注册邮箱，需要验证域名才能发给其他人

**连接超时**：检查网络，或者端口是否被防火墙拦截