Apple邮件搜索

技能简介

Apple Mail Search 是一款面向 macOS 的命令行工具，通过直接读取 Apple Mail 的 SQLite 数据库实现邮件秒级检索。相比传统 AppleScript 遍历方式（8分钟以上），该工具可在约50毫秒内完成13万封邮件的查询。

能做什么

• 按主题、发件人邮箱、发件人姓名搜索邮件
• 筛选收件人、未读邮件、含附件的邮件
• 按附件类型（如PDF）定位文件
• 按最近天数或日期范围过滤
• 通过邮件ID直接在Mail.app中打开
• 查看数据库统计信息

使用说明

安装步骤：

# 复制可执行文件到系统PATH
cp mail-search /usr/local/bin/
chmod +x /usr/local/bin/mail-search

基础用法：

# 搜索主题包含"invoice"的邮件
mail-search subject "invoice"

# 按发件人域名搜索
mail-search sender "@amazon.com"

# 列出最近7天的邮件
mail-search recent 7

# 导出为JSON格式
mail-search unread --json

输出格式选项：支持 -j/--json JSON输出、-c/--csv CSV导出、-n N 限制结果数量。

输入与输出

见下方输入与输出表格。

风险提示

• 只读操作，无法发送或修改邮件
• 仅读取元数据，邮件正文需单独访问.emlx文件
• 仅支持Apple Mail，不支持Outlook等其他客户端
• 依赖sqlite3二进制文件，需提前确认系统已安装

来源信息

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