邮件安全检索

技能简介

Fruitmail 是一款针对 Apple Mail.app 的命令行搜索工具，通过直接读取本地 SQLite 数据库实现毫秒级邮件检索，支持主题、发件人、日期等多维度筛选，并可提取完整正文内容。

能做什么

• 按主题、发件人、收件人、日期范围组合搜索邮件
• 列出未读邮件并导出 JSON 格式
• 读取指定邮件的完整正文内容
• 一键在 Mail.app 中打开目标邮件
• 查看邮件数据库统计信息

使用说明

安装指令：

npm install -g apple-mail-search-cli

基础用法：

1. 复合条件搜索：fruitmail search –subject “invoice” –days 30 –unread
2. 按发件人查找：fruitmail sender “@amazon.com”
3. 列出未读邮件：fruitmail unread
4. 读取邮件正文：fruitmail body 94695（支持 –json 输出）
5. 在 Mail.app 打开：fruitmail open 94695
6. 查看数据库统计：fruitmail stats

常用参数：–subject 匹配主题、–days N 限定近N天、–unread 仅未读、–limit 限制结果数、–copy 复制数据库后查询（最安全模式）

输入与输出

见下方输入与输出表格。

风险提示

• 仅限 macOS 系统使用，依赖 Apple Mail.app 的本地数据库结构
• 工具以只读模式运行，但建议定期备份 ~/Library/Mail/ 目录
• 使用 –copy 参数可避免对原始数据库文件的任何潜在影响
• 正文提取依赖 AppleScript，大量邮件批量处理时速度较慢

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/gumadeiras/apple-mail-search-safe/SKILL.md
来源类型：GitHub 仓库