wxpy微信個人號 API
微信機器人 / 可能是最優(yōu)雅的微信個人號 API
wxpy 在 itchat 的基礎(chǔ)上,通過大量接口優(yōu)化提升了模塊的易用性,并進(jìn)行豐富的功能擴展
Attention!
強烈建議僅使用小號運行機器人!
從近期 (17年6月下旬) 反饋來看,使用機器人存在一定概率被限制登錄的可能性。
主要表現(xiàn)為無法登陸 Web 微信 (但不影響手機等其他平臺)。
用來干啥
一些常見的場景
-
控制路由器、智能家居等具有開放接口的玩意兒
-
運行腳本時自動把日志發(fā)送到你的微信
-
加群主為好友,自動拉進(jìn)群中
-
跨號或跨群轉(zhuǎn)發(fā)消息
-
自動陪人聊天
-
逗人玩
-
...
總而言之,可用來實現(xiàn)各種微信個人號的自動化操作
輕松安裝
wxpy 支持 Python 3.4-3.6,以及 2.7 版本
將下方命令中的 "pip" 替換為 "pip3" 或 "pip2",可確保安裝到對應(yīng)的 Python 版本中
-
從 PYPI 官方源下載安裝 (在國內(nèi)可能比較慢或不穩(wěn)定):
pip install -U wxpy
-
從豆瓣 PYPI 鏡像源下載安裝 (推薦國內(nèi)用戶選用):
pip install -U wxpy -i "https://pypi.doubanio.com/simple/"
簡單上手
登陸微信:
# 導(dǎo)入模塊 from wxpy import * # 初始化機器人,掃碼登陸 bot = Bot()
找到好友:
# 搜索名稱含有 "游否" 的男性深圳好友
my_friend = bot.friends().search('游否', sex=MALE, city="深圳")[0]
發(fā)送消息:
# 發(fā)送文本給好友
my_friend.send('Hello WeChat!')
# 發(fā)送圖片
my_friend.send_image('my_picture.jpg')
自動響應(yīng)各類消息:
# 打印來自其他好友、群聊和公眾號的消息
@bot.register()
def print_others(msg):
print(msg)
# 回復(fù) my_friend 的消息 (優(yōu)先匹配后注冊的函數(shù)!)
@bot.register(my_friend)
def reply_my_friend(msg):
return 'received: {} ({})'.format(msg.text, msg.type)
# 自動接受新的好友請求
@bot.register(msg_types=FRIENDS)
def auto_accept_friends(msg):
# 接受好友請求
new_friend = msg.card.accept()
# 向新的好友發(fā)送消息
new_friend.send('哈哈,我自動接受了你的好友請求')
保持登陸/運行:
# 進(jìn)入 Python 命令行、讓程序保持運行 embed() # 或者僅僅堵塞線程 # bot.join()
模塊特色
-
全面對象化接口,調(diào)用更優(yōu)雅
-
默認(rèn)多線程響應(yīng)消息,回復(fù)更快
-
包含 聊天機器人、共同好友 等 實用組件
-
只需兩行代碼,在其他項目中用微信接收警告
-
愉快的探索和調(diào)試,無需涂涂改改
-
可混合使用 itchat 的原接口
-
當(dāng)然,還覆蓋了各類常見基本功能:
-
發(fā)送文本、圖片、視頻、文件
-
通過關(guān)鍵詞或用戶屬性搜索 好友、群聊、群成員等
-
獲取好友/群成員的昵稱、備注、性別、地區(qū)等信息
-
加好友,建群,邀請入群,移出群
-
說明文檔
更新日志
https://github.com/youfou/wxpy/releases
