Fastmail API

专为Fastmail JMAP API设计的驱动工具,用于邮件、联系人、日历等自动化操作。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Fastmail API。
它的用途是:专为Fastmail JMAP API设计的驱动工具,用于邮件、联系人、日历等自动化操作。
完整的 Skill 内容见:https://321skill.com/skills/fastmail-api-x-6/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

‘帮我把Fastmail收件箱里所有来自“newsletter”且超过30天的邮件都移动到“Archive”文件夹。’,它会通过JMAP API搜索符合条件的邮件,并安全地执行批量移动操作。或者你说:‘为我的购物网站创建一个新的虚拟邮箱地址。’,它会调用Fastmail的虚拟邮箱API,生成一个随机地址并返回给你。

介绍

这个Skill是Fastmail JMAP API的专用驱动工具,旨在解决开发者通过API自动化管理Fastmail服务的复杂需求。它封装了JMAP协议的核心调用,让你可以专注于业务逻辑,而无需处理底层的认证、状态管理和错误重试。

使用方式非常直接:在获得Fastmail API Token后,通过Skill提供的接口即可进行邮件搜索、批量归档、发送邮件(支持别名和自定义域名)、创建或管理虚拟邮箱、同步联系人日历等操作。它特别擅长处理大规模数据操作,如安全地移动数千封邮件,以及维护本地镜像的增量同步。

最适合后端开发、全栈开发以及需要将Fastmail深度集成到自动化流程中的运维开发人员使用。对于需要基于邮件、联系人数据进行应用开发或构建数据同步管道的场景,这个Skill是不可或缺的助手。

使用建议:请确保你拥有有效的Fastmail账户并已生成API Token。由于JMAP协议的特性,在处理大量数据或进行增量同步时,注意管理好state参数以避免状态不一致错误。对于简单的邮件客户端使用或SMTP发送需求,建议选择其他更合适的工具。

核心特点

这是目前唯一专注于驱动Fastmail官方JMAP API的Skill,提供了对邮件、联系人、日历、虚拟邮箱等Fastmail全功能集的深度、原子化操作支持,尤其擅长处理批量操作和增量同步等复杂API交互场景。

注意事项

不适用于配置IMAP/SMTP客户端、日常收件箱管理、或macOS上的Apple Mail客户端使用。

常见问题

如何获取Fastmail API Token?

需要登录Fastmail网页版,在设置 -> 密码与安全 -> 第三方应用管理中创建API Token。

这个Skill能用来收发普通邮件吗?

可以,但它是通过编程接口(JMAP API)进行,更适合自动化场景,而非替代日常邮件客户端。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/fastmail-api-x-6/raw/index.md 读取 Fastmail API 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。