KakaoTalk Mac CLI

このスキルが行うこと

macOS で kakaocli を使用して KakaoTalk の会話リストを確認し、メッセージを検索し、必要に応じて返信を送信します。

このスキルは macOS + KakaoTalk Mac アプリのインストール を前提としています。公式 Kakao API を使用するのではなく、ローカルデータベースの読み取りと macOS アクセシビリティオートメーションの上で動作するため、事前に権限とセキュリティルールを確認する必要があります。

使用する場合

• 「KakaoTalk の最近の会話リストを表示して」
• 「特定のチャットルームの最近のメッセージを見つけて」
• 「KakaoTalk メッセージを検索して」
• 「私の KakaoTalk でテストメッセージを送って」
• 「返信の下書きは作るけど、実際に送る前に必ず確認してね」

使用しない場合

• macOS 以外の環境
• KakaoTalk Mac アプリがインストールされていない環境
• ユーザーの確認なしに他の人にメッセージを直接送信する必要がある作業
• Kakao 公式 API の範囲内で解決可能なサーバー間連携作業

前提条件

• macOS
• KakaoTalk for Mac のインストール
• Homebrew
• Mac App Store ログイン(mas 使用時)
• kakaocli のインストール
• python3 3.10 以上
• このリポジトリのヘルパー scripts/kakaotalk_mac.py
• ターミナルアプリに フルディスクアクセス と アクセシビリティ 権限の付与

入力

• チャットルーム名または検索キーワード
• 読み取り範囲: 最新 N 件、--since 1h、--since 7d など
• 送信するメッセージ本文
• テスト実行の有無 (--me、--dry-run)

ワークフロー

0. KakaoTalk for Mac が見つからない場合は最初にインストール

KakaoTalk Mac アプリがない場合は、最初にインストールします。mas を使用する場合は App Store にログインしている状態である必要があります。

brew install mas
mas account
mas install 869223134

mas install が失敗する場合は、App Store アプリでまずログインしてから再度試してください。

1. kakaocli をインストール

公式リポジトリに基づいた推奨インストール方法は Homebrew tap です。

brew install silver-flight-group/tap/kakaocli

インストール後、すぐにステータスを確認します。

kakaocli status

2. 必要な macOS 権限を付与

システム設定 > プライバシーとセキュリティ で、現在使用しているターミナルアプリ(iTerm、Terminal、Warp など)に以下の権限を付与します。

• フルディスクアクセス: KakaoTalk のローカルデータベースの読み取り用
• アクセシビリティ: メッセージ送信、harvest、inspect などの UI オートメーション用

基本ルール:

• status / auth / chats などの読み取りコマンドもフルディスクアクセスが必要です。
• send、harvest、inspect 型の作業はアクセシビリティ権限も必要です。

3. 副作用を試みる前に読み取りアクセスを確認

まず読み取りパスが動作するか確認します。

kakaocli status
kakaocli auth
kakaocli chats --limit 10 --json

auth が成功すれば、読み取りパスは準備完了です。

3.5. kakaocli auth が user_id 自動検出に失敗する場合はヘルパーを使用

実際の macOS 環境では、KakaoTalk.db というリテラルファイルが存在しなくても、コンテナ内の 78 文字の 16 進数ファイル が実際の SQLCipher DB である場合があります。このとき kakaocli status は正常ですが kakaocli auth だけが失敗する典型的な原因は:

• AlertKakaoIDsList 候補では複号化できない
• plist の DESIGNATEDFRIENDSREVISION:<sha512(user_id)> のみが残っている
• upstream kakaocli のデフォルト user_id ブルートフォース時間が短いため自動検出が失敗する

このリポジトリは、その部分のみを補完する 読み取り専用ヘルパー を一緒に提供します。

python3 scripts/kakaotalk_mac.py auth --refresh
python3 scripts/kakaotalk_mac.py chats --limit 10 --json
python3 scripts/kakaotalk_mac.py messages --chat "지수" --since 1d --json
python3 scripts/kakaotalk_mac.py search "회의" --json

• ヘルパーは plist の AlertKakaoIDsList と DESIGNATEDFRIENDSREVISION ハッシュを読み取ります。
• すべての候補 user_id が失敗した場合、SHA-512 プリイメージ検索で実際の user_id をより長く探索します。
• 成功した user_id、DB パス、導出キーは ~/.cache/k-skill/kakaotalk-mac-auth.json にキャッシュされます。
• その後の読み取り専用ヘルパーコマンド(chats、messages、search、schema)はキャッシュされた --db / --key を付けて kakaocli を再度呼び出します。

4. メッセージを読み取りまたは検索

kakaocli messages --chat "지수" --since 1h --json
kakaocli search "점심" --json

ヘルパー経由の例:

python3 scripts/kakaotalk_mac.py messages --chat "지수" --since 1h --json
python3 scripts/kakaotalk_mac.py search "점심" --json

レスポンスはできるだけ JSON モードで受け取り、人間が読みやすいように再度要約します。

5. 実際の送信前に安全なテストを使用

実際に送信する前に、まず自分自身にテストするか、dry-run で確認します。

kakaocli send --me _ "テストメッセージ"
kakaocli send --dry-run "チャットルーム名" "送信する文"

--me は自分とのチャットに送信するため、最も安全なテストパスです。

6. 他の人に送信する前に確認

他の人またはグループチャットに送信する前に、ユーザーの最終確認を必ず得てください。

確認前には以下のみを準備します。

• ターゲットチャットルーム名
• 送信する文
• なぜこの文を送信するのかを 1 行で説明

確認を得たときだけ送信します。

kakaocli send "チャットルーム名" "送信する文"

7. ユーザーが明示的に自動ログインを希望する場合のみログインストレージを使用

自動ログイン機能を希望する場合のみ認証情報を保存します。

kakaocli login
kakaocli login --status

チャットウィンドウでパスワードを入力するよう要求しないでください。ユーザーがローカルターミナルで直接入力するようにします。

完了条件

• 読み取りリクエストの場合、ステータス確認と会話/メッセージ照会結果が整理されている
• 検索リクエストの場合、キーワード基準の結果が整理されている
• 送信リクエストの場合、テスト(--me または --dry-run)とユーザー確認が完了した後、実際の送信の有無が明確である

障害モード

• KakaoTalk for Mac がインストールされていない
• App Store ログイン漏れにより mas install が失敗
• フルディスクアクセスが付与されていない
• アクセシビリティが付与されていない
• status は正常だが auth だけが失敗する user_id 自動検出/キー不一致のケース
• チャットルーム名の substring が曖昧で複数の候補が捕捉される

注記

• このスキルは macOS 専用です。
• 他の人に送信するメッセージは常に「送信前に確認」の原則を守ります。
• 最初の検証は kakaocli status と kakaocli auth から始めるのが安全です。
• kakaocli auth が User ID: auto-detection failed で止まる場合はヘルパーパスを優先的に使用します。
• ヘルパーキャッシュはローカル SQLCipher キーを含むため、自分のアカウントでのみ保持し、共有しません。
• デフォルトの auth テキスト出力はキーを再度表示しません。オートメーションが必要な場合のみ --format json または --format shell を使用します。