Agent Skills
返回列表
💻

Mailgun 邮件投递 JavaScript SDK

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/mailgun-javascript-sdk-email-delivery-and-domain-operations。

技能介绍

要解决什么问题

在 Agent 或自动化脚本里发事务邮件、查投递状态、做域名相关配置时，直接拼 Mailgun REST API 容易踩坑：认证头、multipart 表单、以及 v3 起强制使用的 FormData 等细节都会分散业务逻辑。Mailgun 官方维护的 mailgun.js 已经把这些封装成 Node.js（及部分浏览器）可用的客户端，本技能把该 SDK 的用法整理成 Agent 可执行的 ASE 工作流。

技能如何工作

技能围绕 官方 Mailgun JavaScript SDK 组织任务，典型能力包括：

  • 事务邮件发送：通过 new Mailgun(formData) 实例化客户端，再用 mailgun.client 配置 Basic Auth（用户名 api、密钥为 Mailgun API Key）后调用发送接口。
  • 域名与平台操作：在需要「域名感知」的邮件场景下，走 Mailgun 域名/API 相关 workflow，而不是手写 URL 与 payload。
  • 事件与集成：适合需要与 Mailgun 平台直接对接、处理投递/事件类集成的 Agent 任务。

运行环境要求 Node.js 18+；从 SDK 3.0 起必须传入 FormData（Node 可用内置 FormData 或 form-data 包），以保持库在 Node 与浏览器侧的统一行为。文档与上游 README 对齐，并指向 Mailgun Node.js SDK 官方文档。

适用边界与注意点

  • 本技能是 SDK 使用与 API 工作流 导向，不是 Mailgun 账号开通、DNS 代管或合规审查的替代品。
  • 浏览器侧能力取决于上游 mailgun.js 与 CORS/密钥暴露策略；生产环境密钥应放在服务端，由 Node Agent 调用。
  • 依赖上游 mailgun.js 的版本与 breaking change（如 FormData 要求）；升级主版本前应对照官方 README。

使用场景

  • Node 自动化脚本需在用户注册或重置密码时，通过 Mailgun 客户端发送带域名的验证邮件。
  • Agent 任务要查询或触发 Mailgun 域名相关 API，避免手写 REST 与 multipart 表单字段。
  • 在服务端集成投递事件或 webhook 处理流程时，用官方 SDK 统一认证与请求格式。
  • CI 或运维脚本为新环境配置 Mailgun 发送域后，用 SDK 验证发送接口是否可用。

适合人员

  • 维护用户通知链路的后端工程师，希望 Agent 在 Node 里稳定调用 Mailgun 发信而非裸 HTTP。
  • 把多租户或分环境邮件域接入 Mailgun 的运维，需要脚本化域名与发送相关 API 操作。
  • 在 ASE/Agent 编排里嵌入「发事务邮件」步骤的集成开发者，要对齐 mailgun.js 与 FormData 要求。
  • 负责投递可观测性的工程师，需在 Node 侧对接 Mailgun 平台事件与集成接口。