Skip to main content

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

Project description

微信机器人 / 优雅的微信个人号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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wxpy-0.3.4.1.tar.gz (32.4 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page