wecom-agent — 企業微信全能エージェント
| 線 | 機能 | エントリ | 依存関係 |
|---|---|---|---|
| A 能動操作 | メッセージ送信/連絡先/ドキュメント読み書き/スケジュール/会議 | wecom.py | CorpID+Secret+AgentId + 信頼済みIP |
| B ローカル読み取り | 復号化によるチャット履歴エクスポート(会話/送信者/時間/本文) | decrypt/ | 企微信ログイン + adhoc 再署名(hardened runtime解除) |
| C リアルタイム受信+自律処理 | メッセージ受信→分析→自動返信/ドキュメント作成 | recv_server.py+agent_worker.py | Aの認証情報 + 受信Token/AESKey + 公開URL |
設定は README.md と docs/自社アプリ設定チュートリアル.md を参照。認証情報は config.json(gitignore済み)に記述。
A 能動操作(公式API)
python3 wecom.py <category> <method> '<jsonパラメータ>' # JSON出力、errcode:0 成功
| category | method | パラメータ | 説明 |
|---|---|---|---|
contact | departments | なし | 部門一覧(名称+ID) |
contact | users | {"department_id":1} | 部門メンバー(userid+氏名) |
contact | get/search/list_id | {"userid"/"keyword":..} | メンバー詳細/名前で検索/メンバーID一覧 |
message | text/markdown/news | {"touser":"x","content":".."} | メッセージ送信(touser未指定=@all、複数は` |
doc | create/get/edit/del/rename/sheet_get/sheet_edit | body透過 | オンラインドキュメント/スプレッドシート読み書き+編集(edit=batch_update) |
schedule/meeting | add/create/list.. | body透過 | スケジュール/会議 |
call | 緊急脱出 | {"path":"/cgi-bin/..","body":{}} | 任意の公式API |
書き込み操作(メッセージ送信/スケジュール削除/ドキュメント変更)は実行前にユーザーに内容を確認すること。
B ローカルチャット履歴の読み取り
OS別:macOS →
decrypt/macos/、Windows →decrypt/windows/;復号化コアwxwork_crypto.py+ 解析export_wxwork.pyはdecrypt/直下で両OS共通(同一wxSQLite3 AES、両方で実証済み)。
macOS(実証済み)
前提条件:企業微信が実行中かつログイン済み + 企微信にadhoc再署名実行済み(docs/復号化の考え方.md、[[wechat_codesign_pitfall]]参照)。
python3 decrypt/macos/read_wecom.py # ★ワンコマンド: キー有効ならスキップ → 復号化 → エクスポート
python3 decrypt/macos/find_key_fast.py # キー単独取得(プロセスメモリスキャン、読み取りのみ、注入なし); wxwork_keys.jsonに保存
python3 decrypt/macos/decrypt_wxwork.py # 全DB復号化 → decrypt/macos/decrypted/
python3 decrypt/macos/monitor.py --once # 差分(--poll Nで継続監視)
解析対応済み:送信者本名(Session.db USER)、会話名、メッセージタイプ — テキスト / 画像 / [音声] / [ファイル]名 / [ドキュメント]タイトル+リンク / [カード]タイトル+リンク / システム通知 / 会議。
音声文字起こし(オプション):voice_transcribe.py(ローカルキャッシュ SILK→whisper、pilk+mlx-whisper必要、再生済みのみ対応)。
キーをディスクに保存後、②③とmonitorはメモリスキャン不要。オフライン救済 find_key_offline.py。方式は docs/復号化の考え方.md 参照。生成物は機密情報、gitignore済み。
ローカルデータのクエリ/分析(復号化後、完全ローカル、ネットワーク不要):python3 decrypt/macos/wecom_local.py <サブコマンド>
| サブコマンド | 説明 |
|---|---|
contacts [語句] | 連絡先138人(氏名/部署/役職/電話/メール)、語句で検索可 |
conversations | 会話一覧(名称/メッセージ数/最終時刻) |
members <会話> | グループメンバー(発言数順) |
search <語句> | メッセージ全文検索 |
stats | 統計プロファイル(発言ランキング/会話ランキング/タイプ別/時間帯別/日別) |
todo / calendar | ローカルToDo / スケジュール |
media [--out] | 平文キャッシュの画像+ファイルをエクスポート(161画像+119ファイル) |
openfile <名前/語句> | チャット内でドキュメントを検索→ローカル本体を特定→テキスト系は内容を解析(txt/csv/md/xlsx/docx/テキストPDF、openpyxl/pdfplumber/python-docx必要);画像系/スキャンPDFは「🖼️VISUAL <パス>」を出力→その後Readマルチモーダルで直接閲覧。インライン画像(type29)はメッセージ単位で特定不可、mediaでエクスポート後マルチモーダルで閲覧 |
音声文字起こし:python3 decrypt/macos/voice_transcribe.py(キャッシュ SILK→whisper large-v3、6件で実証済み)。
MCP(オプション薄い窓口、wechatと統一)
論理コアはCLI wecom_local.py(--jsonで構造化データ取得);server.pyのMCPツールは単にそれを呼び出すラッパー、ロジックは含まず。MCPは必須ではない — 直接 wecom_local.py <サブコマンド> を実行可能。
登録:bash setup.sh(mcpインストール + claude mcp add wecom)→ Claude Code再起動。ツール:wecom_contacts/conversations/members/search/stats/todo/calendar/media/openfile(引数はサブコマンドと同じ)。前提条件:先に read_wecom.py で復号化、decrypt/macos/decrypted/ が準備済みであること。
Windows(実証済み · UTM Win11 ARM · エンドツーエンド12/12)
前提条件:企業微信(WXWork)が実行中かつログイン済み + Pythonインストール済み + pip install pycryptodome(復号化バックエンド;cryptographyはwin-arm64にwheelなし)。openfileドキュメント解析にはさらに pip install openpyxl xlrd pypdf python-docx が必要。再署名不要。
# ★ワンコマンド: キースキャン → 復号化 → サブコマンド実行
powershell -ExecutionPolicy Bypass -File decrypt/windows/run.ps1 <サブコマンド>
# サブコマンド(macOS wecom_localと統一):
# read | contacts [語句] | conversations | members <会話> | search <語句> | stats
# todo | calendar | media [--out] | openfile <名前> | voice | monitor
powershell -ExecutionPolicy Bypass -File decrypt/windows/run_test.ps1 # エンドツーエンド12項目自己テスト → レポート出力
# 個別ステップ:
powershell -ExecutionPolicy Bypass -File decrypt/windows/find_key.ps1 # PS+埋め込みC# で WXWork.exe メモリスキャン(ReadProcessMemory)→ KEY=<hex>
python decrypt/windows/wecom_win.py <key> <サブコマンド> # 共通 wxwork_crypto/export_wxwork/read_doc を利用
名前解決:user.db(uid→名/電話/メール) + session.db(会話→名)、1:1で相手を取得。DBは Documents\WXWork\<id>\Data\、平文キャッシュは …\Cache\{File,Image,Voice}。content_typeラベルはWindowsコードマッピングに従う(export_wxworkのレンダリングテーブルをカバー)。voice 文字起こし:x64 Windowsなら faster-whisper+pilk で動作可能、ARM版はwin_arm64 wheelなし/C++ツールチェーンなし → 利用不可(特定/エクスポートは可能)。
C リアルタイム受信 + 自律処理
# 1. docs/自社アプリ設定チュートリアル.md に従い「メッセージ受信」(URL/Token/EncodingAESKey)を設定
# 2. 公開URL取得: cloudflared tunnel --url http://localhost:8000
python3 recv_server.py # 署名検証+AES復号+高速ACK+キュー投入 jobs/inbox.jsonl
python3 agent_worker.py # キュー読み取り→判断→wecom.py経由で返信/ドキュメント作成
config.json に llm_base_url/llm_key/llm_model(OpenAI互換)を設定 → LLMが自律判断;"auto_reply":false の場合は記録のみで送信しない(人間による確認)。
エージェントトリガールール
| ユーザー発言 | 呼び出し |
|---|---|
| "チャットをエクスポート/読んで" | Bライン3ステップ |
| "Xに企微で送信""Xに通知" | message text |
| "連絡先を検索""Xという人を探して" | contact users/search |
| "ドキュメントを作成/読む" | doc create/get |
| "会議を設定""スケジュールを作成" | meeting create/schedule add |
| "エージェントに自動返信させる" | Cライン(recv_server + agent_worker) |
| ラップされていないAPI | call |
状態
- B ローカル読み取り:✅ 実稼働検証済み(5458件の構造化メッセージ)。
- A 能動操作:コード準備完了、エンドポイントは公式ドキュメントに基づき修正済み;実際の認証情報での結合テスト待ち(
gettokenは実測で到達確認済み)。 - C リアルタイム受信+自律処理:コールバック暗号化/復号、判断ループは自己テスト合格;認証情報+公開URLでの結合テスト待ち。
- 連絡先読み取りは企微のプライバシーポリシー制限あり(可視範囲+権限が必要、なければ
60011/60020)。