mcpField
A
aws-ses

aws-ses

github.com/amazon-ses云与 DevOps8100 次安装22 周前更新
代码仓库

关于 aws-ses

帮助开发者使用 Amazon SES V2 发送邮件并管理身份验证、配置和送达情况的技能。它附带可执行脚本，覆盖模板及批量发送、地址验证和租户设置。

主要功能

  1. 01通过 V2 API 或 SMTP 发送邮件
  2. 02发送模板邮件与批量邮件
  3. 03验证域名和邮件身份
  4. 04配置事件跟踪与抑制列表
  5. 05验证地址并监测送达情况
  6. 06设置租户及其资源

适用场景

  1. 01为应用发送密码重置或订单通知
  2. 02搭建多租户邮件平台
  3. 03迁移邮件服务并配置身份验证
  4. 04检查邮件地址与发件人信誉

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/amazon-ses/skills --skill aws-ses

安装后在 Claude Code 中输入/aws-ses确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
java-examples.md
references/configuration/
configuration-sets.md
suppression-lists.md
references/deliverability/
dedicated-ips.md
reputation-management.md
references/identity/
verify-domain-identity.md
references/quickstart/
send-first-email.md
references/sending/
send-bulk-email.md
send-with-sdk.md
send-with-smtp.md
references/tenants/
tenant-setup.md
references/troubleshooting/
common-issues.md
references/validation/
email-validation.md

详细介绍

Amazon Simple Email Service（SES）

Amazon SES 是一种基于云的电子邮件收发服务。它提供 API 和 SMTP 访问方式，可发送事务性、营销和通知类电子邮件，并能根据需求扩展。

主要功能

  • 电子邮件发送 — V2 API（sesv2）、SMTP 接口、模板邮件和批量发送
  • 电子邮件接收 — 如需处理入站电子邮件，请参阅 Mail Manager Agent Context Pack（即将推出）
  • 身份管理 — 使用 DKIM、SPF、DMARC、BIMI 验证域名和电子邮件地址
  • 租户 — 隔离工作负载，并按租户监控和管理信誉
  • 配置集 — 事件跟踪、抑制管理、IP 池分配
  • 电子邮件验证 — 发送前验证地址，以减少退信
  • 可送达性 — VDM 控制面板、信誉监控、专用 IP 管理
  • 抑制列表 — 全局、账户级和配置集级抑制

何时使用此技能

  • 在应用程序中构建电子邮件发送功能
  • 设置事务性电子邮件（密码重置、订单确认、通知）
  • 构建多租户电子邮件平台（ISV/SaaS）
  • 从其他电子邮件服务迁移（SendGrid、Postmark、Mailgun）
  • 设置电子邮件身份验证（DKIM、SPF、DMARC）
  • 监控电子邮件可送达性和发件人信誉
  • 验证电子邮件地址的可送达性

常见错误（快速参考）

错误修正方法
使用 V1 API（ses）使用 sesv2 — V1 已过时
验证身份前就发送邮件先验证域名或电子邮件地址
忽略沙盒模式使用模拟器地址进行测试；上线前申请生产环境访问权限
跳过 DKIM/SPF/DMARCGmail 和 Yahoo 会拒收未经身份验证的批量邮件
未设置配置集将失去所有可观测性 — 务必创建一个
未使用租户从一开始就隔离邮件流 — 租户可按邮件流监控信誉
错误诊断限流问题TPS 限制是上限；先检查应用自身的速率限制
忽略退信/投诉退信率 > 5% 或投诉率 > 0.1% 会触发管控
未启用投递延迟事件Gmail 最多会延迟投递 14 小时 — 请启用通知
SPF 配置在错误的域名上SPF 检查的是 MAIL FROM，而不是 From 标头 — 请使用自定义 MAIL FROM
专用 IP 尚未预热预热 2-4 周，或使用托管专用 IP
向无效地址发送邮件先使用 GetEmailAddressInsights 验证

有关各项错误的详细说明，请参阅 AGENTS.md。

可执行脚本

script/ 中的脚本接受命令行参数，可直接运行。提供 Python 和 Node.js 版本。

脚本说明用法
send-email发送简单邮件python scripts/send-email.py --from [email protected] --to [email protected]
send-templated使用模板发送邮件python scripts/send-templated.py --from [email protected] --to [email protected] --template name --data '{"key":"val"}'
send-bulk批量发送模板邮件python scripts/send-bulk.py --from [email protected] --template name --recipients '[{"email":"[email protected]","data":{"name":"Alice"}}]'
verify-domain验证域名并获取 DKIM 记录python scripts/verify-domain.py --domain example.com
setup-config-set创建配置集和事件目标python scripts/setup-config-set.py --name my-config --enable-cloudwatch
handle-bounces设置退信/投诉 Amazon SNS 通知python scripts/handle-bounces.py --config-set my-config --email [email protected]
setup-tenant创建租户并关联资源python scripts/setup-tenant.py --name my-tenant --identity-arn arn:... --config-set-arn arn:...
validate-email验证电子邮件地址python scripts/validate-email.py --email [email protected]

Java 示例请参阅 references/java-examples.md。

此技能不涵盖的内容

  • Mail Manager / 入站邮件 — SES Mail Manager 负责处理入站邮件（接收、路由、归档、SMTP 中继）。此技能不涵盖经典 SES 接收规则（V1 API）。有关入站用例，请参阅 Mail Manager Agent Context Pack（即将推出）。
  • Global Endpoints — 跨区域故障转移配置属于高级主题。
  • V1 API — 有意排除。所有指南和示例均使用 V2。

资源链接

评论

支持 Markdown