# youfou/wxpy

微信机器人 / 可能是最优雅的微信个人号 API ✨✨

Repository: https://github.com/youfou/wxpy
Canonical: https://ross.abutalabs.com/products/wxpy
Homepage: http://wxpy.readthedocs.io
Language: Python
License: MIT
License Family: permissive
Topics: wechat, weixin, api
Archived: true
Last push: 2019-07-14T17:59:47+00:00

## Health v2 (maintenance only)
Score: 10/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3481, "days_push": 2607, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: archived
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 14258, forks 2362 (observed 2026-08-28T04:11:06.630403+00:00)

## What it is
wxpy is a Python library providing an elegant, object-oriented API for automating WeChat personal accounts, built on top of itchat. It supports sending messages, searching contacts, auto-responding to messages, and managing friends and group chats.

## Use cases
- send logs or alerts from scripts to my WeChat
- build a WeChat bot that auto-replies to friends
- automatically accept friend requests and invite users to groups
- forward messages across WeChat accounts or groups
- search friends and group members by keyword or attributes
- hook a chatbot into my personal WeChat account

## When to choose
- you need to automate a WeChat personal account in Python
- you want a friendlier API than raw itchat for WeChat messaging
- you want to receive script notifications via WeChat

## When to avoid
- you need an actively maintained library - the last release was 2019 and Web WeChat login is often restricted
- you need official WeChat APIs or business account support
- you need support for modern Python versions (3.7+)

## Facets
- artifact type: library
- maturity: abandoned
- function: chatbot, workflow-automation, sdk, webhook
- domain: chatbots, messaging-platforms, developer-tools
- platform: python, cross-platform
- tags: wechat, personal-account-api, itchat-wrapper, message-automation, unofficial-api, automation

## Member repositories
- youfou/wxpy (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:06.630403+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:12:41.688894+00:00, confidence not recorded.
  - readme: https://github.com/youfou/wxpy (fetched 2026-08-28T04:11:06.630403+00:00, sha 5361a1a0ec30)
  - homepage: http://wxpy.readthedocs.io (fetched 2026-08-29T08:06:18.865136+00:00, sha 111bd4940849)
  - registry_pypi: https://pypi.org/pypi/wxpy/json (fetched 2026-08-29T08:06:18.874522+00:00, sha b65f21ecd699)
- Data as of 2026-08-30T08:39:29.467469+00:00.