veikai / pywechatspy Goto Github PK

View Code? Open in Web Editor NEW

471.0 21.0 181.0 17.4 MB

A spy program that helps people make better use of WeChat

License: Apache License 2.0

Python 100.00%

pywechatspy's Introduction

PyWeChatSpy

help people make better use of WeChatForPC

支持微信版本

3.0.0.57

微信客户端下载：https://pan.baidu.com/s/1FIHQ4BCkpTSC-7QHk13LHw 提取码: v2n3

功能列表

基础功能

推送聊天消息 CHAT_MESSAGE
- 回调结构 ChatMessage
获取登录账号信息 get_account_details
- 回调结构 AccountDetails
发送文本 send_text
- 入参
  - wxid 文本消息接收方wxid
  - text 文本内容
  - at_wxid 需要被@的wxid(仅限群聊) at几个人,文本里就需要出现几个'@'符号 spy.send_text('xxxx@chatroom', '@0000 @1111 Hello World', 'wxid_xxxx,wxid_yyyy')
发送文件、图片 send_file
- 入参
  - wxid 文件接收方wxid
  - file_path 文件路径
解密微信图片文件 decrypt_image(微信的图片下载到本地是加密的，需要使用此方法解密后方能看到图片原始内容)
- 入参
  - source_file 带解密图片文件
  - target_file 解密后图片保存路径

高级功能

获取联系人列表 get_contacts(获取所有联系人，包括好友与群，不活跃的群可能无法获取)
- 回调类型 CONTACTS_LIST
- 回调结构 Contacts
获取联系人详情、群成员列表 get_contact_details
- 入参
  - 联系人wxid
- 回调类型 CONTACT_DETAILS
- 回调结构 Contacts
发送群公告 send_announcement
- 入参
  - wxid 群wxid
  - content 公告内容
自动通过好友请求 accept_new_contact
- 入参
  - encryptusername 好友请求Xml消息结构体同名字段值
  - ticket 好友请求Xml消息结构体同名字段值
设置联系人备注 set_remark
- 入参
  - wxid 联系人wxid
  - remark 备注内容
分享群聊 share_chatroom
- 入参
  - chatroom_wxid 待分享群聊wxid
  - wxid 联系人wxid
移除群成员 remove_chatroom_member
- 入参
  - chatroom_wxid 待移除成员群聊wxid
  - wxid 待移除群聊成员wxid
移除联系人 remove_contact
- 入参
  - wxid 待移除联系人wxid
发送小程序 send_mini_program
- 入参
  - wxid 接收方wxid
  - title 小程序标题
  - image_path 小程序封面
  - route 小程序跳转路由，抓包小程序消息获取pagepath或自行生成
  - app_id 小程序AppId
  - username 小程序源Id
  - weappiconurl 小程序图标url
  - appname 小程序名称
发送链接卡片 send_link_card
- 入参
  - wxid 接收方wxid
  - title 卡片标题
  - desc 卡片描述
  - app_id 卡片AppId
  - url 卡片跳转url
  - image_path 卡片封面图片路径
创建群聊 create_chatroom
- 入参
  - wxid 创建群聊拉取的联系人wxid，不包括自己，至少连个，英文逗号分隔
- 回调结构 CreateGroupCallback
设置群名称 set_chatroom_name
- 入参
  - wxid 待改名群聊wxid
  - name 群聊名称
推送群成员详情 GROUP_MEMBER_DETAILS
- 回调结构 GroupMemberDetails
推送群成员变动(进群&退群) GROUP_MEMBER_EVENT
- 回调结构 GroupMemberEvent
获取登录二维码 get_login_qrcode
- 回调结构 LoginQRCode
发送个人名片 send_card
- 入参
  - wxid 名片接收wxid
  - card_wxid 名片wxid
  - card_nickname 名片显示昵称

数据结构

登录信息 AccountDetails `account_details = spy_pb2.AccountDetails()`

wxid 登录账号wxid account_details.wxid
nickname 登录账号昵称 account_details.nickname
wechatid 登录账号微信号 account_details.wechatid
autograph 登录账号签名 account_details.autograph
profilePhotoHD 登录账号高清头像 account_details.profilePhotoHD
profilePhoto 登录账号头像 account_details.profilePhoto
phone 登录账号绑定手机号 account_details.phone
email 登录账号绑定邮箱 account_details.email
qq 登录账号绑定QQ account_details.qq
sex 登录账号性别 1男/2女 account_details.sex
city 登录账号所在城市 account_details.city
province 登录账号所在省份 account_details.province
country 登录账号所在国家 account_details.country

Contacts 联系人列表 `contacts_list = spy_pb2.Contacts()`

contactDetails 联系人详情(可遍历) for contact in contacts_list.contactDetails
- wxid 联系人wxid结构 contact.wxid
  - str 联系人wxid contact.wxid.str
- nickname 联系人昵称结构 contact.nickname
  - str 联系人昵称 contact.nickname.str
- sex 联系人性别 1男/2女 contact.sex
- remark 联系人备注结构 contact.remark
  - str 联系人备注 contact.remark.str
- wechatId 联系人微信号 contact.wechatId
- groupOwnerWxid 群主wxid(如果联系人是群聊 wxid以"@chatroom"结尾) cotact.groupOwnerWxid
- profilePhotoHD 联系人高清头像 cotact.profilePhotoHD
- profilePhoto 联系人头像 contact.profilePhoto
- groupMemberList 群成员列表(如果联系人是群聊 wxid以"@chatroom"结尾) contact.groupMemberList
  - memberCount 群成员数量 contact.groupMemberList.memberCount
  - groupMember 群成员信息(可遍历) for member in contacts_list.contactDetails.groupMemberList.groupMember
    - wxid 群成员wxid member.wxid
    - nickname 群成员昵称 member.nickname

ChatMessage 微信消息 `chat_message = spy_pb2.ChatMessage()`

message 微信消息(可遍历) for message in chat_message.message
- wxidFrom 消息发送方wxid结构 message.wxidFrom
  - str 消息发送方wxid message.wxidFrom.str
- wxidTo 消息接收方wxid结构 message.wxidTo
  - str 消息接收方 message.wxidTo.str
- type 消息类型 1文本3图片43视频49Xml37好友请求10000系统消息... message.type
- content 消息内容结构 message.content
  - str 消息内容 message.content.str
- timestamp 消息时间戳 message.timestamp
- head 消息头 message.head
- file 消息附带文件(图片、视频等) message.file

GroupMemberDetails 群成员详情 `group_member_details = spy_pb2.GroupMemberDetails()`

wxid 群wxid group_member_details.wxid
detailsCount 详情数量(非群成员数量) group_member_details.detailsCount
groupMemberDetails 群成员详情(可遍历) for member_details in group_member_details.groupMemberDetails
- wxid 群成员wxid member_details.wxid
- nickname 群成员昵称 member_details.nickname
- groupNickname 群成员群内昵称 member_details.groupNickname
- profilePhotoHD 群成员高清头像 member_details.profilePhotoHD
- profilePhoto 群成员头像 member_details.profilePhoto
- inviterWxid 群成员邀请人wxid member_details.inviterWxid

GroupMemberEvent 群成员变动事件 `group_member_event = spy_pb2.GroupMemberEvent()`

wxid 群wxid group_member_event.wxid
wxidJoin 进群wxid(可遍历) for _join in group_member_event.wxidJoin
wxidLeave 退群wxid(可遍历) for _leave in group_member_event.wxidLeave

CreateGroupCallback 创建群聊回调 `callback = spy_pb2.CreateGroupCallback()`

wxid 群聊wxid结构 callback.wxid
- str 群聊wxid callback.wxid.str

LoginQRCode 登录二维码 `qrcode = spy_pb2.LoginQRCode()`

qrcodeSize 二维码大小 qrcode.qrcodeSize
qrcodeBytes 二维码数据 qrcode.qrcodeBytes

例子

一、本地运行

示例代码见example.py

二、HTTP调用服务端

示例代码见 service_example.py 和 client_example.py

三、远程过程调用(RPC)

起作用的有4个额外文件：

example_rpc_server.py
example_rpc_client.py
rpc_server_tools.py
rpc_client_tools.py

使用方法：

运行服务端 example_rpc_server.py 启动微信
运行客户端 example_rpc_client.py 接收并处理消息

注意：例子中，客户端和服务端在一台机子上，所以监听的ip是127.0.0.1，如果将客户端放到其他机器，请填写实际服务端对应的ip，出现端口冲突的话也可以灵活更改端口，并配置对应服务器防火墙放行

四、其他例子

待补充，欢迎大家贡献！

pywechatspy's People

Contributors

Stargazers

Watchers

Forkers

styanddty lpt-hub cl545740896 xingx001 oldcassadin maiyude2018 ibxbux yinetsrl magen2018 siphonelee calokkk mraping kijoonga zhuopengfei sibaisaiyay q962 loveyiyi juice-off-ora xiaohua123456 xrz369 numberen lcqjiyi xrosliang styhub ryanfu yezamber tomazi722 dogwars shawein newbla winsonlaw janlycn zhengyin111 liycy067 jokerlin1 chinese-xu kingking888 lfy-blip megrezlee zhiying8710 bigmouths huqi-github azz212 anshingy withyourcode reeij bowenmail hanshan1995 adamtangcode jiangzhengfool rongcheng deng-yao tujiaw joooohnnnn yaeyi1 xljqq xdyb wh9204 xinv1996 xxf2103625 bugroom javieye ljs798290350 vonions player626 redfree luhao2020 jolahua zhouwei713 583 dawnadvent wwewwt voomy songshengzhe linshuhui rcy8 adaptx laorange fxd2000 guyuejia xiandeyi joanlee0826 songyippee ok0755 itknight thornstone lwwing whua898 solheng goldspoons 18670775011 sangecoder 404nofoundx lianghaibo08 sumnotes coolmian yangli0226 why2lyj skyformat99 gavinzbf

pywechatspy's Issues

请问登陆后报如下错误是什么意思啊

错误: [MainThread] ERROR: Professional Key Error

稳定性问题，运行一段时间就会出现导致Crash

ConnectionResetError: [WinError 10054] 远程主机强迫关闭了一个现有的连接。

请问作者开发用的是哪个python版本，我用3.7.4版本时出现了对socket_client := self.port2client.get(port)中:=报错的情况，报错SyntaxError: invalid syntax

FileNotFoundError: [WinError 2] 系统找不到指定的文件

昨天正常运行，今天在
spy = WeChatSpy(response_queue=my_response_queue, key="ab28d8c4768ab3bc2ba86841313f6e32", logger=logger)
报了找不到指定文件，请问是key过期了吗？

接受好友请求没报错也没反应是什么原因呢

xmlStr = data["content"]
doc = etree.XML(xmlStr)
from_wxid = doc.xpath("//msg/@fromusername")[0]
source_wxid = doc.xpath("//msg/@sourceusername")[0]
ticket =  doc.xpath("//msg/@ticket")[0]
encryptusername = doc.xpath("//msg/@encryptusername")[0]
#print("from_wxid = " + from_wxid + " source_wxid = " + source_wxid + " ticket= " + ticket + " encryptusername =" +encryptusername)
spy.accept_new_contact(encryptusername, ticket)

请问get_contact_details该如何调用

试了试这个函数返回的是NoneType，但是在spy.py的第108行：
socket_client.send(data_length_bytes + data)
将查询到的信息直接输出了,但不清楚该怎么调用。
请问有没有办法让查询到的信息成为一个字典或者列表方便后续调用?

有效，但是奔溃了，使用方式不对，还是什么？

使用的是你提供的微信版本 2.8.0，已关闭自动更新

未能保存日志文件。

提示 WeChatSpy.dll 错误

未上报，微信是否真的不上报，上报了，是不是大概率被封号？

关闭程序是否 unhook?
多次启动关闭会导致什么问题？
同时启动多个会导致什么问题？

是不是有东西没有上传呀？上次更新以后示例里面消息内容解析的代码一直有报错。

send_text代码导致微信程序直接崩

为什么我这么写微信程序直接崩了，可否程序不崩，只提示提示错误，以免一个错误导致程序退出请求，谢谢
spy.send_text(_from, "@wxid_2vecjpe3q35q22 @wxid_traz0579m4gt22 12345", "wxid_2vecjpe3q35q22,wxid_traz0579m4gt22")

Traceback (most recent call last):
File "E:/360/wechat/wechat.py", line 1, in
from PyWeChatSpy import WeChatSpy
File "E:\360\wechat\venv\lib\site-packages\PyWeChatSpy_init_.py", line 1, in
from .spy import WeChatSpy
File "E:\360\wechat\venv\lib\site-packages\PyWeChatSpy\spy.py", line 97
elif not (socket_client := self.__port2client.get(port)):
^
SyntaxError: invalid syntax

大佬，为啥我的微信启动以后没有收到连接成功的打印

大佬，为啥我的微信启动以后没有收到连接成功的打印，好像监听程序已经起来了，但是log没有打印连接成功的消息

想知道公众号的信息怎么获取

登录之后未收到任何信息

运行example.py，无法获取联系人信息，请问可能是什么原因？[MainThread] ERROR: GET_CONTACTS is not available

ModuleNotFoundError: No module named 'google'

使用 pip install google 不能解决，不是很清楚这个包的作用，如果是从Google官网下载 ‘protocolbuffers/protobuf‘ 则会缺失‘google.protobuf.descriptor’

Does this only support Windows ?

最近总是联系不上是不是微信被封了呀

最近在测试 HTTP调用服务端的例子，发现配置了消息回调，不生效，另外例子接口也不完整，有没有完整版的服务端代码。可以另外付费。怎么联系？用QQ？

用了这个，微信手机莫名被解绑

请问如何直接搜索联系人并发送消息

实例里面只有监听消息然后回复的，有没有直接搜索联系人主动发送消息的实例代码。

PyWeChatSpy study problems

data["type"]==1怎么才会触发，
我使用了spy.query_login_info()，他就一直循环输出我的信息，怎么才可以暂停

无法踢出群成员和删除联系人

你好，情况如下
入参群id：24185298116@chatroom 微信id: wxid_ne984zmk4dox12
踢出群成员提示 REMOVE_GROUP(CHATROOM)_MEMBER is not available
删除联系人提示REMOVE_CONTACT is not available

为什么现在使用pip无法安装了？

大佬有空弄个qq的吗

如何安装PyWeChatSpy

我在Anaconda下想要安装PyWeChatSpy，但是一直安装不上，python=3.8。请问大家是如何安装的呢？谢谢

SpyHelper.exe - 应用程序错误

系统windows 8.1 64bit

运行程序时就出现弹窗提示SpyHelper.exe打开错误，微信能登陆但没有监控微信效果

大神，the commercial function 不能用，是没有购买了，但是找不到如何购买

能介绍一下如何购买，以及免费的和商业版有什么区别吗

不知能否接受公众号消息

这个能够接收到公众号的推送消息呢

能否在linux 环境下调用这个接口

wechatwin.dll 微信遇到错误

请问支持语音消息吗？

你好，我在其他消息里输出，语音消息体为以下，请问如何可以获取和发送语音信息呢？

---------- 其他消息 ----------
type: 34
self: 0
head: "\n"
wxid1: "winson_law"
wxid2: "winson_law"
content: "<voicemsg endflag="1" length="12507" voicelength="11566" clientmsgid="4166663964383637313635646462310042093309152022a00d1fc49100" fromusername="XXXXXX" downcount="0" cancelflag="0" voiceformat="4" forwardflag="0" bufid="937456541697245830" />"

微信群成员无法获取

这个功能是不是需要付费？请求发出去，返回结果为空。

怎么获取商用Key呢

请问Get_Contacts如何调用？

模仿get_account_info做下面的修改，但是似乎client2contacts总是空的，即便loop了50秒

请问是因为contacts的list太长了吗？

elif data.type == ACCOUNT_DETAILS:
    self.client2account[data.port] = data.bytes
elif data.type == CONTACTS_LIST:
    self.client2contacts[data.port] = data.bytes

@app.route("/get_contacts/<int:port>")
@verify_port
def get_contacts(port):
    app.spy.get_contacts(port)
    ret = []
    for i in range(100):
        if contacts_data := app.client2contacts.get(port):
            contact_list = spy_pb2.Contacts()
            contact_list.ParseFromString(contacts_data)
            for contact in contact_list.contactDetails:
                ret.append(jsonify({
                    "code": 1,
                    "wxid": contact.wxid,
                    "nickname": contact.nickname,
                    "remark": contact.remark,
                    "sex": contact.sex,
                    "city": contact.city,
                    "province": contact.province,
                    "country": contact.country
                }))

            return "{" + ", ".join(ret) +  "}"
        sleep(0.5)

    return jsonify({"code": 0, "msg": "contact info not found"})