您好,登錄后才能下訂單哦!
itchat是一個開源的微信個人號接口,使用python調用微信從未如此簡單。
使用不到三十行的代碼,你就可以完成一個能夠處理所有信息的微信機器人。
當然,該api的使用遠不止一個機器人,更多的功能等著你來發現,比如這些。
該接口與公眾號接口itchatmp共享類似的操作方式,學習一次掌握兩個工具。
如今微信已經成為了個人社交的很大一部分,希望這個項目能夠幫助你擴展你的個人的微信號、方便自己的生活。
【文章背景】最近幾天干啥都不來勁,昨晚偶然了解到Python里的itchat包,它已經完成了wechat的個人賬號API接口,使爬取個人微信信息更加方便。鑒于自己很早之前就想知道諸如自己微信好友性別比例都來自哪個城市之類的問題,于是乎玩心一起,打算爬一下自己的微信。
首先,在終端安裝一下itchat包。pip install itchat
安裝完成后導入包,再登陸自己的微信。過程中會生產一個登陸二維碼,掃碼之后即可登陸。登陸成功后,把自己好友的相關信息爬下來。
import itchat itchat.login() #爬取自己好友相關信息, 返回一個json文件 friends = itchat.get_friends(update=True)[0:]
有了上面的friends數據,我們就可以來做好友或者朋友圈數據分析啦!
python實現微信接口(itchat)
安裝
sudo pip install itchat
登錄
itchat.auto_login() 這種方法將會通過微信掃描二維碼登錄,但是這種登錄的方式確實短時間的登錄,并不會保留登錄的狀態,也就是下次登錄時還是需要掃描二維碼,如果加上hotReload==True,那么就會保留登錄的狀態,至少在后面的幾次登錄過程中不會再次掃描二維碼,該參數生成一個靜態文件itchat.pkl用于存儲登錄狀態
退出及登錄完成后調用的特定的方法
這里主要使用的是灰調函數的方法,登錄完成后的方法需要賦值在 loginCallback 中退出后的方法,需要賦值在 exitCallback中.若不設置 loginCallback 的值, 將會自動刪除二維碼圖片并清空命令行顯示.
import itchat, time def lc(): print("Finash Login!") def ec(): print("exit") itchat.auto_login(loginCallback=lc, exitCallback=ec) time.sleep() itchat.logout() #強制退出登錄
回復消息
send
send(msg="Text Message", toUserName=None)
參數:
msg : 文本消息內容
返回值
實例代碼
# coding-utf-8 import itchat itchat.auto_login() itchat.send("Hello World!") ithcat.send("@fil@%s" % '/tmp/test.text') ithcat.send("@img@%s" % '/tmp/test.png') ithcat.send("@vid@%s" % '/tmp/test.mkv')
send_msg
send_msg(msg='Text Message', toUserName=None),其中的的msg是要發送的文本,toUserName是發送對象, 如果留空, 將發送給自己,返回值為True或者False
實例代碼
import itchat itchat.auto_login() itchat.send_msg("hello world.")
send_file
send_file(fileDir, toUserName=None) fileDir是文件路徑, 當文件不存在時, 將打印無此文件的提醒,返回值為True或者False
實例代碼
import itchat itchat.auto_login() itchat.send_file("/tmp/test.txt")
send_image
send_image(fileDir, toUserName=None) 參數同上
實例代碼
import itchat itchat.auto_login() itchat.send_img("/tmp/test.txt")
send_video
send_video(fileDir, toUserName=None) 參數同上
實例代碼
import itchat itchat.auto_login() itchat.send_video("/tmp/test.txt")
注冊消息方法
itchat 將根據接受到的消息類型尋找對應的已注冊的方法.
如果一個消息類型沒有對應的注冊方法, 該消息將會被舍棄.
在運行過程中也可以動態注冊方法, 注冊方式與結果不變.
注冊方法
不帶具體對象注冊, 將注冊為普通消息的回復方法.
import itchat from itchat.content import * @itchat.msg_register(TEXT) #這里的TEXT表示如果有人發送文本消息,那么就會調用下面的方法 def simple_reply(msg): #這個是向發送者發送消息 itchat.send_msg('已經收到了文本消息,消息內容為%s'%msg['Text'],toUserName=msg['FromUserName']) return "T reveived: %s" % msg["Text"] #返回的給對方的消息,msg["Text"]表示消息的內容
帶對象參數注冊, 對應消息對象將調用該方法,其中isFriendChat表示好友之間,isGroupChat表示群聊,isMapChat表示公眾號
import itchat from itchat.content import * @itchat.msg_register(TEXT, isFriendChat=True, isGroupChat=True,isMpChat=True) def text_reply(msg): msg.user.send("%s : %s" % (mst.type, msg.text))
消息類型
向注冊方法傳入的 msg 包含微信返回的字典的所有內容.itchat 增加 Text, Type(也就是參數) 鍵值, 方便操作.
itcaht.content 中包含所有的消息類型參數, 如下表
參數 | l類型 | Text 鍵值 |
---|---|---|
TEXT | 文本 | 文本內容(文字消息) |
MAP | 地圖 | 位置文本(位置分享) |
CARD | 名片 | 推薦人字典(推薦人的名片) |
SHARING | 分享 | 分享名稱(分享的音樂或者文章等) |
PICTURE 下載方法 | 圖片/表情 | |
RECORDING | 語音 | 下載方法 |
ATTACHMENT | 附件 | 下載方法 |
VIDEO | 小視頻 | 下載方法 |
FRIENDS | 好友邀請 | 添加好友所需參數 |
SYSTEM | 系統消息 | 更新內容的用戶或群聊的UserName組成的列表 |
NOTE | 通知 | 通知文本(消息撤回等) |
附件的下載與發送
itchat 的附件下載方法存儲在 msg 的 Text 鍵中.
發送的文件名(圖片給出的默認文件名), 都存儲在 msg 的 FileName 鍵中.
下載方法, 接受一個可用的位置參數(包括文件名), 并將文件響應的存儲.
注意:下載的文件存儲在指定的文件中,直接將路徑與FileName連接即可,如msg["Text"]('/tmp/weichat'+msg['FileName'])
@itchat.msg_register([PICTURE, RECORDING, ATTACHMENT, VIDEO]) def download_files(msg): #msg.download(msg['FileName']) #這個同樣是下載文件的方式 msg['Text'](msg['FileName']) #下載文件 #將下載的文件發送給發送者 itchat.send('@%s@%s' % ('img' if msg['Type'] == 'Picture' else 'fil', msg["FileName"]), msg["FromUserName"])
群消息
增加了三個鍵值,如下:
測試程序
import itcaht from itchat.content import TEXT @itchat.msg_register(TEXT, isGroupChat=True) def text_reply(msg): if(msg.isAt): #判斷是否有人@自己 #如果有人@自己,就發一個消息告訴對方我已經收到了信息 itchat.send_msg("我已經收到了來自{0}的消息,實際內容為{1}".format(msg['ActualNickName'],msg['Text']),toUserName=msg['FromUserName']) itchat.auto_login() itchat.run()
注冊消息的優先級
總的來說就是后面注冊同種類型的消息會覆蓋之前注冊的消息,詳情見文檔https://itchat.readthedocs.io/zh/latest/
消息內容
注意:所有的消息內容都是可以用鍵值對來訪問的,如msg["FromUserName]就是查看發送者,itchat.search_friends(userName=msg['FromUserName'])['NickName']查看的是當發送者昵稱
一般消息
一般的消息都遵循以下的內容:
{ "FromUserName": "", "ToUserName": "", "Content": "", "StatusNotifyUserName": "", "ImgWidth": 0, "PlayLength": 0, "RecommendInfo": {}, "StatusNotifyCode": 0, "NewMsgId": "", "Status": 0, "VoiceLength": 0, "ForwardFlag": 0, "AppMsgType": 0, "Ticket": "", "AppInfo": {}, "Url": "", "ImgStatus": 0, "MsgType": 0, "ImgHeight": 0, "MediaId": "", "MsgId": "", "FileName": "", "HasProductId": 0, "FileSize": "", "CreateTime": 0, "SubMsgType": 0 }
初始化消息
MsgType: 51 FromUserName: 自己ID ToUserName: 自己ID StatusNotifyUserName: 最近聯系的聯系人ID Content: <msg> <op id='4'> <username> # 最近聯系的聯系人 filehelper,xxx@chatroom,wxid_xxx,xxx,... </username> <unreadchatlist> <chat> <username> # 朋友圈 MomentsUnreadMsgStatus </username> <lastreadtime> 1454502365 </lastreadtime> </chat> </unreadchatlist> <unreadfunctionlist> # 未讀的功能賬號消息,群發助手,漂流瓶等 </unreadfunctionlist> </op> </msg>
文本消息
MsgType: 1 FromUserName: 發送方ID ToUserName: 接收方ID Content: 消息內容
圖片消息
itchat 增加了 Text 鍵, 鍵值為 下載該圖片的方法.
MsgType: 3 FromUserName: 發送方ID ToUserName: 接收方ID MsgId: 用于獲取圖片,用于表示每一條消息 Content: <msg> <img length="6503" hdlength="0" /> <commenturl></commenturl> </msg>
拓展:如果想要得到Content中的具體內容可以使用正則表達式匹配出來
視頻消息
*itchat 增加了 Text 鍵, 鍵值為 下載該視頻的方法.*
MsgType: 62 FromUserName: 發送方ID ToUserName: 接收方ID MsgId: 用于獲取小視頻 Content: <msg> <img length="6503" hdlength="0" /> <commenturl></commenturl> </msg>
地理位置消息
itchat 增加了 Text 鍵, 鍵值為 該地點的文本形式.
MsgType: 1 FromUserName: 發送方ID ToUserName: 接收方ID Content: http://weixin.qq.com/cgi-bin/redirectforward?args=xxx OriContent:<?xml version="1.0"?> <msg> <location x="34.195278" y="117.177803" scale="16" label="江蘇省徐州市銅山區新區海河路" maptype="0" poiname="江蘇師范大學大學生公寓園區" /> </msg>
名片消息
itchat 增加了Text 鍵, 鍵值為 該調用 add_friend 需要的屬性.
MsgType: 42 FromUserName: 發送方ID ToUserName: 接收方ID Content: <?xml version="1.0"?> <msg bigheadimgurl="" smallheadimgurl="" username="" nickname="" shortpy="" alias="" imagestatus="3" scene="17" province="" city="" sign="" sex="1" certflag="0" certinfo="" brandIconUrl="" brandHomeUrl="" brandSubscriptConfigUrl="" brandFlags="0" regionCode="" /> RecommendInfo: { "UserName": "xxx", # ID,這里的是昵稱 "Province": "xxx", "City": "xxx", "Scene": 17, "QQNum": 0, "Content": "", "Alias": "xxx", # 微信號 "OpCode": 0, "Signature": "", "Ticket": "", "Sex": 0, # 1:男, 2:女 "NickName": "xxx", # 昵稱 "AttrStatus": 4293221, "VerifyFlag": 0 }
下面是添加好友的測試代碼
@itchat.msg_register(itchat.content.CARD,isFriendChat=True) def simply(msg): print msg['Text'] print msg['Content'] itchat.add_friend(userName=msg['Text']['UserName']) #添加推薦的好友 print msg['RecommendInfo'] print msg['RecommendInfo']['UserName']
語音消息
*itchat增加了Text鍵,鍵值為下載該語音文件的方法,下載下來的是MP3的格式
MsgType: 34 FromUserName: 發送方ID ToUserName: 接收方ID MsgId: 用于獲取語音 Content: <msg> <voicemsg endflag="1" cancelflag="0" forwardflag="0" voiceformat="4" voicelength="1580" length="2026" bufid="216825389722501519" clientmsgid="49efec63a9774a65a932a4e5fcd4e923filehelper174_1454602489" fromusername="" /> </msg>
下載方法:msg['Text'](msg['FileName'])
動畫表情
itchat添加了Text鍵,鍵值為下載該圖片表情的方法。
注意:本人親測對于一些微信商店提供的表情是不能下載成功的,這里的自帶的表情emoji是屬于TEXT類別的,因此如果將其注冊為PICTURE消息類型的話是不可以監測到的
MsgType: 47 FromUserName: 發送方ID ToUserName: 接收方ID Content: <msg> <emoji fromusername = "" tousername = "" type="2" idbuffer="media:0_0" md5="e68363487d8f0519c4e1047de403b2e7" len = "86235" productid="com.tencent.xin.emoticon.bilibili" androidmd5="e68363487d8f0519c4e1047de403b2e7" androidlen="86235" s60v3md5 = "e68363487d8f0519c4e1047de403b2e7" s60v3len="86235" s60v5md5 = "e68363487d8f0519c4e1047de403b2e7" s60v5len="86235" cdnurl = "http://emoji.qpic.cn/wx_emoji/eFygWtxcoMF8M0oCCsksMA0gplXAFQNpiaqsmOicbXl1OC4Tyx18SGsQ/" designerid = "" thumburl = "http://mmbiz.qpic.cn/mmemoticon/dx4Y70y9XctRJf6tKsy7FwWosxd4DAtItSfhKS0Czr56A70p8U5O8g/0" encrypturl = "http://emoji.qpic.cn/wx_emoji/UyYVK8GMlq5VnJ56a4GkKHAiaC266Y0me0KtW6JN2FAZcXiaFKccRevA/" aeskey= "a911cc2ec96ddb781b5ca85d24143642" ></emoji> <gameext type="0" content="0" ></gameext> </msg>
普通鏈接或應用分享消息
主要針對的是分享的文章等等
MsgType: 49 AppMsgType: 5 FromUserName: 發送方ID ToUserName: 接收方ID Url: 鏈接地址 FileName: 鏈接標題 Content: <msg> <appmsg appid="" sdkver="0"> <title></title> <des></des> <type>5</type> <content></content> <url></url> <thumburl></thumburl> ... </appmsg> <appinfo> <version></version> <appname></appname> </appinfo> </msg>
音樂鏈接消息
主要針對的是音樂
MsgType: 49 AppMsgType: 3 FromUserName: 發送方ID ToUserName: 接收方ID Url: 鏈接地址 FileName: 音樂名 AppInfo: # 分享鏈接的應用 { Type: 0, AppID: wx485a97c844086dc9 } Content: <msg> <appmsg appid="wx485a97c844086dc9" sdkver="0"> <title></title> <des></des> <action></action> <type>3</type> <showtype>0</showtype> <mediatagname></mediatagname> <messageext></messageext> <messageaction></messageaction> <content></content> <contentattr>0</contentattr> <url></url> <lowurl></lowurl> <dataurl> http://ws.stream.qqmusic.qq.com/C100003i9hMt1bgui0.m4a?vkey=6867EF99F3684&guid=ffffffffc104ea2964a111cf3ff3edaf&fromtag=46 </dataurl> <lowdataurl> http://ws.stream.qqmusic.qq.com/C100003i9hMt1bgui0.m4a?vkey=6867EF99F3684&guid=ffffffffc104ea2964a111cf3ff3edaf&fromtag=46 </lowdataurl> <appattach> <totallen>0</totallen> <attachid></attachid> <emoticonmd5></emoticonmd5> <fileext></fileext> </appattach> <extinfo></extinfo> <sourceusername></sourceusername> <sourcedisplayname></sourcedisplayname> <commenturl></commenturl> <thumburl> https://cache.yisu.com/upload/information/20200622/113/34202.jpg </thumburl> <md5></md5> </appmsg> <fromusername></fromusername> <scene>0</scene> <appinfo> <version>29</version> <appname>搖一搖搜歌</appname> </appinfo> <commenturl></commenturl> </msg>
群消息
itchat 增加了三個群聊相關的鍵值:
MsgType: 1 FromUserName: @@xxx ToUserName: @xxx Content: @xxx:<br/>xxx
紅包消息
MsgType: 49 AppMsgType: 2001 FromUserName: 發送方ID ToUserName: 接收方ID Content: 未知
系統消息
MsgType: 10000 FromUserName: 發送方ID ToUserName: 自己ID Content: "你已添加了 xxx ,現在可以開始聊天了。" "如果陌生人主動添加你為朋友,請謹慎核實對方身份。" "收到紅包,請在手機上查看"
賬號類型
tchat 為三種賬號都提供了 整體獲取方法與搜索方法.
好友
get_friends
itchat.get_friends() 返回完整的好友列表
search_friends
# 獲取自己的用戶信息,返回自己的屬性字典 itchat.search_friends()
獲取特定 UserName 的用戶信息
# 獲取特定UserName的用戶信息 itchat.search_friends(userName='@abcdefg1234567') ## 獲取發送信息的好友的詳細信息 @itchat.msg_register(itchat.content.TEXT,isFriendChat=True) def reply(msg): print msg['FromUserName'] print itchat.search_friends(userName=msg['FromUserName']) #詳細信息 print itchat.search_friends(userName=msg['FromUserName'])['NickName'] #獲取昵稱
獲取備注,微信號, 昵稱中的任何一項等于name鍵值的用戶. (可以與下一項配置使用.)
比如在我的微信中有一個備注為autolife的人,我可以使用這個方法搜索出詳細的信息
# 獲取任何一項等于name鍵值的用戶 itchat.search_friends(name='autolife') 獲取備注,微信號, 昵稱分別等于相應鍵值的用戶. (可以與上一項配置使用.) # 獲取分別對應相應鍵值的用戶 itchat.search_friends(wechatAccount='littlecodersh') # 三、四項功能可以一同使用 itchat.search_friends(name='LittleCoder機器人', wechatAccount='littlecodersh')
update_friend
主要用于好友更新
memberList = itchat.update_friend('@abcdefg1234567')
公眾號
get_mps
將返回完整的工作號列表
search_mps
# 獲取特定UserName的公眾號,返回值為一個字典 itchat.search_mps(userName='@abcdefg1234567') 獲取名字中還有特定字符的公眾號. # 獲取名字中含有特定字符的公眾號,返回值為一個字典的列表 itchat.search_mps(name='LittleCoder')
當兩項都是勇士, 將僅返回特定UserName的公眾號.
群聊
memberList = itchat.update_chatroom('@@abcdefg1234567', detailedMember=True)
創建群聊,增加/刪除群聊用戶:
memberList = itchat.get_frients()[1:] # 創建群聊, topic 鍵值為群聊名稱. chatroomUserName = itchat.create_chatroom(memberList, "test chatroom") # 刪除群聊內的用戶 itchat.delete_member_from_chatroom(chatroomUserName, memberList[0]) # 增加用戶進入群聊. itchat.add_member_into_chatroom(chatroomUserName, memberList[0], useInvitation=False)
方法匯總
itchat.add_friend itchat.new_instance itchat.add_member_into_chatroom itchat.originInstance itchat.auto_login itchat.returnvalues itchat.check_login itchat.run itchat.components itchat.search_chatrooms itchat.config itchat.search_friends itchat.configured_reply itchat.search_mps itchat.content itchat.send itchat.core itchat.send_file itchat.Core itchat.send_image itchat.create_chatroom itchat.send_msg itchat.delete_member_from_chatroom itchat.send_raw_msg itchat.dump_login_status itchat.send_video itchat.get_chatrooms itchat.set_alias itchat.get_contact itchat.set_chatroom_name itchat.get_friends itchat.set_logging itchat.get_head_img itchat.set_pinned itchat.get_mps itchat.show_mobile_login itchat.get_msg itchat.start_receiving itchat.get_QR itchat.storage itchat.get_QRuuid itchat.update_chatroom itchat.instanceList itchat.update_friend itchat.load_login_status itchat.upload_file itchat.log itchat.utils itchat.login itchat.VERSION itchat.logout itchat.web_init itchat.msg_register
實例
下面是博主寫的一個程序,該程序的主要功能是監控撤回消息,并且如果有消息撤回就會撤回的消息發送給你,以后再也不用擔心看不到好友的撤回的消息了,由于注釋寫的很詳細,因此這里就不在詳細的講解了,直接貼代碼
代碼
# coding:utf-8 import itchat from itchat.content import TEXT from itchat.content import * import sys import time import re reload(sys) sys.setdefaultencoding('utf8') import os msg_information = {} face_bug=None #針對表情包的內容 @itchat.msg_register([TEXT, PICTURE, FRIENDS, CARD, MAP, SHARING, RECORDING, ATTACHMENT, VIDEO],isFriendChat=True, isGroupChat=True, isMpChat=True) def handle_receive_msg(msg): global face_bug msg_time_rec = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()) #接受消息的時間 msg_from = itchat.search_friends(userName=msg['FromUserName'])['NickName'] #在好友列表中查詢發送信息的好友昵稱 msg_time = msg['CreateTime'] #信息發送的時間 msg_id = msg['MsgId'] #每條信息的id msg_content = None #儲存信息的內容 msg_share_url = None #儲存分享的鏈接,比如分享的文章和音樂 print msg['Type'] print msg['MsgId'] if msg['Type'] == 'Text' or msg['Type'] == 'Friends': #如果發送的消息是文本或者好友推薦 msg_content = msg['Text'] print msg_content #如果發送的消息是附件、視屏、圖片、語音 elif msg['Type'] == "Attachment" or msg['Type'] == "Video" \ or msg['Type'] == 'Picture' \ or msg['Type'] == 'Recording': msg_content = msg['FileName'] #內容就是他們的文件名 msg['Text'](str(msg_content)) #下載文件 # print msg_content elif msg['Type'] == 'Card': #如果消息是推薦的名片 msg_content = msg['RecommendInfo']['NickName'] + '的名片' #內容就是推薦人的昵稱和性別 if msg['RecommendInfo']['Sex'] == 1: msg_content += '性別為男' else: msg_content += '性別為女' print msg_content elif msg['Type'] == 'Map': #如果消息為分享的位置信息 x, y, location = re.search( "<location x=\"(.*?)\" y=\"(.*?)\".*label=\"(.*?)\".*", msg['OriContent']).group(1, 2, 3) if location is None: msg_content = r"緯度->" + x.__str__() + " 經度->" + y.__str__() #內容為詳細的地址 else: msg_content = r"" + location elif msg['Type'] == 'Sharing': #如果消息為分享的音樂或者文章,詳細的內容為文章的標題或者是分享的名字 msg_content = msg['Text'] msg_share_url = msg['Url'] #記錄分享的url print msg_share_url face_bug=msg_content ##將信息存儲在字典中,每一個msg_id對應一條信息 msg_information.update( { msg_id: { "msg_from": msg_from, "msg_time": msg_time, "msg_time_rec": msg_time_rec, "msg_type": msg["Type"], "msg_content": msg_content, "msg_share_url": msg_share_url } } ) ##這個是用于監聽是否有消息撤回 @itchat.msg_register(NOTE, isFriendChat=True, isGroupChat=True, isMpChat=True) def information(msg): #這里如果這里的msg['Content']中包含消息撤回和id,就執行下面的語句 if '撤回了一條消息' in msg['Content']: old_msg_id = re.search("\<msgid\>(.*?)\<\/msgid\>", msg['Content']).group(1) #在返回的content查找撤回的消息的id old_msg = msg_information.get(old_msg_id) #得到消息 print old_msg if len(old_msg_id)<11: #如果發送的是表情包 itchat.send_file(face_bug,toUserName='filehelper') else: #發送撤回的提示給文件助手 msg_body = "告訴你一個秘密~" + "\n" \ + old_msg.get('msg_from') + " 撤回了 " + old_msg.get("msg_type") + " 消息" + "\n" \ + old_msg.get('msg_time_rec') + "\n" \ + "撤回了什么 ⇣" + "\n" \ + r"" + old_msg.get('msg_content') #如果是分享的文件被撤回了,那么就將分享的url加在msg_body中發送給文件助手 if old_msg['msg_type'] == "Sharing": msg_body += "\n就是這個鏈接➣ " + old_msg.get('msg_share_url') # 將撤回消息發送到文件助手 itchat.send_msg(msg_body, toUserName='filehelper') # 有文件的話也要將文件發送回去 if old_msg["msg_type"] == "Picture" \ or old_msg["msg_type"] == "Recording" \ or old_msg["msg_type"] == "Video" \ or old_msg["msg_type"] == "Attachment": file = '@fil@%s' % (old_msg['msg_content']) itchat.send(msg=file, toUserName='filehelper') os.remove(old_msg['msg_content']) # 刪除字典舊消息 msg_information.pop(old_msg_id) itchat.auto_login(hotReload=True) itchat.run()
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持億速云。
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。