Communitygithub.com

tzwkb/wecom-agent

エージェントスキル — WeCom(企業微信)自社開発アプリのAPI操作(メッセージ送信、連絡先、カレンダー、ドキュメント)とmacOSチャット復号化。

wecom-agent とは?

このエージェントスキルは、WeCom(企業微信)の自社開発アプリ向けに、公式APIを通じた能動的操作(メッセージ送信、連絡先管理、ドキュメント読み書き、スケジュール・会議管理)と、ローカルチャット履歴の復号化・解析、さらにリアルタイムメッセージ受信とLLMによる自動応答を提供します。macOSとWindows両方で動作し、復号化部分はメモリスキャンによるキー取得、wxSQLite3 AES復号、エクスポートをワンコマンドで実行。解析済みデータは連絡先検索、会話検索、統計分析、メディアファイル抽出など多彩なサブコマンドで利用可能です。MCPサーバーとしても機能し、Claude Codeなどのエージェントフレームワークと統合できます。設定はconfig.jsonで行い、CorpIDとSecretで認証、受信サーバーはcloudflaredで公開可能。トリガーワードによりエージェントが自動で適切な操作を呼び出します。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add tzwkb/wecom-agent

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

wecom-agent — 企業微信全能エージェント

線機能エントリ依存関係
A 能動操作メッセージ送信/連絡先/ドキュメント読み書き/スケジュール/会議wecom.pyCorpID+Secret+AgentId + 信頼済みIP
B ローカル読み取り復号化によるチャット履歴エクスポート(会話/送信者/時間/本文)decrypt/企微信ログイン + adhoc 再署名(hardened runtime解除)
C リアルタイム受信+自律処理メッセージ受信→分析→自動返信/ドキュメント作成recv_server.py+agent_worker.pyAの認証情報 + 受信Token/AESKey + 公開URL

設定は README.md と docs/自社アプリ設定チュートリアル.md を参照。認証情報は config.json(gitignore済み)に記述。

A 能動操作(公式API)

python3 wecom.py <category> <method> '<jsonパラメータ>'   # JSON出力、errcode:0 成功
categorymethodパラメータ説明
contactdepartmentsなし部門一覧(名称+ID)
contactusers{"department_id":1}部門メンバー(userid+氏名)
contactget/search/list_id{"userid"/"keyword":..}メンバー詳細/名前で検索/メンバーID一覧
messagetext/markdown/news{"touser":"x","content":".."}メッセージ送信(touser未指定=@all、複数は`
doccreate/get/edit/del/rename/sheet_get/sheet_editbody透過オンラインドキュメント/スプレッドシート読み書き+編集(edit=batch_update)
schedule/meetingadd/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)
ラップされていないAPIcall

状態

  • B ローカル読み取り:✅ 実稼働検証済み(5458件の構造化メッセージ)。
  • A 能動操作:コード準備完了、エンドポイントは公式ドキュメントに基づき修正済み;実際の認証情報での結合テスト待ち(gettoken は実測で到達確認済み)。
  • C リアルタイム受信+自律処理:コールバック暗号化/復号、判断ループは自己テスト合格;認証情報+公開URLでの結合テスト待ち。
  • 連絡先読み取りは企微のプライバシーポリシー制限あり(可視範囲+権限が必要、なければ 60011/60020)。

関連スキル