apple-mail-search-safe

apple-mail-search-safe

Быстрый и безопасный поиск в Apple Mail с доступом к содержимому писем.

Этот инструмент предназначен для быстрого поиска писем в Apple Mail на macOS с возможностью получения как метаданных, так и полного текста сообщений. Он использует прямые запросы к локальной базе данных, что значительно ускоряет работу по сравнению со стандартными методами.

Что делает этот инструмент

Инструмент выполняет поиск по Apple Mail.app через прямые SQLite-запросы к локальной базе писем. Поддерживается фильтрация по теме, отправителю, диапазону дат и статусу прочтения, а также чтение полного содержимого письма и открытие его в приложении Mail.

Благодаря работе напрямую с базой данных Envelope Index, результаты возвращаются примерно за 50 мс, тогда как классический перебор через AppleScript может занимать более 8 минут. :

Когда использовать

• Поиск письма со счетом за последний месяц
• Проверка всех непрочитанных писем от конкретного домена
• Извлечение тем писем в формате JSON для автоматизации
• Быстрый поиск письма по отправителю без прокрутки Mail.app
• Чтение полного текста письма по его ID

Установка

npm install -g apple-mail-search-cli

Использование

# Сложный поиск
fruitmail search --subject "invoice" --days 30 --unread

# Поиск по отправителю
fruitmail sender "@amazon.com"

# Список непрочитанных писем
fruitmail unread

# Чтение полного текста письма
fruitmail body 94695

# Открытие письма в Mail.app
fruitmail open 94695

# Статистика базы данных
fruitmail stats

Команды

• search — расширенный поиск с фильтрами
• sender — поиск по отправителю
• unread — список непрочитанных писем
• body — чтение полного текста письма
• open — открыть письмо в Mail.app
• stats — статистика базы данных

Параметры поиска

--subject  поиск по теме
--days  письма за последние N дней
--unread только непрочитанные
--limit  ограничение количества результатов (по умолчанию 20)
--json вывод в формате JSON
--copy копирование базы перед запросом (самый безопасный режим)

Примеры

# Найти банковские выписки за последний месяц
fruitmail search --subject "statement" --days 30

# Получить непрочитанные письма в JSON
fruitmail unread --json | jq '.[] | .subject'

# Найти письма от Amazon
fruitmail sender "@amazon.com" --limit 50

Производительность

Сравнение методов обработки базы из ~130 000 писем:

• AppleScript (полный перебор): более 8 минут
• SQLite (данный инструмент): около 50 миллисекунд :

Технические детали

• База данных: ~/Library/Mail/V{9,10,11}/MailData/Envelope Index
• Метод запросов: SQLite (только чтение) + AppleScript для тела письма
• Безопасность: режим только чтения предотвращает изменение данных

Примечания

• Работает только на macOS
• Не поддерживает отправку писем — только поиск и чтение
• Для отправки писем рекомендуется использовать отдельные инструменты (например, через IMAP/SMTP)