Python微信操控(itchat)

时间:2024-01-24 17:55:13

itchat是一个开源的微信个人号接口,使用python调用微信从未如此简单。

开源地址

https://github.com/littlecodersh/ItChat

文档:

https://itchat.readthedocs.io/zh/latest/

安装:

pip3 install itchat

登入与登出

登入并向文件助手发送一句话,登入时会经过扫码操作,类似于电脑微信登入

1 import itchat
2 #登入并保存登入状态,实现第一次运行时扫码,一定时间内再次运行就不用扫码了,手机微信上将显示:网页微信已登入.....
3 itchat.auto_login(hotReload=True)
4 #发送文本数据到文件助手
5 itchat.send("东小东你好123",toUserName="filehelper")

登出:

itchat.logout() 

注册登入登出的回调方法

1 def ldong():
2     print(\'微信登入\')
3 def edong():
4     print(\'微信登出\')
5 #登入
6 itchat.auto_login(hotReload=True,loginCallback=ldong, exitCallback=edong)

命令行二维码

通过以下命令可以在登陆的时候使用命令行显示二维码:

itchat.auto_login(enableCmdQR=True)

部分系统可能字幅宽度有出入,可以通过将enableCmdQR赋值为特定的倍数进行调整:

#如部分的linux系统,块字符的宽度为一个字符(正常应为两字符),故赋值为2
itchat.auto_login(enableCmdQR=2)

默认控制台背景色为暗色(黑色),若背景色为浅色(白色),可以将enableCmdQR赋值为负值:

itchat.auto_login(enableCmdQR=-1)

可接受监听的数据类型

消息分类:

图片或表情(PICTURE)、录制(RECORDING)、附件(ATTACHMENT)、小视频(VIDEO)、文本(TEXT),地图(MAP),名片(CARD),通知(NOTE),分享(SHARING),好友邀请(FRIENDS)、语音(RECORDING)、系统消息(SYSTEM)

获取消息内容:

可以通过print(msg)方法查看消息里的所有数据,然后进行提取

@itchat.msg_register(itchat.content.TEXT)
def text_reply(msg):
    print(msg)

消息捕获

针对朋友的消息捕获

登入时不适用于hotReload=True,因为多次运行会多次注册自动回复,比如在没有登出的情况下运行3次程序,就会出现1次接受3次发送的效果

监听函数只有在对方发送数据时进入

文本

 1 import itchat
 2 #自动回复
 3 @itchat.msg_register(itchat.content.TEXT)
 4 def text_reply(msg):
 5     return "东小东回复数据:"+msg["Text"]
 6 
 7 #登入
 8 itchat.auto_login()
 9 #保持运行
10 itchat.run()

文件下载

 1 import itchat
 2 #PICTURE, RECORDING, ATTACHMENT, VIDEO,TEXT
 3 # 图片、录制、附件、视频、文本
 4 from itchat.content import PICTURE, RECORDING, ATTACHMENT, VIDEO,TEXT
 5 
 6 @itchat.msg_register([PICTURE, RECORDING, ATTACHMENT, VIDEO])
 7 def download_files(msg):
 8     filedpx="./filex/"+msg["FileName"] #得到文件路径,目录需要手动创建
 9     msg.download(filedpx) #下载
10     return "你发送的文件类型"+msg[\'Type\']+"  保存地址为:filex/"+msg.fileName

针对群聊的自动监测

如果想添加针对群聊的监测,则在监听函数加入isGroupChat=True

监听函数只要有数据发送就会进入,包括自己发送的数据

 1 import itchat
 2 #只对群消息有效
 3 @itchat.msg_register(itchat.content.TEXT,isGroupChat=True)
 4 def text_reply(msg):
 5     if(msg["Text"]=="11"):
 6         return "东小东回复数据xx:"+msg["Text"]
 7 #只对个人用户有效
 8 @itchat.msg_register(itchat.content.TEXT)
 9 def text_reply(msg):
10     return "东小东回复数据:"+msg["Text"]
11 #登入
12 itchat.auto_login()
13 #保持运行
14 itchat.run()

@我信息监测

 1 import itchat
 2 #只对群消息有效
 3 @itchat.msg_register(itchat.content.TEXT,isGroupChat=True)
 4 def text_reply(msg):
 5         #判断是否是@本人
 6         if msg["Text"].find("@"+usermsgx["NickName"])==0:
 7             return "@"+msg.actualNickName+" 东你发的信息为:"+msg.text
 8 
 9 itchat.auto_login()#登入
10 usermsgx=itchat.search_friends()#得到当前用户的信息
11 itchat.run()#保持运行

针对所有信息来源信息监听

朋友、群聊、公众号

@itchat.msg_register(TEXT, isFriendChat=True, isGroupChat=True, isMpChat=True)
def simple_reply(msg):
    return \'I received: %s\' % msg.text

数据发送

return

在接收数据函数里的return “数据” 则是自动确认为回复当前发送用户数据,可以删除该句,则不进行数据回复

itchat.send,可以一次性发送多条

参数:(内容,用户)

返回值:发送结果,是否发送成功,json数据

注意:文件地址不可为中文

内容:可为单独的字符串内容,其他有【@类型@地址】,类型有图片(img)、文件(fil)、视频(vid)

用户:省略则发个自己,不稳定,msg[\'FromUserName\']表示指定用户为触发用户

1 res=itchat.send(\'文本信息的发送......!\', toUserName=msg[\'FromUserName\'])
2 res=itchat.send(\'@img@%s\' % \'./filex/zcy.gif\', toUserName=msg[\'FromUserName\'])
3 res=itchat.send(\'@fil@%s\' % \'./filex/tt.txt\', toUserName=msg[\'FromUserName\'])
4 res=itchat.send(\'@vid@%s\' % \'./filex/videox.mp4\', toUserName=msg[\'FromUserName\'])

指定类型发送2

参数:(地址,用户)

返回值:发送结果,是否发送成功,json数据

注意:文件地址不可为中文

1 bb = itchat.send_msg(\'文字信息2\', toUserName=msg[\'FromUserName\'])
2 bb = itchat.send_image(\'./filex/zcy.gif\', toUserName=msg[\'FromUserName\'])
3 bb = itchat.send_file(\'./filex/tt.txt\', toUserName=msg[\'FromUserName\'])
4 bb = itchat.send_video(\'./filex/videox.mp4\', toUserName=msg[\'FromUserName\'])
5 print("返回值:",bb)

msg.user.send()

使用与itchat.send()相同,但是可以已经确定toUserName=msg[\'FromUserName\'],不可更换

指定用户(toUserName):

文件助手(发送给自己,必备):toUserName="filehelper"

发送者:toUserName=msg[\'FromUserName\']

例子:

通过群名向群里发送内容,该微信群需要在运行代码前进行手动添加到通讯录

 1 import itchat
 2         
 3 #登入
 4 itchat.auto_login()
 5 chatroomName=\'傻逼群\'#群名
 6 itchat.get_chatrooms(update=True)
 7 chatrooms = itchat.search_chatrooms(name=chatroomName)
 8 if len(chatrooms)==0 :
 9     print(\'没有找到群聊:\' + chatroomName)
10     exit(0)
11 else:
12     print(chatrooms[0][\'UserName\'])#输出群聊标识符
13     itchat.send_msg(\'大家好,这是发送的内容\', toUserName=chatrooms[0][\'UserName\'])#发送消息
14 
15 #保持运行
16 itchat.run()

个人的基本信息

获取本人信息

usermsgx=itchat.search_friends()
print(usermsgx)
print(usermsgx["NickName"]) #得到昵称

获取所有朋友信息

friendx=itchat.get_friends()
print(friendx)

条件获取朋友或者自己信息

1 # 获取特定UserName的用户信息
2 itchat.search_friends(userName=\'@abcdefg1234567\')
3 # 获取任何一项等于name键值的用户
4 itchat.search_friends(name=\'littlecodersh\')
5 # 获取分别对应相应键值的用户
6 itchat.search_friends(wechatAccount=\'littlecodersh\')
7 # 三、四项功能可以一同使用
8 itchat.search_friends(name=\'LittleCoder机器人\', wechatAccount=\'littlecodersh\')

得到用户序号

@itchat.msg_register([TEXT,MAP])
def text_reply(msg):
    print(msg)
    print(msg["User"]["Uin"])

更新用户数据,通过UserName,或者UserName列表

memberList = itchat.update_friend(\'@abcdefg1234567\')

注意:

中文文件名文件上传

Q: 为什么中文的文件没有办法上传? 

A: 这是因为使用requests包会自动将中文文件名编码为服务器端无法识别的格式,所以需要修改requests包或者使用别的方法上传文件。

最简单的方法即将requests包的packages/urlib3中的fields.py中的format_header_param方法改为如下内容:

 1 def format_header_param(name, value):
 2     if not any(ch in value for ch in \'"\\\r\n\'):
 3         result = \'%s="%s"\' % (name, value)
 4         try:
 5             result.encode(\'ascii\')
 6         except UnicodeEncodeError:
 7             pass
 8         else:
 9             return result
10     if not six.PY3:  # Python 2:
11         value = value.encode(\'utf-8\')
12     value = email.utils.encode_rfc2231(value, \'utf-8\')
13     value = \'%s="%s"\' % (name, value.decode(\'utf8\'))
14     return value

命令行显示二维码

Q: 为什么我在设定了itchat.auto_login()的enableCmdQR为True后还是没有办法在命令行显示二维码?

A: 这是由于没有安装可选的包pillow,可以使用右边的命令安装:pip install pillow

综合:

实现文本信息的关联,及可以实时看到所关联的账号的聊天信息,当发生聊天数据时会主动将聊天数据发送到主账号上

 1 import itchat
 2 from itchat.content import PICTURE, RECORDING, ATTACHMENT, VIDEO,TEXT,MAP
 3 #只对个人用户有效
 4 @itchat.msg_register([TEXT])
 5 def text_reply(msg):
 6     # 查询数据的接收者
 7    touserx="filehelper"#默认为文件助手发送信息
 8    if msg["ToUserName"]!="filehelper":#如果非文件助手信息
 9         touserx=itchat.search_friends(userName=msg["ToUserName"])["NickName"]
10    inuserx = itchat.search_friends(userName=msg["FromUserName"])["NickName"]#查询数据的发送者
11    totouserx=itchat.search_friends(name=\'东里个咚\')[0]["UserName"] #通过昵称查询到username
12    texts=msg.text #得到接收的数据
13    itchat.send_msg(""+thisuserx+"】\n"+inuserx+"-->"+touserx+" :\n"+texts,toUserName=totouserx) #发送给目标
14 
15 #登入
16 itchat.auto_login()
17 thisuserx=itchat.search_friends()["NickName"] #得到当前用户昵称
18 #保持运行
19 itchat.run()