WeChat Download API

在信息聚合日益重要的今天，微信公众号却是一座“信息孤岛”，缺乏原生的 RSS 支持。WeChat Download API 是一款 100% 开源、免费且支持私有化部署 的工具，它能将任意公众号转化为标准的 RSS 2.0 订阅源，并提供强大的文章抓取、搜索及反风控能力，让你重新掌控阅读主动权。

🌟 核心亮点

• 📡 全能 RSS 订阅：订阅任意公众号，自动定时拉取新文章（含完整正文、图片），生成标准 RSS 源，完美适配 FreshRSS、Feedly、Reeder 等阅读器。
• 🛡️ 强力反风控体系：
  • Chrome TLS 指纹模拟：使用 curl_cffi 库模拟真实浏览器指纹，请求特征与真人无异。
  • SOCKS5 代理池轮转：支持配置多个代理 IP，自动轮询分散请求，有效规避微信的频次限制和封禁。
  • 三层自动限频：内置智能流控，保护账号安全。
• 🔍 深度内容获取：
  • 支持获取文章完整 HTML/纯文本、作者、发布时间及高清图列表。
  • 支持公众号搜索（获取 FakeID）、历史文章列表分页获取及关键词搜索。
  • 图片代理：自动解决微信 CDN 图片的防盗链问题，确保 RSS 阅读器中图片正常显示。
• 🔐 安全便捷登录：采用微信公众平台扫码登录方式，凭证本地保存（有效期约 4 天），过期自动提醒重登。支持 Webhook 通知（如企业微信机器人）。
• 💻 灵活部署：
  • 本地运行：无需公网服务器，本地电脑启动即可使用（适合个人抓取）。
  • 私有部署：支持 Docker、Systemd 服务化部署，配合 Nginx 反向代理，打造专属云端服务。

🚀 快速上手指南

第一步：克隆项目

git clone https://github.com/tmwgsicp/wechat-download-api.git
cd wechat-download-api

第二步：一键启动

• Linux/macOS: bash start.sh
• Windows: start.bat
  脚本会自动检查环境、创建虚拟环境、安装依赖并启动服务。

第三步：扫码登录
访问 http://localhost:5000/login.html，使用公众号管理员微信扫码。登录成功后，Token 和 Cookie 会自动保存至 .env 文件。

第四步：开始使用

• 管理面板：http://localhost:5000
• API 文档：http://localhost:5000/api/docs (Swagger UI)
• 获取 RSS：搜索公众号得到 fakeid，访问 /api/rss/{fakeid} 即可获取订阅链接。

⚙️ 进阶配置：构建高可用代理池（防封号关键）

为了稳定获取完整文章内容，强烈建议配置 SOCKS5 代理池。

1. 准备资源：购买 2-3 台低价 VPS（轻量应用服务器即可）。
2. 安装 GOST：在每台 VPS 上安装并运行 GOST SOCKS5 代理服务。

   # 示例：启动带认证的 SOCKS5 服务
   gost -L socks5://user:pass@:1080
   

3. 配置主程序：在主服务器的 .env 文件中填入代理地址：

   PROXY_URLS=socks5://user:pass@ip1:1080,socks5://user:pass@ip2:1080
   

   系统会自动轮询这些代理，极大降低单 IP 请求频率，避免触发微信风控。

📊 主要 API 接口一览