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-4/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我把过去一个月所有来自“newsletter”且未读的邮件，批量移动到名为“ReadLater”的邮箱里。’ 它会生成相应的 JMAP API 调用代码，精确筛选符合条件的邮件，并安全地执行移动操作，同时处理可能的分页和错误。或者，你可以说：‘我想创建一个新的匿名邮箱地址，用于某个网站的注册。’ AI 会指导你完成通过 JMAP API 创建和管理匿名邮箱的步骤。
介绍
Fastmail API 技能旨在解决用户通过编程方式管理和操作 Fastmail 邮箱服务的复杂需求。传统邮件客户端或手动操作在处理批量任务、复杂逻辑或系统集成时效率低下且易出错，而本技能通过驱动 Fastmail 官方的 JMAP API，提供了强大、精准的自动化控制能力。
使用时，您需要准备好 Fastmail API 令牌，并直接向 AI 描述您想要执行的操作，例如批量处理邮件、管理联系人、创建匿名邮箱或同步日历事件。AI 会理解您的意图，并生成或执行相应的 JMAP API 调用代码，处理诸如身份验证、错误重试、数据分页等底层细节。
该技能非常适合需要将 Fastmail 服务集成到自动化工作流中的开发者、运维人员或高级用户。无论是进行邮箱数据迁移、构建本地邮件镜像、开发自定义邮件管理工具，还是需要执行大规模、无差错的邮件归档、搜索和分类操作，本技能都能提供可靠支持。
请注意，使用前务必在 Fastmail 账户设置中生成 API 令牌，并妥善保管。由于直接操作 API，请谨慎执行删除、移动等破坏性操作，建议先在测试邮箱或少量数据上验证。此外，本技能专注于 JMAP API，不适用于配置 IMAP/SMTP 客户端或处理常规的收件箱日常整理习惯。
核心特点
本技能是专门为 Fastmail 的现代 JMAP API 设计的，与通用的 IMAP 或邮件客户端技能不同，它直接处理 JMAP 特有的概念（如能力集、状态不匹配错误）和高效批量操作，并能处理匿名邮箱、日历、联系人等 JMAP 专属功能，实现了对 Fastmail 服务的深度、精准集成。
注意事项
不适用于配置传统的 IMAP/SMTP 邮件客户端、处理日常习惯性的收件箱整理，或用于 macOS 上的 Apple Mail 应用。
常见问题
如何获取 Fastmail API 令牌？
登录 Fastmail 网页版，进入“设置”->“密码与安全”->“第三方应用”，生成一个 API 令牌并复制保存。
这个技能能帮我自动回复邮件吗？
可以，通过 JMAP API 可以读取邮件、创建草稿并发送，从而实现基于规则或内容的自动回复。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/fastmail-api-x-4/raw/index.md 读取 Fastmail API 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/fastmail-api-x-4/raw/index.md（查看排版版本）