kmsg CLI
Неофициальная консольная программа и MCP-сервер для KakaoTalk на macOS: агент читает чаты и отправляет сообщения через интерфейс
- 281 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Читает вашу личную и рабочую переписку и отправляет сообщения и картинки от вашего имени
- Требует доступ к специальным возможностям macOS, то есть управление окнами других приложений
- Автоматизация может привести к ограничению аккаунта по правилам сервиса, ответственность автор возлагает на пользователя
Установка
- Работает в
Ручная установка
brew install channprj/tap/kmsgОсновная программа. Обновление: `kmsg update`. После установки выполните `kmsg status` и разрешите доступ к специальным возможностям.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Читает вашу личную и рабочую переписку и отправляет сообщения и картинки от вашего имени
- Требует доступ к специальным возможностям macOS, то есть управление окнами других приложений
- Автоматизация может привести к ограничению аккаунта по правилам сервиса, ответственность автор возлагает на пользователя
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
kmsg управляет приложением KakaoTalk на Mac через программный интерфейс специальных возможностей macOS (Accessibility API), а не через закрытый протокол LOCO. Программа на Swift находит в окне список чатов, область сообщений и поле ввода и взаимодействует с ними так, как это делал бы пользователь. Нажатия клавиш и мыши, где они нужны, имитируются через `CGEvent`. Команды выводят структурированный JSON в `stdout`, а трассировку в `stderr`. `kmsg chats` показывает список бесед и присваивает каждой локальный `chat_id`, `kmsg read` отдает последние сообщения, `kmsg watch` следит за новыми, `kmsg send` и `send-image` отправляют текст и изображения. У `send` есть режим `--dry-run`. Команда `kmsg mcp-server` запускает MCP-сервер по stdio с инструментами чтения, отправки текста и отправки картинок. В репозитории есть и скилл `kmsg` для Claude Code и Codex. Он прописывает порядок работы: найти беседу в JSON, читать по постоянному `chat_id`, перед отправкой показать получателя и текст в режиме dry-run и отправить только по явной просьбе. README написан по-корейски, английская версия лежит рядом.
Для кого. Для пользователей Mac с KakaoTalk, которые хотят читать переписку и отвечать из скриптов и ИИ-агентов, в первую очередь в корейскоязычной среде.
Подходит, если
- Нужно, чтобы агент пересказал последние 20 сообщений рабочего чата по постоянному идентификатору беседы
- Требуется следить за новыми сообщениями командой `kmsg watch` и передавать их в OpenClaw или другой скрипт
- Нужен MCP-сервер для KakaoTalk, чтобы агент читал беседы и отправлял текст и картинки
- Хочется проверить, кому и что уйдет, режимом `--dry-run` до реальной отправки
- Нужно установить скилл одной командой `npx skills add` для Claude Code и Codex
Не подходит, если
- Нет Mac с macOS 13 или новее и приложения KakaoTalk для macOS: на Windows, Linux, Android и iOS программа не работает
- Нельзя выдавать программе доступ к специальным возможностям: без него она не видит окно
- Нужна работа на сервере без графического сеанса: управление идет через окно приложения KakaoTalk
- Нужна гарантия, что аккаунт не получит ограничений: автор оставляет ответственность за соблюдение правил сервиса на пользователе
Пример запроса к агенту
/kmsg Перескажи последние 10 сообщений из чата «출시 준비»Ограничения
Нужны macOS 13 или новее, установленный KakaoTalk для macOS и разрешение «Универсальный доступ» для самого бинарника `kmsg`. `kmsg status` запросит разрешение и проверит, выполнен ли вход.
Проект неофициальный и не связан с Kakao Corp. Автор предупреждает, что ответственность за ограничения аккаунта, сбои и потерю данных лежит на пользователе, а правила сервиса и политику безопасности компании нужно соблюдать. Интерфейс KakaoTalk меняется, и часть путей к элементам может перестать работать: для этого есть самовосстанавливающийся кэш путей.
У `send-image` режима проверки нет, поэтому скилл просит и точного получателя, и явного запроса на отправку. Основной README на корейском.
Как отключить. Удалите программу командой `brew uninstall kmsg`, уберите `kmsg` из настроек MCP клиента и отзовите ей разрешение в разделе «Универсальный доступ» системных настроек. Скилл удаляется из каталога скиллов агента.
Частые вопросы
Как поставить kmsg для Claude Code?
Сначала установите программу командой `brew install channprj/tap/kmsg`. Затем выполните `npx skills add channprj/kmsg --skill kmsg --agent claude-code codex -g -y`. В Claude Code скилл вызывается как `/kmsg`, в Codex как `$kmsg`. Если скилл не виден, перезапустите сессию агента.
Почему kmsg работает через интерфейс, а не через протокол KakaoTalk?
Автор выбрал специальные возможности macOS, потому что программа тогда не подключается к серверам KakaoTalk и не использует закрытый протокол LOCO. Платой становится зависимость от внешнего вида окна: если интерфейс изменится, некоторые пути придется найти заново.
Можно ли сначала проверить сообщение, не отправляя его?
Для текста можно: `kmsg send "название чата" "текст" --dry-run` показывает, что и кому уйдет. У `send-image` такого режима нет.
Какие инструменты дает MCP-сервер?
Команда `kmsg mcp-server` запускает MCP по stdio и дает инструменты чтения, отправки текста и отправки изображений. Для OpenClaw в репозитории есть пример `docs/openclaw.mcp.example.json`.
Что нужно, чтобы kmsg заработал?
Mac с macOS 13 или новее, KakaoTalk для macOS и разрешение «Универсальный доступ» для бинарника `kmsg`. Первый запуск `kmsg status` запросит разрешение и при необходимости откроет KakaoTalk.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI и MCP-сервер для macOS: скриншоты, разбор интерфейса через accessibility и управление приложениями по кликам и вводу
MCP-сервер на Swift дает агенту управлять любым приложением macOS: кликать, печатать и читать дерево интерфейса
Open Computer Use
open-computer-use
Открытый MCP-сервер для управления рабочим столом: агент читает состояние приложений и кликает, печатает, скроллит на macOS, Linux и Windows
MCP-сервер в одном бинарнике на Go: больше 75 локальных инструментов для файлов, оболочки, браузера и календаря
MCP-канал, который передает сообщения из WeChat в сессию Claude Code и возвращает ответы агента в тот же чат
Discord MCP от cappyeo — более 200 инструментов
Discord MCP (cappyeo)
Discord MCP с более чем 200 инструментами: агент ведет сообщения, роли и модерацию, собирает сервер по плану, а запись по умолчанию в режиме предпросмотра
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| kmsg (эта запись) | нет | 281 | ||
| WhatsApp MCP Server | нет | не нужна | 6 758 | MCP-сервер к личному WhatsApp, а не к KakaoTalk на macOS |
| Claude Code WeChat Channel | нет | OAuth | 312 | передает сообщения из WeChat в сессию Claude Code и обратно |
Коротко о README
README на корейском открывается предупреждением о неофициальности проекта и описанием архитектуры на основе AX. Далее идут демонстрация, отзывы, возможности, требования, установка через Homebrew, быстрый старт, установка скилла и ответы на частые вопросы.