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/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我需要通过Fastmail API，将收件箱中所有来自“newsletter@example.com”且超过30天的邮件，批量移动到名为“Old_Newsletters”的邮箱里。'，它会使用你的API Token构造JMAP搜索和邮箱/邮件设置请求，精准定位并移动符合条件的邮件，同时处理可能出现的状态不匹配等错误。或者，你可以说：'为我的购物网站创建一个新的匿名邮箱地址。'，它会调用Fastmail的匿名邮箱创建API来完成。
介绍
这个Skill主要解决开发者在集成和使用Fastmail JMAP API时遇到的各种复杂问题。它提供了对Fastmail邮件、搜索、批量处理、发送、匿名邮箱、联系人及日历等功能的直接API驱动能力，尤其擅长处理大规模数据操作和错误恢复。
使用方式是通过提供Fastmail API Token，让AI能够直接调用api.fastmail.com的JMAP接口。当用户提出相关需求时，AI会解析意图并构造相应的JMAP请求，处理身份验证、错误码（如401、403、stateMismatch等）以及批量操作逻辑。
它非常适合需要与Fastmail深度集成的后端开发、全栈开发和智能体开发者。无论是构建需要同步邮件数据的应用、开发自动化客服工具，还是进行邮箱数据迁移，这个Skill都能提供强大的底层API支持。
使用建议是，在开始前务必准备好有效的Fastmail API Token，并明确你的操作范围（如特定邮箱、联系人列表）。注意事项包括：它不适用于传统的IMAP/SMTP客户端配置、日常收件箱习惯管理，或macOS上的Apple Mail应用。
核心特点
与通用的邮件处理Skill不同，它深度聚焦于Fastmail官方的JMAP协议，能直接处理JMAP特有的错误码（如unknownCapability, invalidResultReference）和状态同步问题，并支持匿名邮箱、日历事件等Fastmail特色功能的API操作。
注意事项
不适合用于配置IMAP客户端、SMTP投递、日常收件箱习惯管理，或操作macOS上的Apple Mail应用。
常见问题
如何获取Fastmail API Token？
需要登录Fastmail账户，在设置中生成API Token，并确保授予了邮件、联系人等所需权限。
这个Skill能处理多少封邮件的批量操作？
它专为处理成千上万封邮件的搜索、归档、移动、标记或删除而设计，能确保操作准确，避免触及错误邮箱。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/fastmail-api/raw/index.md 读取 Fastmail API 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/fastmail-api/raw/index.md（查看排版版本）