← 返回 Skills 市场

Apple Mail Search Safe.Bak

Name: Apple Mail Search Safe.Bak
Author: hellohushuai

作者 hellohushuai · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

187

总下载

当前安装

版本数

在 OpenClaw 中安装

/install apple-mail-search-safe-bak

功能描述

Apple Mail search on macOS with fast metadata and full body lookup. Use for finding messages in Mail.app by subject/sender/recipient/date, opening messages,...

使用说明 (SKILL.md)

Fruitmail (Fast & Safe)

Fast SQLite-based search for Apple Mail.app with full body content support.

Installation

npm install -g apple-mail-search-cli

Usage

# Complex search
fruitmail search --subject "invoice" --days 30 --unread

# Search by sender
fruitmail sender "@amazon.com"

# List unread emails
fruitmail unread

# Read full email body (supports --json)
fruitmail body 94695

# Open in Mail.app
fruitmail open 94695

# Database stats
fruitmail stats

Commands

Command	Description
`search`	Complex search with filters
`sender \x3Cquery>`	Search by sender email
`unread`	List unread emails
`body \x3Cid>`	Read full email body (AppleScript)
`open \x3Cid>`	Open email in Mail.app
`stats`	Database statistics

Search Options

--subject \x3Ctext>   Search subject lines
--days \x3Cn>         Last N days
--unread           Only unread emails
--limit \x3Cn>        Max results (default: 20)
--json             Output as JSON
--copy             Copy DB before query (safest mode)

Examples

# Find bank statements from last month
fruitmail search --subject "statement" --days 30

# Get unread emails as JSON
fruitmail unread --json | jq '.[] | .subject'

# Find emails from Amazon
fruitmail sender "@amazon.com" --limit 50

Performance

Method	Time for 130k emails
AppleScript (full iteration)	8+ minutes
SQLite (this tool)	~50ms

Technical Details

Database: ~/Library/Mail/V{9,10,11}/MailData/Envelope Index
Query method: SQLite (read-only) + AppleScript (body content)
Safety: Read-only mode prevents modification; optional --copy mode available

Notes

macOS only — queries Apple Mail.app's local database
Read-only — can search/read but cannot compose/send
To send emails: Use the himalaya skill (IMAP/SMTP)

Source

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

安全使用建议

This skill appears to do what it says (search local Apple Mail), but take these precautions before installing: 1) Verify the upstream npm package and GitHub repo (apple-mail-search-cli / gumadeiras/fruitmail-cli) — inspect package contents and maintainers for malicious install-scripts or unexpected network calls. 2) Note the registry metadata mismatches (different ownerId/slug/version in _meta.json vs registry) — ask the publisher to confirm provenance. 3) Expect the tool to read your Mail database and run AppleScript to access message bodies — do not install if you cannot trust the package. 4) If you proceed, run with the '--copy'/'read-only' option or test in a restricted/sandboxed account, and audit network activity and the installed binary (npm ls, inspect bin files) before granting broader use.

功能分析

Type: OpenClaw Skill Name: apple-mail-search-safe-bak Version: 1.0.0 The skill provides access to the user's local Apple Mail database (~/Library/Mail) and uses AppleScript to read full email bodies. While these capabilities are aligned with the stated purpose of searching and reading mail, they represent a high-risk access to sensitive personal data. No evidence of intentional malice, such as data exfiltration or hidden prompt injection, was found in the SKILL.md or _meta.json files.

能力评估

✓ Purpose & Capability

The skill name/description, required binary (fruitmail), and SKILL.md all consistently describe a CLI that reads Apple Mail's local Envelope Index and uses AppleScript to fetch message bodies — those capabilities match the stated purpose.

ℹ Instruction Scope

SKILL.md explicitly instructs the agent to read ~/Library/Mail/.../Envelope Index (read-only) and use AppleScript to read message bodies. Those actions are necessary for the advertised functionality but involve accessing highly sensitive personal email data; the doc recommends a safe '--copy' mode, which is appropriate.

⚠ Install Mechanism

Install is an npm global package (apple-mail-search-cli -> fruitmail). npm packages can execute arbitrary code at install/run time; the skill includes no bundled code for inspection, so you must trust the remote package. This is a moderate risk compared with instruction-only skills that do not pull code from a registry.

✓ Credentials

The skill requests no environment variables or external credentials, which is proportional to its purpose. However, it does require filesystem access to Mail's database, which is intrinsically sensitive but expected for this functionality.

✓ Persistence & Privilege

The skill does not request always:true, no persistent privileges or cross-skill config changes are declared, and autonomous invocation is the platform default. Nothing here elevates privileges beyond normal skill behavior.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install apple-mail-search-safe-bak
安装完成后，直接呼叫该 Skill 的名称或使用 /apple-mail-search-safe-bak 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Initial release of apple-mail-search-safe-bak. - Provides fast, read-only search for Apple Mail.app using SQLite for metadata and AppleScript for full email body. - Supports searches by subject, sender, recipient, and date with advanced filtering options. - Enables viewing, opening, and reading full emails directly from the command line. - Optimized performance (~50ms for 130k emails) compared to slower AppleScript-only solutions. - Includes safety features such as optional database copy mode to ensure no modification of mail data.

元数据

Slug apple-mail-search-safe-bak

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题