tmwgsicp/wechat-download-api

What it solves

This project provides a way to bypass the closed nature of the WeChat Official Accounts ecosystem. It allows users to subscribe to any public account via RSS, scrape full article content (including images), and export archives into various formats for offline reading or AI training, all while implementing anti-bot measures to avoid account bans.

How it works

The system acts as an API bridge that requires a WeChat Official Account administrator login via QR code to obtain necessary credentials. It then uses a combination of Chrome TLS fingerprint simulation (via curl_cffi) and a SOCKS5 proxy pool to mimic real browser behavior and rotate IP addresses, reducing the risk of being flagged by WeChat's security systems. It features a background poller that automatically fetches new articles for subscribed accounts and stores them in a local SQLite database.

Who it’s for

• RSS Users: People who want to follow WeChat accounts in standard readers like Feedly or FreshRSS.
• Knowledge Managers: Users of Obsidian or Logseq who want to sync WeChat articles as Markdown files.
• AI Enthusiasts: Those who need clean, structured data (Markdown/JSON) from WeChat to feed into LLMs or personal knowledge bases.
• Developers: Anyone needing a programmatic way to search for accounts and retrieve article metadata.

Highlights

• AI Integration: Built-in Model Context Protocol (MCP) server allowing AI clients like Claude, Cursor, and Cline to search, subscribe, and read articles directly.
• Multi-Format Export: One-click archiving of entire accounts into Markdown, HTML, Word, PDF, EPUB, Excel, or JSON.
• Anti-Risk System: Implements TLS fingerprinting, proxy rotation, and three-layer rate limiting to combat WeChat's anti-scraping mechanisms.
• Full Content RSS: Unlike basic scrapers, it generates RSS 2.0 feeds containing the full article body and images.
• Image Proxy: Includes a built-in proxy to solve WeChat's image hotlinking (anti-leech) restrictions.