kakaocli CLI
CLI для KakaoTalk на Mac: агент читает чаты, ищет по сообщениям и отправляет тексты через автоматизацию клиента
- 182 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Утилита читает всю локальную базу переписок KakaoTalk и отправляет сообщения от вашего имени через автоматизацию интерфейса.
- Для чтения нужен Full Disk Access, для отправки и входа сохраняются учетные данные клиента, а автор предупреждает о возможном ограничении аккаунта Kakao.
Установка
- Работает в
Ручная установка
brew install silver-flight-group/tap/kakaocliСтавит утилиту и sqlcipher, собирает из исходников около 20 секунд. Затем выдайте терминалу Full Disk Access.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Утилита читает всю локальную базу переписок KakaoTalk и отправляет сообщения от вашего имени через автоматизацию интерфейса.
- Для чтения нужен Full Disk Access, для отправки и входа сохраняются учетные данные клиента, а автор предупреждает о возможном ограничении аккаунта Kakao.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
kakaocli — консольная утилита для KakaoTalk на macOS. Она читает локальную зашифрованную базу SQLCipher только на чтение и отдает чаты, сообщения и полнотекстовый поиск в формате JSON, а `kakaocli query` выполняет SQL-запрос по расшифрованной базе. Сообщения отправляет автоматизация интерфейса клиента через Accessibility API macOS. Протокол KakaoTalk утилита не воспроизводит и серверы Kakao не вызывает. Для агентов предусмотрены `kakaocli sync --follow` с потоком новых сообщений в формате NDJSON и доставкой на вебхук, а также автоматический запуск и вход в клиент по сохраненным учетным данным. Команда `kakaocli harvest` собирает названия групповых чатов из интерфейса, потому что в базе они иногда записаны как `(unknown)`, а с флагом `--scroll` подгружает старую историю. Скилл `skills/kakaocli/SKILL.md` перечисляет команды и правила для агента: подтверждать отправку другим людям, проверять через `--me` и `--dry-run`, слать не чаще одного сообщения в две секунды.
Для кого. Пользователям KakaoTalk на Mac, которые поручают Claude Code или Cursor сводки переписок, поиск по ним и отправку ответов.
Подходит, если
- Вам нужна сводка за неделю по рабочему групповому чату, а читать сотни сообщений некогда.
- Вы ищете договоренность по ключевому слову сразу во всех чатах.
- Входящие сообщения обрабатывает ваш скрипт: поток `kakaocli sync --follow` или вебхук на локальный адрес.
- Агент напоминает коллеге о встрече, а текст сначала проходит через `--dry-run`.
Не подходит, если
- Вы пользуетесь KakaoTalk на Windows, телефоне или в вебе: утилита рассчитана только на клиент для Mac.
- Нужна массовая рассылка: сообщения уходят через интерфейс клиента, а скилл разрешает не чаще одного сообщения в две секунды.
- Вам нужен официальный API Kakao: утилита его не использует.
Пример запроса к агенту
Найди в KakaoTalk сообщения про обед за последнюю неделю и перескажи, о чем договорились.Ограничения
Клиент KakaoTalk для Mac подгружает сообщения с сервера только при открытии чата, поэтому давние переписки в локальной базе могут отсутствовать. `harvest --scroll` упирается в то же поведение клиента и в платный Talk Drive Plus. Отправка и `sync` требуют запущенного клиента. Авторы не отвечают за последствия, включая ограничение аккаунта со стороны Kakao. Последний коммит репозитория датирован мартом 2026 года.
Как отключить. Удалите утилиту командой `brew uninstall kakaocli`. Сохраненные учетные данные снимает `kakaocli login --clear`, а метаданные чатов лежат в `~/.kakaocli/metadata.json`. Скопированный `SKILL.md` уберите из каталога скиллов проекта.
Частые вопросы
Какие разрешения нужны в macOS?
Терминалу выдают Full Disk Access в разделе «Конфиденциальность и безопасность» системных настроек, без него база не читается. Accessibility нужна дополнительно только для `send`, `harvest` и `inspect`.
Как проверить отправку заранее?
Отправьте сообщение себе: `kakaocli send --me _ "test message"`. Либо добавьте `--dry-run`, и утилита покажет, что уйдет, ничего не отправив.
Как получать новые сообщения в агенте?
Запустите `kakaocli sync --follow`: каждое сообщение придет строкой JSON с полями chatId, logId, author, message и sentAt. Для доставки на адрес добавьте `--webhook http://localhost:8080/kakao`.
Как собрать названия групповых чатов?
Запустите `kakaocli harvest`: утилита обходит список чатов в интерфейсе и сохраняет имена в `~/.kakaocli/metadata.json`. Чаты с непрочитанными сообщениями она пропускает, чтобы не отметить их прочитанными.
Как сохранить данные для автоматического входа?
`kakaocli login` запрашивает данные в диалоге, а `kakaocli login --status` показывает состояние. Для скриптов есть вариант с `--email` и `--password`, но пароль в аргументах попадает в историю оболочки.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыНеофициальная консольная программа и MCP-сервер для KakaoTalk на macOS: агент читает чаты и отправляет сообщения через интерфейс
Скилл дает агенту CLI Kody для локального выполнения кода с общей памятью, пакетами и данными облачного аккаунта.
WeChat Automation API
wechat-automation-api
Скилл для агентов на Windows: отправляет текст, картинки и файлы через уже запущенный десктопный WeChat, также есть HTTP API с очередью
CLI и MCP-сервер для macOS: скриншоты, разбор интерфейса через accessibility и управление приложениями по кликам и вводу
CLI на Rust для macOS: агент читает интерфейс любого приложения через дерево доступности и кликает, печатает, листает по ссылкам на элементы без скриншотов
Hycli по адресу сайта и цели собирает типизированный CLI и MCP-инструменты, работая в вашей браузерной сессии без утечки куки.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| kakaocli (эта карточка) | нет | 182 | ||
| WhatsApp MCP Server | нет | не нужна | 6 816 | MCP-сервер к личному аккаунту WhatsApp; здесь KakaoTalk и CLI с автоматизацией клиента на Mac |
| LINE Bot MCP Server | да | API-ключ | 797 | официальный MCP-сервер LINE через Messaging API; здесь неофициальная работа с локальной базой клиента |
Коротко о README
README двуязычный, на английском и корейском. Утилиту сделали в Silver Flight Group, идея навеяна wacli, таким же CLI для WhatsApp на Mac, а способ расшифровки базы основан на исследовании blluv. Дисклеймер подчеркивает, что проект неофициальный и с Kakao не связан.