line-desktop-agent

自分の LINE を、Claude Code から読んだり(まとめ・検索・返信の下書き)、本人が確かめたときだけ送ったりするための、個人用の道具です。公式のクライアントだけを使います。

• LINE for PC(Windows): UI Automation(UIA)で、画面の部品を読む・窓へメッセージを投函する

• LINE の Chrome 拡張: Chrome DevTools Protocol(CDP)で、拡張のページを読む・操作する

やらないこと(意図して作っていません)

• 非公式の通信(LINE のサーバーを直接たたくライブラリなど)は使わない。

• LINE のデータベースや暗号化されたキャッシュを解読しない。拡張の Cookie / localStorage も読まない。

• 一斉送信・自動返信はしない。送る前に必ず本人の確認が入る。

• 削除・転送・通報・設定変更の道具は作っていない。

Related MCP server: line-selfbot-mcp

安全の作り

• 許可リスト: 送れるのは、データ置き場の config.json の send_allowlist に書いたトークだけ。空か無ければ送信は無効(下見が、有効にする方法を表示する)。コードに送り先は入っていない。

• 下見 → 合言葉 → 本番: 下見(dry-run)は送らず、5 分・1 回だけ使える合言葉を返す。本番は、同じ相手・同じ文面・その合言葉が揃ったときだけ。

• 台帳(send_ledger.jsonl): 送る前に sending、あとで sent / failed / unknown。結果が分からない送信が残っている間は、次の送信をすべて断る。自動で送り直さない。

• 使わない操作: マウスを動かさない・物理のキーを押さない・LINE の窓を前に出さない(窓へのメッセージ投函と UIA / CDP だけ)。押すキーは Enter だけ。ほかのキーの部品は作っていない(テストで確かめる)。

• 非常停止: データ置き場に STOP ファイルがあれば、見張り・送信・開く・スクロールがすべて止まる。

準備

1. Windows 11 + Python 3.10 以上。リポジトリで仮想環境を作り、pip install -r requirements.txt。

2. データ置き場(既定 %LOCALAPPDATA%\line-desktop-agent。環境変数 LINE_AGENT_HOME で変更)に config.json を作る。

   {
     "self_names": ["自分の LINE 表示名"],
     "send_allowlist": ["自分だけのテスト用トークの名前"],
     "chrome_profile": "D:\\path\\to\\chrome-profile"
   }

   self_names は、返信行の送り手が自分かを見分けるのに使う(無ければ空)。chrome_profile は Chrome 版を使うときの専用プロフィールの置き場(環境変数 LINE_AGENT_CHROME_PROFILE でも指定できる。既定は %LOCALAPPDATA%\line-desktop-agent\chrome-profile)。

3. 動作確認: set PYTHONPATH=src のあと .venv\Scripts\python.exe -m pytest -q、.venv\Scripts\python.exe -m line_agent list。

4. MCP サーバー(Claude Code 用): .mcp.json.example を .mcp.json にコピーして、パスを自分の環境に合わせる。.claude/settings.json に、自動で許可する道具・毎回たずねる道具の分け方がある。

5. 見張り(任意): scripts\start_watcher.ps1(タスクスケジューラから呼ぶ)、止めるのは scripts\stop_watcher.ps1。Chrome 版は scripts\start_line_chrome.ps1 で専用 Chrome を起動し、LINE 拡張にログインしておく。

6. 詳しい使い方・実測した内容は docs/ にある。

既知の限界

• LINE for PC は Qt 製で、添付(写真・ファイル)の保存ボタンが UIA に出ないため、PC 版では保存できない。Chrome 版ならできる。

• Chrome 版が持つ履歴は、PC 版より短い。

• 拡張のページの作り(DOM)は、LINE 側の更新で変わりうる。変わると読めなくなる。

• 画面ロック中・ログオフ中は動かない(UIA でデスクトップを読むため)。

注意(必ず読んでください)

個人の LINE アカウントを自動操作することは、LINE の利用規約に反する可能性があり、アカウントが制限・停止されるおそれがあります。自己責任で使ってください。 このプロジェクトは LY Corporation(LINE)とは無関係で、公認も受けていません。他人のトークの内容を扱うので、プライバシーにも気をつけてください(トークの内容は data/・*.db として git に入れない設定にしてあります)。

English summary

A private-use tool that lets Claude Code read (and, only after explicit confirmation, send messages in) your own personal LINE account through the official clients: LINE for PC via Windows UI Automation, and the LINE Chrome extension via the Chrome DevTools Protocol.

It deliberately does not: use any unofficial protocol, decrypt LINE databases or caches, send in bulk, or auto-reply.

Safety design: sending is disabled unless send_allowlist in config.json names the chat; a dry-run returns a one-time token (5 minutes) that the real send must match; an append-only ledger blocks further sends while a result is unresolved; no mouse/physical keys/foreground changes (only Enter, posted to the window); a STOP file halts everything.

Setup: create a venv, pip install -r requirements.txt, write config.json (self_names, send_allowlist, optional chrome_profile) in the data folder (%LOCALAPPDATA%\line-desktop-agent or LINE_AGENT_HOME), copy .mcp.json.example to .mcp.json, run python -m pytest -q.

Known limits: the Qt-based PC client cannot save attachments (the Chrome version can); the Chrome version shows a shorter history; the extension's DOM may change.

Warning: automating a personal LINE account may conflict with LINE's Terms of Use and can put the account at risk. Use at your own risk. Not affiliated with or endorsed by LY Corporation.