技能介绍

解决的问题

在 Agent 的自动化工作流里，调用传统邮箱往往需要人工介入：要么登录客户端手动查看邮件，要么编写针对特定邮箱服务的定制解析脚本，验证码提取、回复内容同步这类高频操作难以高效复用。尤其当需要 Agent 自主发送邮件、读取收件箱、搜索历史邮件，或从海量邮件中精准提取登录验证码、附件时，缺乏统一的编程化入口会导致流程割裂，拖慢整体执行效率。

核心能力与工作原理

该技能围绕 Mails CLI 与 SDK 构建了可直接对接 Agent 的邮箱代理能力，核心围绕三类场景展开：

邮箱资源的编程化接入：支持对接已认领或自托管的邮箱，通过 Authorization: Bearer 完成身份认证，确保 /api/* 端点的调用权限与邮箱归属一致（/health 端点始终公开，无需认证），为 Agent 提供稳定的邮箱操作入口。
邮件全流程操作支持：可覆盖邮件发送（需可选配置 Resend 密钥）、读取、本地同步、搜索等核心动作，同时支持从邮件中定向提取验证码、回复上下文或附件，无需人工筛选邮件内容。
灵活的部署适配：若使用自托管模式，可通过可选的 Cloudflare Worker 部署实现，适配不同环境的部署需求，避免对第三方服务的强依赖。

适用边界与注意点

该技能的能力依赖特定的技术前提：需运行环境支持 Node.js 或 Bun，且需提前完成邮箱的认领或自托管配置。调用核心 API 时需注意 token 的适用范围——必须与请求中的目标邮箱（?to=）、待读取邮箱或发送方地址匹配，否则会出现权限校验失败。此外，自托管模式需额外配置 Resend 密钥与 Cloudflare Worker，纯本地运行场景无法直接使用发送功能；其数据提取能力聚焦于验证码、回复内容等结构化信息，无法实现自然语言对话等非邮箱相关的功能。