微信机器人 / 优雅的微信个人号API。

在 itchat 的基础上优化接口,扩展功能,提升了模块的易用性。

一些常见的场景

• 控制路由器、智能家居等具有开放接口的玩意儿
• 运行脚本时自动把日志发送到你的微信
• 加群主为好友,自动拉进群中
• 跨号或跨群转发消息
• 自动陪人聊天
• 逗人玩
• ... [1]

总而言之,可用来实现各种微信个人号的自动化操作

wxpy 需要使用 Python 3.x

可以通过以下方式安装

1. 从 PYPI 官方源下载安装 (在国内使用可能比较慢或不稳定):

   pip3 install -U wxpy
   

2. 从豆瓣 PYPI 镜像源下载安装 (建议国内用户使用):

   pip3 install -i https://pypi.doubanio.com/simple/ -U wxpy
   

登陆微信:

# 导入模块
from wxpy import *
# 初始化机器人,扫码登陆
bot = Bot()

找到好友:

# 搜索名称含有 "游否" 的男性深圳好友
my_friend = bot.friends().search('游否', sex=MALE, city="深圳")[0]

发送消息:

# 发送文本给好友
my_friend.send('Hello WeChat!')
# 发送图片
my_friend.send_image('my_picture.jpg')

自动响应各类消息:

# 打印来自其他好友、群聊和公众号的消息
@bot.register()
def print_others(msg):
 print(msg)
# 回复 my_friend 的消息 (优先匹配后注册的函数!)
@bot.register(my_friend)
def reply_my_friend(msg):
 return 'received: {} ({})'.format(msg.text, msg.type)
# 堵塞线程,并进入 Python 命令行
embed()
# 或者仅仅堵塞线程
# bot.join()

• 全面对象化接口,调用更优雅
• 默认多线程响应消息,回复更快
• 愉快的探索和调试,无需涂涂改改
• 包含 聊天机器人、共同好友 等 实用组件
• 只需两行代码,在其他项目中用微信接收警告
• 可混合使用 itchat 的原接口

• 覆盖常见基本功能

  • 发送文本、图片、视频、文件
  • 通过关键词或用户属性搜索 好友、群聊、群成员 等
  • 获取好友/群成员昵称、备注、性别、地区
  • 加好友,建群,邀请进群,踢出群

http://wxpy.readthedocs.io

https://github.com/youfou/wxpy

加入微信交流群 (真的是群哦)

• 扫描以下二维码,填写验证信息 [ wxpy ],即可自动受邀入群

https://github.com/youfou/wxpy/raw/master/docs/wechat-group.png