{"id":13488728,"url":"https://github.com/youfou/wxpy","last_synced_at":"2025-10-05T18:31:07.187Z","repository":{"id":37359193,"uuid":"82588597","full_name":"youfou/wxpy","owner":"youfou","description":"微信机器人 / 可能是最优雅的微信个人号 API ✨✨","archived":true,"fork":false,"pushed_at":"2019-07-14T17:59:47.000Z","size":600,"stargazers_count":14074,"open_issues_count":303,"forks_count":2388,"subscribers_count":552,"default_branch":"master","last_synced_at":"2025-01-02T09:40:49.874Z","etag":null,"topics":["api","wechat","weixin"],"latest_commit_sha":null,"homepage":"http://wxpy.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/youfou.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-02-20T18:20:46.000Z","updated_at":"2024-12-31T16:48:31.000Z","dependencies_parsed_at":"2022-08-08T20:01:19.422Z","dependency_job_id":null,"html_url":"https://github.com/youfou/wxpy","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/youfou%2Fwxpy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/youfou%2Fwxpy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/youfou%2Fwxpy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/youfou%2Fwxpy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/youfou","download_url":"https://codeload.github.com/youfou/wxpy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235432149,"owners_count":18989467,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","wechat","weixin"],"created_at":"2024-07-31T18:01:20.814Z","updated_at":"2025-10-05T18:31:01.897Z","avatar_url":"https://github.com/youfou.png","language":"Python","readme":"wxpy: 用 Python 玩微信\n==============================\n\n.. image:: https://badge.fury.io/py/wxpy.svg\n    :target: https://badge.fury.io/py/wxpy\n\n.. image:: https://img.shields.io/pypi/pyversions/wxpy.svg\n        :target: https://github.com/youfou/wxpy\n\n.. image:: https://readthedocs.org/projects/wxpy/badge/?version=latest\n    :target: http://wxpy.readthedocs.io/zh/latest/?badge=latest\n\n微信机器人 / 可能是最优雅的微信个人号 API\n    wxpy 在 itchat 的基础上，通过大量接口优化提升了模块的易用性，并进行丰富的功能扩展\n\n\n..  attention::\n\n    | **强烈建议仅使用小号运行机器人！**\n\n    | 从近期 (17年6月下旬) 反馈来看，使用机器人存在一定概率被限制登录的可能性。\n    | 主要表现为无法登陆 Web 微信 (但不影响手机等其他平台)。\n\n\n\n用来干啥\n----------------\n\n一些常见的场景\n\n* 控制路由器、智能家居等具有开放接口的玩意儿\n* 运行脚本时自动把日志发送到你的微信\n* 加群主为好友，自动拉进群中\n* 跨号或跨群转发消息\n* 自动陪人聊天\n* 逗人玩\n* ...\n\n总而言之，可用来实现各种微信个人号的自动化操作\n\n\n..\n    体验一下\n    ----------------\n\n    **这有一个现成的微信机器人，想不想调戏一下？**\n\n    记得填写入群口令 👉 [ **wxpy** ]，与群里的大神们谈笑风生 😏\n\n    ..  image:: https://github.com/youfou/wxpy/raw/master/docs/wechat-group.png\n\n\n轻松安装\n----------------\n\nwxpy 支持 Python 3.4-3.6，以及 2.7 版本\n\n将下方命令中的 \"pip\" 替换为 \"pip3\" 或 \"pip2\"，可确保安装到对应的 Python 版本中\n\n1. 从 PYPI 官方源下载安装 (在国内可能比较慢或不稳定):\n\n..  code:: shell\n\n    pip install -U wxpy\n\n2. 从豆瓣 PYPI 镜像源下载安装 (**推荐国内用户选用**):\n\n..  code:: shell\n\n    pip install -U wxpy -i \"https://pypi.doubanio.com/simple/\"\n\n\n简单上手\n----------------\n\n\n登陆微信:\n\n..  code:: python\n\n    # 导入模块\n    from wxpy import *\n    # 初始化机器人，扫码登陆\n    bot = Bot()\n\n找到好友:\n\n..  code:: python\n\n    # 搜索名称含有 \"游否\" 的男性深圳好友\n    my_friend = bot.friends().search('游否', sex=MALE, city=\"深圳\")[0]\n\n发送消息:\n\n..  code:: python\n\n    # 发送文本给好友\n    my_friend.send('Hello WeChat!')\n    # 发送图片\n    my_friend.send_image('my_picture.jpg')\n\n自动响应各类消息:\n\n..  code:: python\n\n    # 打印来自其他好友、群聊和公众号的消息\n    @bot.register()\n    def print_others(msg):\n        print(msg)\n\n    # 回复 my_friend 的消息 (优先匹配后注册的函数!)\n    @bot.register(my_friend)\n    def reply_my_friend(msg):\n        return 'received: {} ({})'.format(msg.text, msg.type)\n\n    # 自动接受新的好友请求\n    @bot.register(msg_types=FRIENDS)\n    def auto_accept_friends(msg):\n        # 接受好友请求\n        new_friend = msg.card.accept()\n        # 向新的好友发送消息\n        new_friend.send('哈哈，我自动接受了你的好友请求')\n\n保持登陆/运行:\n\n..  code:: python\n\n    # 进入 Python 命令行、让程序保持运行\n    embed()\n\n    # 或者仅仅堵塞线程\n    # bot.join()\n\n\n模块特色\n----------------\n\n* 全面对象化接口，调用更优雅\n* 默认多线程响应消息，回复更快\n* 包含 聊天机器人、共同好友 等 `实用组件 \u003chttp://wxpy.readthedocs.io/zh/latest/utils.html\u003e`_\n* 只需两行代码，在其他项目中用微信接收警告\n* `愉快的探索和调试 \u003chttp://wxpy.readthedocs.io/zh/latest/console.html\u003e`_，无需涂涂改改\n* 可混合使用 itchat 的原接口\n* 当然，还覆盖了各类常见基本功能:\n\n    * 发送文本、图片、视频、文件\n    * 通过关键词或用户属性搜索 好友、群聊、群成员等\n    * 获取好友/群成员的昵称、备注、性别、地区等信息\n    * 加好友，建群，邀请入群，移出群\n\n说明文档\n----------------\n\nhttp://wxpy.readthedocs.io\n\n更新日志\n----------------\n\nhttps://github.com/youfou/wxpy/releases\n\n项目主页\n----------------\n\nhttps://github.com/youfou/wxpy\n","funding_links":[],"categories":["Python","Python (144)","微信"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyoufou%2Fwxpy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyoufou%2Fwxpy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyoufou%2Fwxpy/lists"}