Winautowx

🚀 WinAutoWx 微信（Weixin/WeChat）自動化スクリプト - LLM 対応 MCP

このプロジェクトは、Python + pywinauto をベースにした自動化スクリプトを提供しています。Windows 上で微信（Weixin/WeChat）を接続/起動し、友達やグループチャットを検索してメッセージを送信することができます。また、一度に複数の友達に複数のメッセージを循環送信することもサポートしています。

交流グループ

寄付

🚀 クイックスタート

起動指令速査

• コマンドライン（CLI 用法は Debug ドキュメントに移行） run_wechat.py のコマンドライン用法とデバッグ説明は、Debug.md を参照してください。

• HTTP API サービス（FastAPI）の起動

uvicorn server:app --host 127.0.0.1 --port 8000

• fastmcp（MCP/stdio）サービスの起動と MCP Inspector での接続

python mcp_server.py
mcp-inspector --server "python mcp_server.py"

環境要件

• Windows 10/11（64 ビット推奨）
• Python 3.8–3.12（64 ビット推奨）
• Windows 版微信（Weixin/WeChat）がインストールされ、ログイン済み

インストール

pip install -r requirements.txt

使い方

コマンドラインでの迅速な送信やデバッグが必要な場合は、Debug.md を参照してください。以下は、HTTP API/MCP を使用する方法です。

パラメータ説明（CLI）

コマンドラインのパラメータ表は、Debug.md に移行されています。

一般的な使用例（CLI）

コマンドラインの使用例は、Debug.md に移行されています。

API 呼び出し（FastAPI / fastmcp 2.0）

server.py が提供されており、AI/HTTP からの呼び出し用のローカルサービスとして使用できます。

• サービスの起動

uvicorn server:app --host 127.0.0.1 --port 8000

• メッセージ送信インターフェイス：POST http://127.0.0.1:8000/send

{
  "friends": ["文件传输助手"],
  "messages": ["测试一下"],
  "backend": "win32",
  "ctrl_enter": false,
  "friend_delay": 0.5,
  "message_delay": 0.2,
  "no_launch": false,
  "verbose": true
}

• コントロールエクスポートインターフェイス：POST http://127.0.0.1:8000/dump

{
  "backend": "win32",
  "verbose": true
}

説明：スクリプトの本体は script/wechat_sender.py にあります。コマンドラインの使用説明は Debug.md を参照してください。HTTP インターフェイスは server.py で提供されています。

fastmcp（MCP/stdio プロトコル）を使用する場合

mcp_server.py（fastmcp 2.0 ベース）が提供されています。これは MCP サーバーで、標準入出力（stdio）を介してツールを公開します。内部では、ツールの呼び出しを上記の HTTP サービスに転送します。

1. 依存関係のインストールと HTTP サービスの起動

pip install -r requirements.txt
uvicorn server:app --host 127.0.0.1 --port 8000

2. MCP サーバー（stdio）の起動

python mcp_server.py

3. MCP Inspector での接続（廃止）

mcp-inspector --server "python mcp_server.py"

ツールの説明：

• send_messages(friends, messages, backend='uia'|'win32', ctrl_enter=False, friend_delay=0.5, message_delay=0.2, no_launch=False, verbose=False)
• dump_controls(backend='uia'|'win32', verbose=True)

使用可能な環境変数：

• WEIXIN_API_URL：転送先の HTTP サービスのアドレス（デフォルトは http://127.0.0.1:8000）

MCP Inspector の設定

1. HTTP サービスの起動（新しいターミナル）

uvicorn server:app --host 127.0.0.1 --port 8000

npx @modelcontextprotocol/inspector

2. MCP Inspector での入力

• Server command:

python mcp_server.py

• Working Directory:

D:\代码存储\winautowx

• Environment variables（オプション）：
  • WEIXIN_API_URL: http://127.0.0.1:8000
• Arguments: 空白のまま
• Transport: デフォルトの stdio（変更しないでください）
• Connect をクリック

3. Inspector でのツール呼び出し

• send_messages のサンプルパラメータ：

{
  "friends": ["文件传输助手"],
  "messages": ["测试一下"],
  "backend": "win32",
  "ctrl_enter": false,
  "friend_delay": 0.5,
  "message_delay": 0.2,
  "no_launch": false,
  "verbose": true
}

• dump_controls のサンプルパラメータ：

{
  "backend": "win32",
  "verbose": true
}

💡 使用例

基本的な使用法

このスクリプトを使用することで、Windows 上で微信を自動化してメッセージを送信することができます。

# サービスの起動
uvicorn server:app --host 127.0.0.1 --port 8000
# メッセージの送信
curl -X POST "http://127.0.0.1:8000/send" -H "Content-Type: application/json" -d '{"friends": ["文件传输助手"], "messages": ["测试一下"], "backend": "win32", "ctrl_enter": false, "friend_delay": 0.5, "message_delay": 0.2, "no_launch": false, "verbose": true}'

高度な使用法

複数の友達に複数のメッセージを循環送信することができます。

# サービスの起動
uvicorn server:app --host 127.0.0.1 --port 8000
# 複数のメッセージを複数の友達に送信
curl -X POST "http://127.0.0.1:8000/send" -H "Content-Type: application/json" -d '{"friends": ["友達1", "友達2"], "messages": ["メッセージ1", "メッセージ2"], "backend": "win32", "ctrl_enter": false, "friend_delay": 0.5, "message_delay": 0.2, "no_launch": false, "verbose": true}'

💡 使用アドバイス

• 微信のメインウィンドウを現在のデスクトップに表示し、最小化しないでください。
• 最初に「文件传输助手」でプロセスを検証し、他人を迷惑させないようにしてください。
• 新版の Weixin（プロセス Weixin.exe）を使用している場合、スクリプトは対応しています。
• 特殊なレイアウトや企業版の微信では、コントロールの構造が異なる場合があります。問題が発生した場合は、--verbose を有効にして出力をコピーして報告してください。

⚠️ 免責事項

このスクリプトは学習と個人の効率化を目的として使用されることを想定しています。関連プラットフォームの利用規約を遵守し、自動化操作の乱用を避けてください。