WeChat Download API

微信公众号文章获取 · RSS 订阅 · 多格式导出

完全开源 | 免费部署 | RSS 订阅 | 文章抓取 | 多格式导出 | 反风控

100% 开源，100% 免费。 代码完全公开，私有化部署无任何限制，不搞"开源"之名行收费之实。

---

功能特性

• RSS 订阅 — 订阅任意公众号，自动定时拉取新文章（包含完整文章内容和图片），生成标准 RSS 2.0 源，接入 FreshRSS / Feedly 等阅读器即可使用；支持批量添加（粘多个公众号名称一次性订阅）

• MCP · AI 客户端接入 — 内置 MCP 服务，Claude / Codex / Cline / Cursor 等 AI 客户端可直接搜索、订阅、读文章（6 个工具，静态 Token 鉴权，单用户自托管无需 OAuth）

• 文章内容获取 — 通过 URL 获取文章完整内容（标题、作者、正文 HTML / 纯文本、图片列表）

• 多格式导出 — 单篇 markdown 增量同步（带 YAML frontmatter，导入 Obsidian / Logseq）；整号文章一键打包成 Markdown / HTML / Word / PDF / EPUB / Excel / JSON 7 种格式（Word/PDF/EPUB 图片内嵌离线可看），纯读本地库、不触发抓取

• 反风控体系 — Chrome TLS 指纹模拟 + SOCKS5 代理池轮转 + 三层自动限频，有效对抗微信封控

• 文章列表 & 搜索 — 获取任意公众号历史文章列表，支持分页和关键词搜索

• 公众号搜索 — 按名称搜索公众号，获取 FakeID

• 公众号主体信息 — 获取公众号认证主体、认证状态、原创文章数等详细信息

• 扫码登录 — 微信公众平台扫码登录，凭证自动保存，4 天有效期

• 图片代理 — 代理微信 CDN 图片，解决防盗链问题

• Webhook 通知 — 登录过期提醒（提前24h/6h预警+已过期通知）、触发验证等事件自动推送（支持企业微信机器人）

• API 文档 — 自动生成 Swagger UI / ReDoc，在线调试所有接口

  管理面板 — 登录状态、接口文档、在线测试一站式管理

  RSS 订阅管理 — 搜索公众号一键订阅，复制地址接入 RSS 阅读器

---

📦 整号导出，随身带走

订阅只是第一步。把整个公众号的存量文章一键打包成你想要的格式——喂给 AI、导入笔记、离线存档、换设备迁移，全都行。

• ❌ 一篇一篇复制粘贴，图片还丢失
• ❌ 想喂给 AI，却拿不到干净的 Markdown
• ❌ 换阅读器 / 换设备，历史内容带不走
• ✅ 一个公众号一键打包，7 种格式任选，纯读本地库、不触发任何微信抓取（零风控风险）

格式	后缀	适合场景	图片	单次上限
📝 Markdown 合集	.zip	归档 / 喂 AI / 导入 Obsidian、Logseq	引用式	3000
🌐 HTML 合集	.html	单文件、带目录、暗色适配，浏览器直接看	引用式	3000
📊 Excel	.xlsx	文章清单表（标题 / 作者 / 时间 / 链接）	—	3000
🔧 JSON	.json	二次开发 / 数据分析	—	3000
📄 Word	.docx	可编辑文档，图去重压缩	内嵌	500
📕 PDF	.pdf	固定排版、内置中文字体免装	内嵌	200
📱 EPUB	.epub	手机 / 电子书阅读器读合集	内嵌	500

文本/表格类（Markdown / HTML / Excel / JSON）图片引用式、秒出、零抓图带宽；离线自包含类（Word / PDF / EPUB）会把微信图现抓内嵌进文件、断网也能看图。全部只导已抓到正文的文章，支持按时间范围（全部 / 最近 N 天 / 时间窗 / 增量）筛选。

在 RSS 管理页（/rss.html）每个订阅右侧点「下载文章」即可可视化选格式与时间范围；也可直接调接口 GET /api/export/account/{fakeid}.{格式}，详见下方 整号文章导出（多格式）。

---

Docker 部署 🐳

最快速的部署方式，无需配置 Python 环境，一键启动：

# 方式一：使用 docker-compose（推荐）
git clone https://github.com/tmwgsicp/wechat-download-api.git
cd wechat-download-api
cp env.example .env
# 编辑 .env 设置 SITE_URL 为实际访问地址
docker-compose up -d

# 方式二：直接运行
docker run -d \
  -p 5000:5000 \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/.env:/app/.env \
  --name wechat-api \
  tmwgsicp/wechat-download-api:latest

服务启动后访问 http://localhost:5000/login.html 扫码登录即可使用。

支持多架构：linux/amd64 / linux/arm64（Apple Silicon、树莓派、ARM 服务器）

---

SaaS 托管版 — 已上线 🚀

不想折腾部署？30 秒注册即可使用 👉 wechatrss.waytomaster.com

搜索公众号名称，拿到 RSS 链接，丢进你的阅读器——Feedly、Inoreader、NetNewsWire 全部兼容。

---

使用前提

本工具需要通过微信公众平台后台的登录凭证来调用接口，因此使用前需要：

1. 拥有一个微信公众号（订阅号、服务号均可）
2. 部署并启动服务后，访问登录页面用公众号管理员微信扫码登录
3. 登录成功后凭证自动保存到 .env 文件，有效期约 4 天，过期后需重新扫码

登录后即可通过 API 获取任意公众号的公开文章（不限于自己的公众号）。

本地电脑可以直接使用！ 不需要公网服务器——在本地启动服务后通过 localhost 访问即可完成扫码登录和全部功能。只有当你需要从其他设备（如手机 RSS 阅读器）远程访问时，才需要公网服务器或内网穿透。

---

快速开始

方式一：Docker 部署（推荐）

# 1. 克隆项目
git clone https://github.com/tmwgsicp/wechat-download-api.git
cd wechat-download-api

# 2. 配置环境变量
cp env.example .env
# 编辑 .env，设置 SITE_URL 为实际访问地址（如 http://your-domain.com）

# 3. 启动服务
docker-compose up -d

# 4. 查看日志
docker-compose logs -f

方式二：一键脚本部署

第一步：克隆项目