wechat hook 。支持3.8.0.41,3.8.1.26, 3.9.0.28, 3.9.2.23版本。
Go to file
2023-01-31 16:50:18 +08:00
python init commit 2022-12-21 20:30:44 +08:00
src 新增修改群昵称 2023-01-31 16:10:58 +08:00
tool/injector 注入dll 2022-12-26 16:53:26 +08:00
.gitignore 注入dll 2022-12-26 16:53:26 +08:00
CMakeLists.txt 修改cmake变量,构建更通用 2023-01-04 09:55:45 +08:00
README.md 修改文档错误描述 2023-01-31 16:50:18 +08:00

wxhelper

wechat hook 。PC端微信逆向学习。支持3.8.0.413.8.1.26版本。

免责声明:

本仓库发布的内容,仅用于学习研究,请勿用于非法用途和商业用途!如因此产生任何法律纠纷,均与作者无关!

项目说明:

本项目是个人学习学习逆向的项目,主要参考https://github.com/ttttupup/ComWeChatRobot在此基础上实现了微信的的其它版本的部分内容

使用说明:

支持的版本3.8.0.413.8.1.26。 src:主要的dll代码 tool简单的注入工具一个是控制台一个是图形界面。 python: 简单的服务器,用以接收消息内容。 release编译好的dll。

0.首先安装对应的微信版本主分支是3.8.0.41版本3.8.1.26分支对应3.8.1.26版本。
1.通过cmake构建成功后将wxhelper.dll注入到微信本地启动tcp server监听19088端口。
2.通过http协议与dll通信方便客户端操作。
3.接口的url为http://127.0.0.1:19088注入成功后直接进行调用即可。
4.特别注意数据库查询接口需要先调用获取到句柄之后,才能进行查询。
5.相关功能只在win11环境下进行简单测试其他环境无法保证。
6.注意个别接口在3.8.0.41版本没有实现,具体参考源码。

编译环境

Visual Studio 2022(x86)

Visual Studio code

cmake

vcpkg

构建步骤

以下是在vscode中操作vs中的操作类似。
1.安装vcpkgcmakevscode

2.安装相应的库如果安装的版本不同则根据vcpkg安装成功后提示的find_package修改CMakeLists.txt内容即可。或者自己编译。

    vcpkg  install mongoose  
    vcpkg  install nlohmann-json

3.vscode 配置CMakePresets.json,主要设置CMAKE_C_COMPILER 和CMAKE_CXX_COMPILER 为cl.exe.参考如下

 {
            "name": "x86-release",
            "displayName": "x86-release",
            "description": "Sets Ninja generator, build and install directory",
            "generator": "Ninja",
            "binaryDir": "${sourceDir}/out/build/${presetName}",
            "architecture":{
                "value": "x86",
                "strategy": "external"
            },
            "cacheVariables": {
                "CMAKE_C_COMPILER": "cl.exe",
                "CMAKE_CXX_COMPILER": "cl.exe",
                "CMAKE_BUILD_TYPE": "Release",
                "CMAKE_INSTALL_PREFIX": "${sourceDir}/out/install/${presetName}",
                "CMAKE_TOOLCHAIN_FILE": {
                    "value": "C:/soft/vcpkg/scripts/buildsystems/vcpkg.cmake",
                     "type": "FILEPATH"
                  }
            },
            "environment": {

            }
          
        }

4.vscode中右键configure all projects,在Terminal中点击Run Task如没有先配置build任务然后运行即可

更新说明

2022-12-26 增加3.8.1.26版本支持。

2022-12-29 新增提取文字功能。

2022-01-02 退出微信登录。

2022-01-31 新增修改群昵称仅支持3.8.1.26)。

接口文档:

0.检查微信登录**

接口功能

检查微信是否登录

接口地址

/api/?type=0

HTTP请求方式

POST JSON

请求参数
参数 必选 类型 说明
返回字段
返回字段 字段类型 说明
code int 返回状态,1 成功, 0失败
result string 成功提示
data string 响应内容
接口示例

入参:

响应:

{
    "code": 1,
    "result": "ok"
}

1.获取登录用户信息**

接口功能

获取登录用户信息

接口地址

/api/?type=1

HTTP请求方式

POST JSON

请求参数
参数 必选 类型 说明
返回字段
返回字段 字段类型 说明
code int 返回状态,1 成功, 0失败
result string 成功提示
data object 响应内容
account string 账号
bigImage string 头像大图
city string 城市
country string 国家
currentDataPath string 当前数据目录
dataRootPath string 根目录
dataSavePath string 保存目录
mobile string 手机
name string 昵称
province string
smallImage string 小头像
wxid string wxid
接口示例

入参:

响应:

{"code":1,"data":{"account":"xx","bigImage":"https://wx.qlogo.cn/mmhead/ver_1xx","city":"xx","country":"CN","currentDataPath":"xxx","dataRootPath":"C:\\xx","dataSavePath":"C:\\xx","mobie":"13949175447","name":"xx","province":"xx","smallImage":"xx","wxid":"xx"},"result":"OK"}

2.发送文本消息**

接口功能

发送文本消息

接口地址

/api/?type=2

HTTP请求方式

POST JSON

请求参数
参数 必选 类型 说明
wxid ture string 接收人wxid
msg true string 消息文本内容
返回字段
返回字段 字段类型 说明
code int 返回状态,不为0成功, 0失败
result string 成功提示
接口示例

入参:

{
    "wxid": "filehelper",
    "msg": "1112222"
}

响应:

{"code":345686720,"result":"OK"}

5.发送图片消息**

接口功能

发送图片消息

接口地址

/api/?type=5

HTTP请求方式

POST JSON

请求参数
参数 必选 类型 说明
wxid ture string 接收人wxid
imagePath true string 图片路径
返回字段
返回字段 字段类型 说明
code int 返回状态,不为0成功, 0失败
result string 成功提示
接口示例

入参:

{
    "wxid": "filehelper",
    "imagePath": "C:/Users/123.png"
}

响应:

{"code":345686724,"result":"OK"}

6.发送文件消息**

接口功能

发送文件

接口地址

/api/?type=6

HTTP请求方式

POST JSON

请求参数
参数 必选 类型 说明
wxid ture string 接收人wxid
filePath true string 文件路径
返回字段
返回字段 字段类型 说明
code int 返回状态,1成功, 0失败
result string 成功提示
接口示例

入参:

{
    "wxid": "filehelper",
    "filePath": "C:/Users/123.txt"
}

响应:

{"code":1,"result":"OK"}

9.hook消息**

接口功能

hook接收文本消息图片消息群消息.该接口将hook的消息通过tcp回传给本地的端口

接口地址

/api/?type=9

HTTP请求方式

POST JSON

请求参数
参数 必选 类型 说明
port ture string 本地服务端端口,用来接收消息内容
返回字段
返回字段 字段类型 说明
code int 返回状态,1成功, 0失败
result string 成功提示
接口示例

入参:

{
    "port": "19099"
}

响应:

{"code":1,"result":"OK"}

11.hook图片**

接口功能

hook图片原始内容不推荐该接口可以使用图片查询接口

接口地址

/api/?type=11

HTTP请求方式

POST JSON

请求参数
参数 必选 类型 说明
imgDir ture string 图片保存的目录
返回字段
返回字段 字段类型 说明
code int 返回状态,1成功, 0失败
result string 成功提示
接口示例

入参:

{
    "imgDir":"C:\\other"
}

响应:

{"code":1,"result":"OK"}

17.删除好友**

接口功能

删除好友

接口地址

/api/?type=17

HTTP请求方式

POST JSON

请求参数
参数 必选 类型 说明
wxid ture string 好友wxid
返回字段
返回字段 字段类型 说明
code int 返回状态,1成功, 0失败
result string 成功提示
接口示例

入参:

{
    "wxid":"wxid_o"
}

响应:

{"code":1,"result":"OK"}

25.获取群成员**

接口功能

获取群成员

接口地址

/api/?type=25

HTTP请求方式

POST JSON

请求参数
参数 必选 类型 说明
chatRoomId ture string 群id
返回字段
返回字段 字段类型 说明
code int 返回状态,1成功, 0失败
result string 成功提示
data object 返回内容
admin string 群主id
chatRoomId string 群id
members string 群成员id以^分隔
接口示例

入参:

{
    "chatRoomId":"123@chatroom"
}

响应:

{"code":1,"data":{"admin":"wxid","chatRoomId":"123@chatroom","members":"wxid_123^Gwxid_456^Gwxid_45677"},"result":"OK"}

27.删除群成员**

接口功能

删除群成员

接口地址

/api/?type=27

HTTP请求方式

POST JSON

请求参数
参数 必选 类型 说明
chatRoomId ture string 群id
memberIds ture string 成员id以,分割
返回字段
返回字段 字段类型 说明
code int 返回状态,1成功, 0失败
result string 成功提示
接口示例

入参:

{
    "chatRoomId":"34932563384@chatroom",
    "memberIds":"wxid_oyb662qhop4422"
}

响应:

{"code":1,"result":"OK"}

28.增加群成员**

接口功能

增加群成员

接口地址

/api/?type=28

HTTP请求方式

POST JSON

请求参数
参数 必选 类型 说明
chatRoomId ture string 群id
memberIds ture string 成员id以,分割
返回字段
返回字段 字段类型 说明
code int 返回状态,1成功, 0失败
result string 成功提示
接口示例

入参:

{
    "chatRoomId":"34932563384@chatroom",
    "memberIds":"wxid_oyb662qhop4422"
}

响应:

{"code":1,"result":"OK"}

31.修改自身群昵称**

接口功能

修改群名片

接口地址

/api/?type=31

HTTP请求方式

POST JSON

请求参数
参数 必选 类型 说明
chatRoomId ture string 群id
wxid ture string 自己的id只能修改自己的群名片
nickName ture string 修改的昵称
返回字段
返回字段 字段类型 说明
code int 返回状态,1成功, 0失败
result string 成功提示
接口示例

入参:

{
    "chatRoomId":"34932563384@chatroom",
    "wxid":"wxid_272211111121112",
    "nickName":"昵称test"
}

响应:

{"code":1,"result":"OK"}

32.获取数据库句柄**

接口功能

获取sqlite3数据库句柄

接口地址

/api/?type=32

HTTP请求方式

POST JSON

请求参数
参数 必选 类型 说明
返回字段
返回字段 字段类型 说明
code int 返回状态,1成功, 0失败
result string 成功提示
data array 返回数据
databaseName string 数据库名称
handle int 数据库句柄
tables array 表信息
name string 表名
rootpage string rootpage
sql string sql
tableName string tableName
接口示例

入参:


响应:

{
  "data": [
    {
      "databaseName": "MicroMsg.db",
      "handle": 119561688,
      "tables": [
        {
          "name": "Contact",
          "rootpage": "2",
          "sql": "CREATE TABLE Contact(UserName TEXT PRIMARY KEY ,Alias TEXT,EncryptUserName TEXT,DelFlag INTEGER DEFAULT 0,Type INTEGER DEFAULT 0,VerifyFlag INTEGER DEFAULT 0,Reserved1 INTEGER DEFAULT 0,Reserved2 INTEGER DEFAULT 0,Reserved3 TEXT,Reserved4 TEXT,Remark TEXT,NickName TEXT,LabelIDList TEXT,DomainList TEXT,ChatRoomType int,PYInitial TEXT,QuanPin TEXT,RemarkPYInitial TEXT,RemarkQuanPin TEXT,BigHeadImgUrl TEXT,SmallHeadImgUrl TEXT,HeadImgMd5 TEXT,ChatRoomNotify INTEGER DEFAULT 0,Reserved5 INTEGER DEFAULT 0,Reserved6 TEXT,Reserved7 TEXT,ExtraBuf BLOB,Reserved8 INTEGER DEFAULT 0,Reserved9 INTEGER DEFAULT 0,Reserved10 TEXT,Reserved11 TEXT)",
          "tableName": "Contact"
        }
      ]
    }
  ],
  "result": "OK"
}

34.查询数据库**

接口功能

查询数据库

接口地址

/api/?type=34

HTTP请求方式

POST JSON

请求参数
参数 必选 类型 说明
dbHandle ture int 句柄
sql ture string sql语句
返回字段
返回字段 字段类型 说明
code int 返回状态,1成功, 0失败
result string 成功提示
data array 返回数据
接口示例

入参:

{
    "dbHandle": 219277920,
    "sql":"select * from MSG where MsgSvrID=8985035417589024392"
}

响应:

{"code":1,"data":[["localId","TalkerId","MsgSvrID","Type","SubType","IsSender","CreateTime","Sequence","StatusEx","FlagEx","Status","MsgServerSeq","MsgSequence","StrTalker","StrContent","DisplayContent","Reserved0","Reserved1","Reserved2","Reserved3","Reserved4","Reserved5","Reserved6","CompressContent","BytesExtra","BytesTrans"],["6346","24","8985035417589024392","1","0","0","1670897832","1670897832000","0","0","2","1","778715089","wxid_1222","112","","0","2","","","","","","","CgQIEBAAGkEIBxI9PG1zZ3NvdXJjZT4KCTxzaWduYXR1cmU+djFfSFFyeVAwZTE8L3NpZ25hdHVyZT4KPC9tc2dzb3VyY2U+ChokCAISIDU5NjI1NjUxNWE0YzU2ZDQxZDJlOWMyYmIxMjFhNmZl",""]],"result":"OK"}

44.退出登录**

接口功能

退出登录微信相当于直接退出微信跟手动退出比少了重新打开登录的一步dll注入后也会随微信关闭而关闭。调用后不能再继续操作dll。

接口地址

/api/?type=44

HTTP请求方式

POST JSON

请求参数
参数 必选 类型 说明
返回字段
返回字段 字段类型 说明
code int 返回状态,非0成功
result string 成功提示
接口示例

入参:


响应:

{"code":4344,"result":"OK"}

46.联系人列表**

接口功能

联系人列表

接口地址

/api/?type=46

HTTP请求方式

POST JSON

请求参数
参数 必选 类型 说明
返回字段
返回字段 字段类型 说明
code int 返回状态,1成功, 0失败
result string 成功提示
data array 返回内容
customAccount string 自定义账号
delFlag int 删除标志
type int 好友类型
userName string 用户名称
verifyFlag int 验证
wxid string wxid
接口示例

入参:

{
    "wxid": "filehelper",
    "msgid":7215505498606506901
}

响应:

{"code":1,"data":[{"customAccount":"custom","delFlag":0,"type":8388611,"userName":"昵称","verifyFlag":0,"wxid":"wxid_123pcqm22"}]}

47.群详情**

接口功能

获取群详情

接口地址

/api/?type=47

HTTP请求方式

POST JSON

请求参数
参数 必选 类型 说明
chatRoomId ture string 群id
返回字段
返回字段 字段类型 说明
code int 返回状态,1成功, 0失败
result string 成功提示
data object 返回内容
admin string 群主id
chatRoomId int 群id
notice int 通知
xml string xml
接口示例

入参:

{
    "wxid": "filehelper",
    "msgid":7215505498606506901
}

响应:

{"code":1,"data":{"admin":"123","chatRoomId":"123@chatroom","notice":"1222","xml":""},"result":"OK"}

48.获取解密图片**

接口功能

获取解密图片

接口地址

/api/?type=48

HTTP请求方式

POST JSON

请求参数
参数 必选 类型 说明
imagePath ture string 图片路径
savePath ture string 保存路径
返回字段
返回字段 字段类型 说明
code int 返回状态,1成功, 0失败
result string 成功提示
接口示例

入参:

{
    "imagePath":"C:\\3a610d7bc1cf5a15d12225a64b8962.dat",
    "savePath":"C:\\other"
}

响应:

{"code":1,"result":"OK"}

49.提取文字**

接口功能

提取图片中的文字

接口地址

/api/?type=49

HTTP请求方式

POST JSON

请求参数
参数 必选 类型 说明
imagePath ture string 图片路径
返回字段
返回字段 字段类型 说明
code int 返回状态,0成功, -1失败1 2 则是缓存或者正在进行中需再调用一次
result string 成功提示
text string 提取的相应文字
接口示例

入参:

{
    "imagePath":"C:\\3a610d7bc1cf5a15d12225a64b8962.dat"
}

响应:

{"code":0,"result":"OK","text":"搜索商品新闻简报小程序上线啦!!!我的收藏地址管理促销单品多买多省热门榜单热门榜单首发新品精品推荐精品推荐首发新品FRONTI警微安奈儿 童装冬季款男¥39900¥59.90帕拉丁品牌 时尚双背包409 00¥49.90我是有底线的首页分类购物车我的"}

感谢

https://github.com/ljc545w/ComWeChatRobot

https://github.com/NationalSecurityAgency/ghidra

https://github.com/x64dbg/x64dbg