WeChat Download API MCP
A self-hosted server reads WeChat official account articles and hands them to an AI agent over MCP: search, subscribe, full text
- 1,231 ★ on the repository
- Last commit
- AGPL-3.0
Broad access
Why this level
- The service holds your WeChat account login, and excessive requests can lead to verification prompts or account limits at WeChat
- Bulk export of other people's articles touches author rights, so an archive must not be republished without permission
- `MCP_TOKEN` gives the agent your subscriptions and all stored articles, so keep it secret once the server is on a network
Install
- Works in
Manual install
git clone https://github.com/tmwgsicp/wechat-download-api.git && cd wechat-download-api && cp env.example .env && docker-compose up -dBefore starting, set `SITE_URL` in `.env`, and `ENABLE_MCP=1` and `MCP_TOKEN` for MCP.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The service holds your WeChat account login, and excessive requests can lead to verification prompts or account limits at WeChat
- Bulk export of other people's articles touches author rights, so an archive must not be republished without permission
- `MCP_TOKEN` gives the agent your subscriptions and all stored articles, so keep it secret once the server is on a network
This is third-party code. Review the repository files before installing.
What it does
WeChat Download API is a FastAPI service that fetches articles from WeChat official accounts: title, author, body as HTML or plain text and the image list. To log in to WeChat you scan a QR code on the admin page. From then on the service builds RSS 2.0 feeds for subscribed accounts with full text and images, ready for FreshRSS or Feedly. A built-in MCP server lives at `/mcp` and gives the agent six tools: `search_accounts`, `subscribe_account`, `unsubscribe_account`, `list_subscriptions`, `get_recent_articles` and `read_article`. Access is guarded by a static Bearer token, no OAuth. A request such as "subscribe to this account and summarize the last three articles" runs without leaving the editor. Articles already stored for an account export in one request to seven formats: Markdown, HTML, Word, PDF, EPUB, Excel and JSON. For requests to WeChat the service imitates a Chrome TLS fingerprint, rate-limits itself and can use a SOCKS5 proxy pool. Warnings about expiring login go out through a webhook, WeCom bots included.
Who it is for. For people who follow Chinese WeChat official accounts and want to read, summarize and archive their articles from Claude Code, Cursor or Cline.
Good fit when
- You need an RSS feed of a WeChat official account with full text for FreshRSS or Feedly
- The agent should find an account by name, subscribe and retell the latest posts
- You want an account archive in Markdown for Obsidian or for loading into an AI tool
- You prefer your own server to a third-party service: the code is open and data stays in your `data` directory
Not a fit when
- You have no WeChat account for the QR login: without it the service cannot fetch articles
- You plan to republish other people's articles publicly: the rights stay with the account authors
- You want a maintenance-free service: you run Docker and proxies yourself and watch the login expiry
- You do not follow WeChat accounts: another news source will be simpler
Example request
Find a WeChat official account by name, subscribe to it and summarize the three latest articles in EnglishMCP
- Transport
- http
- Authentication
- API key
Environment variables
ENABLE_MCPrequired- Set to 1 to enable the MCP server at /mcp.
MCP_TOKENrequired, secret- A long random string the client sends as a Bearer token.
MCP_RESOURCE_URL- Public /mcp URL when hosted on a domain, used for the allowlist.
PROXY_URLS- SOCKS5 proxy pool addresses for requests to WeChat.
Limitations
The documentation is in Chinese. Login lasts four days, then the QR code is scanned again, otherwise new articles stop arriving. The service acts as your personal WeChat account, so every WeChat restriction lands on that account. The AGPL-3.0 license requires publishing changes when a modified service is reachable over a network. Without Docker you need Python 3.8 or newer and your own virtual environment. The last commit in the repository dates from July 2026.
How to disable. Remove `ENABLE_MCP` from `.env` and delete the server with `claude mcp remove wechatrss`. Stop the service with `docker-compose down`.
FAQ
How do I connect WeChat Download API to Claude Code?
Set `ENABLE_MCP=1` and `MCP_TOKEN` in `.env`, start the service and run `claude mcp add --transport http wechatrss http://localhost:5000/mcp --header "Authorization: Bearer <MCP_TOKEN>"`. Without the token the server answers 401.
Which tools does the MCP server expose?
Six: `search_accounts`, `subscribe_account`, `unsubscribe_account`, `list_subscriptions`, `get_recent_articles` and `read_article`. New articles can be pulled with a time cursor and an account filter.
Can I export all articles of an account?
Yes. `GET /api/export/account/{fakeid}.{format}` returns stored articles as Markdown, HTML, Excel or JSON up to 3000 at a time, Word and EPUB up to 500, PDF up to 200. The export reads the local database and does not contact WeChat.
How long does the WeChat login last?
Four days after the QR scan. The service sends a webhook warning 24 and 6 hours before it ends, WeCom bots included.
Do I need a proxy for requests to WeChat?
It is advisable. A SOCKS5 proxy pool is set with `PROXY_URLS` and spreads requests. Direct requests can make WeChat ask for verification, limit the account or ban the IP.
Discussion
No questions or reviews yet.
Related
MCP serversA CLI for agents that turns Markdown into WeChat HTML, prepares covers and images, and saves drafts into an official account
Wenyan MCP
文颜 MCP Server
An MCP server that formats Markdown with ready themes and saves the article to a WeChat official account draft
X API MCP (xmcp)
X API FastMCP Server
A local FastMCP server turns the X platform OpenAPI spec into tools: searching and publishing posts, messages, lists and bookmarks
Claude skill that typesets an article for WeChat with cards and SVG infographics, uploads images and saves a draft
MCP autoposting for Telegram, VK and TenChat
Customer MCP Autoposting
An MCP server publishes one text at once to Telegram, VKontakte (group and personal wall) and TenChat with a single publish_all call
wechat-skill: WeChat article layout and drafts
wechat-skill
A skill that lays out an article for a WeChat official account, writes from a topic and saves the result to drafts unpublished
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| WeChat Download API (this card) | no | API key | 1,231 | |
| WeChat Article Skills | no | 738 | a skill set for writing and publishing WeChat articles, not a server for reading other accounts | |
| WeChat Article Search | no | 276 | a skill for searching articles by query, without subscriptions, RSS or archive export |
README in short
The project collects WeChat official account articles, serves RSS feeds and exports archives in seven formats. It comes with Swagger docs, a web admin page, a Docker image and a built-in MCP server for agents.