WxHook是一个基于dll注入实现的python微信机器人框架，支持多种接口、高扩展性、多线程消息处理，让你轻松应对海量消息，为你的需求实现提供便捷灵活的支持。
支持的接口
- hook同步消息
- 取消hook同步消息
- hook日志
- 取消hook日志
- 检查登录状态
- 获取用户信息
- 发送文本消息
- 发送图片消息
- 发送文件消息
- 发送表情消息
- 发送小程序消息
- 发送群@消息
- 发送拍一拍消息
- 获取联系人列表
- 获取联系人详情
- 创建群聊
- 退出群聊
- 获取群详情
- 获取群成员列表
- 添加群成员
- 删除群成员
- 邀请群成员
- 修改群成员昵称
- 设置群置顶消息
- 移除群置顶消息
- 转发消息
- 获取朋友圈首页
- 获取朋友圈下一页
- 收藏消息
- 收藏图片
- 下载附件
- 转发公众号消息
- 转发公众号消息通过消息ID
- 解码图片
- 获取语音通过消息ID
- 图片文本识别
- 获取数据库句柄
- 执行SQL命令
- 测试
pip install wxhook# import os
# os.environ["WXHOOK_LOG_LEVEL"] = "INFO" # 修改日志输出级别
# os.environ["WXHOOK_LOG_FORMAT"] = "<green>{time:YYYY-MM-DD HH:mm:ss}</green> | <level>{message}</level>" # 修改日志输出格式
from wxhook import Bot
from wxhook import events
from wxhook.model import Event
def on_login(bot: Bot, event: Event):
print("登录成功之后会触发这个函数")
def on_start(bot: Bot):
print("微信客户端打开之后会触发这个函数")
def on_stop(bot: Bot):
print("关闭微信客户端之前会触发这个函数")
def on_before_message(bot: Bot, event: Event):
print("消息事件处理之前")
def on_after_message(bot: Bot, event: Event):
print("消息事件处理之后")
bot = Bot(
# faked_version="3.9.10.19", # 解除微信低版本限制
on_login=on_login,
on_start=on_start,
on_stop=on_stop,
on_before_message=on_before_message,
on_after_message=on_after_message
)
# 消息回调地址
# bot.set_webhook_url("http://127.0.0.1:8000")
@bot.handle(events.TEXT_MESSAGE)
def on_message(bot: Bot, event: Event):
bot.send_text("filehelper", "hello world!")
bot.run()QQ交流群：705791428
开源版本：
微信3.9.5.81版本开发框架项目地址：https://github.com/miloira/wxhook
微信3.9.2.23版本开发框架项目地址：https://github.com/miloira/wxhelper
同时支持微信3.x版本和4.x版本的微信机器人框架
支持接口
- 刷新登录二维码
- 退出登录
- 退出微信
- 获取当前账号信息
- 获取好友列表
- 获取好友信息
- 获取群列表
- 获取群信息
- 获取群成员列表
- 获取公众号列表
- 获取好友简要信息（协议）
- 获取群成员信息
- 发送文本消息
- 发送群at消息
- 发送名片消息
- 发送链接卡片消息
- 发送图片消息
- 发送文件消息
- 发送视频消息
- 发送表情消息
- 发送xml消息
- 发送拍一拍消息
- 转发消息
- 获取好友详细信息（协议）
- 获取多个好友信息（协议）
- 修改好友备注
- 删除好友
- 同意好友请求
- 搜索微信好友
- 添加好友
- 添加好友分享的名片
- 添加群成员为好友
- 检查好友状态
- 获取群信息（协议）
- 获取群成员邀请关系
- 创建群聊
- 创建群聊（协议）
- 添加群成员
- 邀请群成员
- 移出群成员
- 修改群名称
- 修改群公告
- 修改我在本群的昵称
- 是否显示群成员昵称
- 保存/移出通讯录
- 退出群聊
- 获取企业联系人
- 获取企业群
- 获取企业微信群成员
- 初始化CDN
- CDN上传
- CDN下载
- 企业微信CDN下载
- 发送文本消息（CDN）
- 发送群at消息（CDN）
- 发送图片消息（CDN）
- 发送视频消息（CDN）
- 发送文件消息（CDN）
- 发送链接卡片消息（CDN）
- 发送表情消息（CDN）
- 发送表情消息2（CDN）
- 发送小程序消息（CDN）
- 发送视频号消息（CDN）
- 发送名片消息（CDN）
- 发送位置消息（CDN）
- 撤回消息（CDN）
- 发送xml消息（CDN）
- 获取收藏列表
- 发送收藏消息
- 收藏消息
- 获取标签列表
- 确认收款
- 添加标签
- 删除标签
- 修改标签
- 批量给用户加标签
- 获取联系人所有标签
- 语音消息转文本
- 切换当前会话
- 清除聊天记录
- 开启/关闭消息免打扰
- 置顶/取消置顶聊天
- 获取小程序授权code
- 获取朋友圈
- 获取好友朋友圈
- 评论
- 点赞
- 发朋友圈
- 上传图片
- 视频号初始化
- 视频号搜索
- 视频号用户主页
- 查看视频详细信息(包含评论)
- 关注博主
- 视频号点赞
- 获取私信sessionId
- 发送私信
- 创建虚拟昵称
- 切换虚拟昵称
- 删除虚拟昵称
- 进入直播间
- 获取直播间在线人员
- 获取直播间变动信息(人气，实时发言等)
- 直播间发言
- 直播间点赞
- 获取直播间货架
- 获取货架商品详细信息
- A8Key接口
- 自动同意好友申请
- 自动同意好友转账
- 自动同意加群邀请
- 自动加名片
- 解密图片
- 执行SQL命令
使用须知
- 微信号头像必须设置，否则框架无法正常运行。
- 微信
4.x版本首次使用本框架，请运行示例代码调起微信后扫码登录。
from loguru import logger
logger.remove()
from pywechat import WeChat, events
from pywechat.utils import go_wechat3
# 支持微信版本 3.6.0.18/3.9.10.19/3.9.10.27/3.9.11.17/3.9.12.15/3.9.12.45/4.0.1.21/4.0.3.22/4.1.0.34/4.1.2.17
wechat = WeChat("4.1.2.17")
@wechat.handle(events.WINDOW_HANDLE_CHANGE_MESSAGE)
def _(bot: WeChat, event: dict):
# 解除微信3.x登录低版本限制
if bot.version.startswith("3") and event["data"].get("login_hwnd"):
go_wechat3(event["data"]["pid"], "all", "Windows 11 x64", "Windows 10 x86", bot.version, "3.9.12.56")
bot.refresh_qrcode(event["client_id"])
@wechat.handle(events.USER_LOGIN_MESSAGE)
def _(bot: WeChat, event: dict):
print(f"已登录：{event}")
@wechat.handle(events.USER_LOGOUT_MESSAGE)
def _(bot: WeChat, event: dict):
print(f"已退出登录：{event}")
@wechat.handle(events.TEXT_MESSAGE)
def _(bot: WeChat, event: dict):
print(f"收到文本消息：{event}")
wechat.run()特色功能
1.支持不同微信版本
2.微信3.x登录出现低版本可自动解除