SuperAPI AI 工具集

cloudflare-email-service

部署与运维

查看项目

更新于 10-16 09:30

技能介绍

用途:指导在 Cloudflare 平台上发送事务邮件与路由入站邮件,覆盖 Workers 绑定、REST API、Agents SDK 及送达率配置,并用于排错。该产品于 2025 年推出且在快速演进,技能强调以检索一手资料为准,若与本技能冲突以 Cloudflare 文档、REST API 规范、@cloudflare/workers-types 与 Agents SDK 仓库为准。

主要能力:按场景分流——Workers 内发送用绑定(无需 API Key);Agents SDK 用 Agent 类的 onEmail() 与 replyToEmail();外部应用用 REST API 加 Bearer token;编码代理用 MCP 工具、wrangler CLI 或 REST API;接收处理邮件用 Workers 的 email() 处理器;开通与配置用 wrangler email sending enable 或路由 enable,也可用 Dashboard;送达率涉及认证、内容与合规。

使用前检查:用 npx wrangler email sending list 确认域名已开通;wrangler.jsonc 中配置 send_email 绑定;仅接收解析时需安装 postal-mime 并用 npm ls postal-mime 检查。Workers 发送在 wrangler.jsonc 加 { "send_email": [{ "name": "EMAIL" }] },调用 env.EMAIL.send(),from 域名须先通过 npx wrangler email sending enable yourdomain.com 开通。REST API 端点为 POST https://api.cloudflare.com/client/v4/accounts/{account_id}/email/sending/send,from 用 address 而非 email,replyTo 写作 reply_to,响应返回 delivered、permanent_bounces、queued。

常见限制:仅限事务邮件,营销群发需另用平台;message.raw 只能读取一次,需先缓存;html 与 text 建议同时提供;转发目标地址必须已验证;from 地址须使用已开通域名;避免使用假地址测试;不要在源码中硬编码 API token。

参考文件:references/sending.md、references/rest-api.md、references/routing.md、references/cli-and-mcp.md、references/deliverability.md,按需查阅。具体价格与额度等资料暂未提供。