repository·master·Indexed 42 days ago
https://github.com/scottfly189/wechatauto.sdkA modern RPA framework for WeChat automation optimized for AI/LLM integration. It supports .NET and Python, offering automation strategies like UI Tree and Hybrid OCR (via RapidOCRCSharp) for WeChat versions 4.1.xx and 3.9.12.xx. Features include message listening, social capabilities, group management, and a WebSocket server to bridge .NET functionality to other languages. Includes a Python community edition package (wechat-auto4x-sdk v1.0.0).
WebChatAuto.SDK Web Support extends the core SDK by providing a Visual UI and a REST API service. This allows developers to control the WeChat client via HTTP requests.
To mitigate WeChat risk control (anti-spam) measures, the system implements a "pooling" mechanism for outgoing messages. This means messages are queued and sent at a controlled rate, making it suitable for high-volume batch messaging without the risk of being logged out due to high frequency.
The wechat-auto4x-sdk is the Python community edition of the WeChatAuto.SDK. It is designed for modern AI-oriented WeChat RPA (Robotic Process Automation) and supports the latest WeChat versions, including 4.1.10.xx and 4.1.11.xx series.
For core framework details and full documentation, refer to the main WeChatAuto.SDK repository.
The SDK provides two distinct automation paths depending on the WeChat version:
onnx-runtime models via RapidOCRCSharp.Frequent automated operations may trigger WeChat's risk control mechanisms. To mitigate this:
PostMessage), use hardware simulators to mimic real human input. This is highly recommended for high-sensitivity operations like adding friends.To use the latest WeChat 4.x automation in a .NET project:
.csproj targets a Windows-specific framework (e.g., net10.0-windows, net6.0-windows, or net7.0-windows).dotnet add package Microsoft.Extensions.DependencyInjection
dotnet add package WeChatAuto4x.SDKmodels folder in your project root.WeAutomation.Initialize with EnableOCR = true to start the service.using WeChatAuto.Services;
using WeChatAuto.Components;
using Microsoft.Extensions.DependencyInjection;
var serviceProvider = WeAutomation.Initialize(options =>
{
options.DebugMode = false; // Optional
options.EnableOCR = true; // Required for 4.x
});
using var clientFactory = serviceProvider.GetRequiredService<WeChatClientFactory>();
// Check available WeChat clients
var wechat_list = clientFactory.GetWeChatClientNames();
Console.WriteLine($"Open WeChat clients: {string.Join(',', wechat_list)}");
// Open the first client and send a message
var client = clientFactory.GetWeChatClient(wechat_list.First());
await client.SendMessage("AI.Net_test", "hello world!!");Follow these steps to integrate WeChat automation via REST API:
3.9.12.xx. This specific release is built for this version.http://localhost:5000. You can access the Swagger UI at http://localhost:5000/swagger to view available endpoints and test them manually.http://localhost:5000/swaggerThe repository provides two versions of the WebSocket Server depending on your deployment needs:
The Python SDK communicates with a WebSocket Server and does not require .NET installed on the client machine.
WeChatAuto4x.SDK WebSocket Server.Server.exe. It typically listens on http://localhost:5000. uv init demo-python
cd demo-python
uv add wechat-auto4x-sdk3. **Implement Automation**:
Connect to the server using `WechatFactory.create_factory` with a WebSocket URI (e.g., `ws://localhost:5000/ws`).
```python
import asyncio
from wechat_auto_sdk import WeChatClient
from wechat_auto_sdk import WeChatConfig
from wechat_auto_sdk import WechatFactory
DEFAULT_URI = "ws://localhost:5000/ws"
async def wechat_automation():
async with WechatFactory.create_factory(DEFAULT_URI, WeChatConfig()) as factory:
await factory.initialize()
wechat_list = factory.client_list
print(f"Connected to {len(wechat_list)} clients: {list(wechat_list.keys())}")
# Access a specific client by name
client: WeChatClient = wechat_list["Alex"]
# Send message with @mentions
await client.send_message(
"DroidMirror官方技术支持",
"hello world!",
at_user=["AI.Net_test", "智影工坊"]
)
if __name__ == "__main__":
asyncio.run(wechat_automation())For detailed documentation, API references, and comprehensive guides regarding WeChatAuto.SDK version 3.9.12.xx, please refer to the official documentation website.
https://scottfly189.github.io/WeChatAuto.SDK/If the example automation fails to control the WeChat client, perform the following checks:
inspect.exe or FlaUInspect (available in the project's Tools directory).If these steps do not resolve the issue, contact the author with your code for assistance.