名称： apple-mail-search
描述： "在 macOS 上快速搜索 Apple Mail，支持元数据与全文内容查找。可用于通过主题/发件人/收件人/日期在 Mail.app 中查找邮件、打开邮件及阅读全文。"
主页： https://clawdhub.com/gumadeiras/apple-mail-search-safe
仓库： https://github.com/gumadeiras/fruitmail-cli
元数据： {"clawdbot":{"emoji":"📧","requires":{"bins":["fruitmail"]},"install":[{"id":"node","kind":"node","package":"apple-mail-search-cli","bins":["fruitmail"],"label":"安装 fruitmail CLI (npm)"}]}}

Fruitmail (快速且安全)

基于 SQLite 的 Apple Mail.app 快速搜索工具，支持全文内容检索。

安装

npm install -g apple-mail-search-cli

使用

# 复杂搜索
fruitmail search --subject "invoice" --days 30 --unread

# 按发件人搜索
fruitmail sender "@amazon.com"

# 列出未读邮件
fruitmail unread

# 读取邮件全文（支持 --json 输出）
fruitmail body 94695

# 在 Mail.app 中打开邮件
fruitmail open 94695

# 数据库统计
fruitmail stats

命令列表

搜索选项

--subject <文本>   搜索主题行
--days <天数>      最近 N 天的邮件
--unread           仅显示未读邮件
--limit <数量>     最大结果数（默认：20）
--json             以 JSON 格式输出
--copy             查询前复制数据库（最安全模式）

示例

# 查找上个月的银行对账单
fruitmail search --subject "statement" --days 30

# 以 JSON 格式获取未读邮件
fruitmail unread --json | jq '.[] | .subject'

# 查找来自亚马逊的邮件
fruitmail sender "@amazon.com" --limit 50

性能对比

技术细节

• 数据库： ~/Library/Mail/V{9,10,11}/MailData/Envelope Index
• 查询方式： SQLite（只读） + AppleScript（获取正文内容）
• 安全性： 只读模式防止数据修改；可选 --copy 模式提供额外保护

注意事项

• 仅限 macOS —— 查询 Apple Mail.app 的本地数据库
• 只读操作 —— 可搜索和阅读邮件，但无法撰写或发送
• 如需发送邮件： 可使用 himalaya 技能（基于 IMAP/SMTP）

源码

https://github.com/gumadeiras/fruitmail-cli