Cloudflare Email Service 技能用于实现或排查 Cloudflare 邮件发送(Email Sending)与邮件路由(Email Routing)集成及其投递配置。该技能明确指出,关于 Cloudflare Email Service 的知识可能已过时,因为该产品于 2025 年推出且演进迅速,因此建议在任何邮件服务任务中优先检索而非依赖预训练知识。若技能内容与官方来源存在差异,应以原始来源为准,包括 Cloudflare 文档、REST API 规范、@cloudflare/workers-types 和 Agents SDK 仓库。
用途方面,该技能帮助用户完成以下任务:从 Cloudflare Worker 发送邮件(使用 Workers 绑定,无需 API 密钥);从基于 Cloudflare Agents SDK 构建的 AI 智能体发送邮件(使用 Agent 类中的 onEmail() 与 replyToEmail());从外部应用或智能体(Node.js、Go、Python 等)通过带 Bearer 令牌的 REST API 发送邮件;从编码智能体(Claude Code、Cursor、Copilot 等)通过 MCP 工具、wrangler CLI 或 REST API 发送邮件;接收并处理入站邮件(Email Routing,使用 Workers 的 email() 处理器);设置邮件发送或邮件路由(使用 wrangler email sending enable / wrangler email routing enable 或仪表板);以及改善可投递性、避免进入垃圾邮件文件夹(涉及认证、内容与合规)。
主要能力包括:提供前置条件检查,例如运行 npx wrangler email sending list 查看已启用邮件发送的域名,检查 wrangler.jsonc 中是否配置了 send_email 绑定,以及运行 npm ls postal-mime 确认是否安装了用于接收/解析邮件的依赖。技能按场景提供操作路径与参考文档,涵盖发送、REST API、路由、CLI 与 MCP、可投递性等主题。
使用方式上,技能建议:对于 Workers 优先使用绑定,对于外部应用或明确要求时使用 REST。在编写代码前,应先阅读 sending.md 或 rest-api.md 以检索所选任务的文档。这些指南涵盖设置、收件人、附件、标头、限制、响应处理与错误;Workers 指南还涵盖 Agents SDK 集成以及与项目配置匹配的类型。
技能还列出了常见错误及修复方法,例如:忘记在 wrangler 配置中添加 send_email 绑定(应添加 "send_email": [{ "name": "EMAIL" }] 到 wrangler.jsonc);从未验证的域名发送(需先运行 wrangler email sending enable yourdomain.com 或在仪表板中接入);在 email 处理器中两次读取 message.raw(原始流为一次性使用,应先缓冲:const raw = await new Response(message.raw).arrayBuffer());仅提供 HTML 而缺少 text 字段(应始终同时包含 html 和 text 版本);将邮件用于营销/批量发送(邮件服务仅用于事务性邮件,应使用专门的营销邮件平台);转发到未验证的目标地址(message.forward() 仅适用于已验证地址,需运行 wrangler email routing addresses create user@gmail.com 或在仪表板中添加);使用虚假地址测试(应使用自己控制的真实地址);在源代码中硬编码 API 令牌(应使用环境变量或 Cloudflare 密钥);忽略 from 域名要求(from 地址必须使用已接入邮件服务的域名);在 REST API 的 from 对象中使用 email 键(REST API 使用 address,Workers 使用 email);在 REST API 中使用 replyTo(REST API 使用 snake_case 字段名 reply_to,Workers 绑定使用 replyTo)。
适用场景包括:事务性邮件发送、入站邮件接收与处理、邮件路由配置、可投递性优化,以及从各类应用或智能体集成邮件功能。限制方面,该技能明确邮件服务仅用于事务性邮件,不适用于营销或批量发送;技能本身是便利指南,可能滞后于最新变更,应以官方来源为准。关于具体收费、价格、平台支持范围等细节,资料中未提供完整信息,需查阅官方文档。