# PyWeChatSpy

**Repository Path**: jeylee/PyWeChatSpy

## Basic Information

- **Project Name**: PyWeChatSpy
- **Description**: A spy program that helps people make better use of WeChat
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-07-02
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PyWeChatSpy
A spy program that helps people make better use of WeChat

[硬核WeChatBot](https://zhuanlan.zhihu.com/p/118674498)

##支持微信版本
* 2.8.0.133

## 返回数据样例
* `{"type":1,"wxid":"","nickname":"","wechatid":"","profilephoto_url":"","phone_num":""}`  >当前登录微信账号基本信息
* `{"type":2,"wxid":"","nickname":"","wechat_id":"",...}`  >联系人详情
* `{"type":3,"data":["wxid":"","nickname":"","remark":""]}`  >联系人列表
* `{"type":5,"data":[{"self":0,"msg_type":1,"wxid1":"","wxid2":"","head":"","content":""}]}`  >微信消息 
  * `self`类型说明：
    * 1 消息由当前登录账号发出
    * 0 消息由他人发出
  * `msg_type`类型说明：
    * 1 文本消息
    * 3 图片消息
    * 37 好友申请消息
  * `wxid1` 消息来源可能是联系人好友也可能是群
  * `wxid2` 当消息来自群时 为具体群内发言成员
  * `content` 消息具体内容
* `{"type":200}`  >心跳 用于验证微信客户端与Spy连接状态
* `{"type":303}`  >微信登出
* `{"type":9527, "content":""}`  >系统提示

## 功能列表
* `send_text(wxid, content, at_wxid="")` >发送文本
* `send_file(wxid, file)` >发送文件
* `query_contact_details(wxid)` >查询联系人详情
* `query_contact_list(step=50)` >查询联系人列表
    * `step` 联系人会异步分批返回 每次返回的联系人个数
* `accept_new_contact(encryptusername, ticket)` >接受新联系人申请
    * `encryptusername、ticket` 好友申请消息体里的字段 自行解析xml可以得到
* `send_announcement(wxid, content)` >发送群公告
* `create_chatroom("wxid1,wxid2,...,wxidn")` >创建群聊
* `share_chatroom(chatroom_wxid, "wxid1,wxid2,...,wxidn")` >分享群聊邀请链接`
* `remove_chatroom_member(chatroom_wxid, "wxid1,wxid2,...,wxidn")`  > 移除群成员
* `remove_contact(wxid)` > 移除联系人
* `add_contact_from_chatroom(chatroom_wxid, wxid, msg)` > 添加群成员为好友
* `add_unidirectional_contact_a(wxid, msg)`  > 添加单向好友(对方删除自己)
* `add_unidirectional_contact_b(wxid)`  > 添加单向好友(自己删除对方)



详细使用方法见[example.py](https://github.com/veikai/PyWeChatSpy/blob/master/example.py)