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-5/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘使用Fastmail API Skill，帮我找出过去一周所有来自“newsletter@example.com”且未读的邮件，并将它们全部移动到名为“Newsletters”的文件夹里。’ 它会通过JMAP API精准搜索符合条件的邮件，并执行批量移动操作，确保不会影响其他邮箱。或者，你可以说：‘创建一个新的匿名邮箱地址，并关联到我的主账户。’ Skill会调用相应的JMAP接口完成创建。
介绍
Fastmail API Skill 是一个专门用于驱动Fastmail JMAP API的自动化工具，旨在解决开发者、高级用户或管理员在管理和操作Fastmail服务时遇到的各种复杂、批量或需要编程接口的场景。它通过JMAP协议，为邮件、联系人、日历等核心功能提供了强大的程序化控制能力。
该Skill通过接收用户的自然语言指令，将其转换为规范的JMAP API调用，从而执行复杂的操作。例如，当用户需要批量处理成千上万封邮件（如搜索、归档、移动、标记或删除）时，Skill可以确保操作精准无误，避免误触其他邮箱。它还能处理发送邮件（包括使用别名、身份或自定义域名）、创建或管理匿名邮箱地址、同步联系人及日历事件等任务。
该Skill非常适合需要将Fastmail服务集成到自动化流程中的后端开发者、全栈开发者，或是管理大量邮件和数据的运维工程师、数据分析师。对于需要从其他邮件服务迁移数据，或需要保持本地数据与Fastmail服务实时同步的场景，它也是理想的选择。
在使用时，用户需要准备好自己的Fastmail API令牌。由于Skill专注于JMAP API，它不适用于传统的IMAP/SMTP客户端操作、日常收件箱的简单整理，或macOS上的Apple Mail应用。对于涉及大量数据操作的任务，建议先在测试环境中验证操作逻辑，以确保安全性和准确性。
核心特点
与通用的邮件管理工具不同，此Skill是专门针对Fastmail的现代JMAP协议深度定制，能处理如`stateMismatch`、`invalidResultReference`等JMAP特有错误，并支持匿名邮箱、增量同步、推送订阅等Fastmail高级功能，而非仅提供基础的收/发/删邮件操作。
注意事项
不适用于使用IMAP/SMTP协议的邮件客户端、日常习惯性的收件箱整理，或macOS上的Apple Mail应用。
常见问题
这个Skill能帮我用IMAP同步Fastmail邮件吗？
不能，此Skill专门用于JMAP API，不适用于IMAP协议。
我需要什么才能使用这个Skill？
你需要一个Fastmail账户并生成一个API令牌（api.fastmail.com）。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/fastmail-api-x-5/raw/index.md 读取 Fastmail API 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/fastmail-api-x-5/raw/index.md（查看排版版本）