微信公众号文章批量下载：从扫码登录到 6 种格式导出的完整流程

【免费下载链接】wechat-article-exporter一款在线的 微信公众号文章批量下载 工具，支持导出阅读量与评论数据，无需搭建任何环境，可通过 在线网站 使用，支持 docker 私有化部署和 Cloudflare 部署。 支持下载各种文件格式，其中 HTML 格式可100%还原文章排版与样式。项目地址: https://gitcode.com/gh_mirrors/we/wechat-article-exporter

wechat-article-exporter 是一款开源的微信公众号文章批量下载工具，核心目标是把指定公众号的历史文章完整导出到本地。它基于 Nuxt 3 + Vue 3 构建，运行在浏览器中，本地启动后在一个页面里就能完成搜索、抓取、过滤和导出。除正文外，HTML 格式可 100% 还原文章排版与样式，阅读量、留言等数据也能一并导出。

项目速览

一句话定位：在线的微信公众号文章批量下载与导出工具，可本地运行，也可 Docker 私有化部署或部署到 Cloudflare。

• 关键字搜索公众号，同步全部历史文章列表（每页 20 篇、默认 3 秒一页，本地缓存已同步范围）
• 支持 6 种导出格式：HTML / JSON / Excel / TXT / Markdown / DOCX，其中 HTML 打包图片和样式，打开即可还原微信内排版；Word 与 PDF 处于内测阶段
• 扩展数据：阅读量、点赞、分享、评论（需本地配置 Credential 服务）
• 覆盖合集、图片分享、视频分享等消息类型，并开放 server/api/public/ 下的 API 接口

开源仓库采用 MIT 协议，克隆地址见下文环境准备一节。

环境准备与本地启动

前置依赖：

• Node.js ≥ 22
• Yarn 1.22.22（由 corepack 管理，无需单独安装）

获取项目：

git clone https://gitcode.com/gh_mirrors/we/wechat-article-exporter cd wechat-article-exporter

成功后目录中应有 nuxt.config.ts、package.json 等文件。

准备 yarn 环境：

corepack enable corepack prepare yarn@1.22.22 --activate

预期无报错，yarn -v输出 1.22.22。

安装依赖：

yarn

安装过程会自动执行 nuxt prepare，成功的标志是终端输出 "Done in ..." 且无红色报错。

启动开发服务器：

yarn dev

首次启动需要编译，耐心等待。完成后在浏览器访问 http://localhost:3000，能看到"公众号管理"页面即启动成功。若 3000 端口被占用，Nuxt 会自动换用下一个端口，以终端输出为准。

核心操作：从扫码登录到批量导出的完整链路

1. 扫码登录公众号

打开页面后，在"公众号管理"页点击"添加"或"同步"，会弹出"登录微信公众号"窗口，用微信扫码并确认。

登录状态保存在本地，有效期内无需重复扫码。项目承诺不会把扫码登录的账号用于任何公共爬虫。

2. 添加目标公众号

在搜索弹窗中输入名称或关键字，从匹配列表中选择目标公众号，确认后工具会自动同步第一页文章数据。

搜索不到目标时更换关键字；搜索依赖公共代理额度，请求失败可稍后重试。

3. 同步文章列表

在列表中勾选公众号并点击"同步"。同步范围可选：最近 24 小时、一天、三天、七天、一个月、三个月、半年、一年、全部或自定义时间。

大账号同步耗时较长，可随时停止、稍后继续；表格中的"已同步消息数"和"同步进度"会实时更新，命中本地缓存的范围会自动跳过。

4. 抓取文章内容

切换到"文章下载"页，选择公众号，勾选目标文章（支持按作者、标题、发布时间、是否原创等列过滤），点击"抓取 → 文章内容"。

阅读量与留言内容需要本地 Credential 服务（默认监听 127.0.0.1:8088），未配置时仅能抓取正文 HTML。抓取中途可点击"停止"。

5. 导出文件

保持文章勾选，点击"导出"，选择 HTML、JSON、Excel、TXT、Markdown 或 DOCX 格式，文件直接下载到本地。

导出目录名支持${account}、${title}、${YYYY}-${MM}-${DD}等变量，在设置页可自定义目录结构，便于按账号和日期归档。

它能帮你解决什么：功能与典型场景

内容存档（自媒体、个人知识库）

想给历史文章留一份完整副本：

• HTML 全量导出，图片与样式随包保存，浏览器打开即还原微信内排版
• 合集批量下载，整本教程类合集一次取走
• 目录名变量模板，按公众号、日期自动分文件夹

数据统计（运营、竞品分析）

需要分析内容表现时：

• 阅读量、点赞、分享、留言数可导出到 Excel / JSON
• 按原创标识、发布时间、作者过滤，只导出关心的子集
• 列表数据缓存在浏览器 IndexedDB 中，重复统计不重复抓取

素材收集（教育、研究）

只取部分内容时：

• 列过滤器组合使用：标题关键字 + 时间范围 + 原创/非原创
• 图片分享、文本分享、视频分享消息也能下载，不限于普通图文
• 已删除的文章仍保留在列表中并标记状态，标题、发布时间等基础信息可导出

被删文章的正文 HTML 无法再抓取，但元数据仍可用于归档记录。

交流渠道

进阶玩法与效率提升

Docker 私有化部署

适合没有 Node 环境、或想要长期稳定实例的场景：

yarn docker:build docker run -p 3000:3000 ghcr.io/wechat-article/wechat-article-exporter:latest

镜像基于 node:22-slim，内置 Chromium 与中文字体，PDF 相关能力依赖这一点。

增量同步策略

维护多个账号、长期使用时：

• 把同步范围设为"最近 24 小时"或"最近一天"，每次只抓新增文章
• IndexedDB 缓存命中已有范围时自动快进，不重复请求
• 公众号列表可"批量导出"为 JSON，换机器后用"批量导入"恢复，数据迁移不丢进度

私有代理与 API 对接

公共代理额度不稳定时：

• 在设置页"代理节点"中填写私有代理地址，一行一个，必须以 http/https 开头；留空则走公共代理
• server/api/public/ 下的接口可对接自有脚本，把导出流程纳入自动化

遇到问题先看这里

• 获取二维码失败、无法登录 → 当前网络访问不了微信 mp 域名 → 更换网络环境后重新请求二维码
• 同步中途提示 session expired → 公众号登录态过期 → 重新扫码登录后继续同步
• 阅读量、留言列始终为空 → 本地 Credential 服务未运行 → 按项目文档部署 wxdown 程序，确认其监听 127.0.0.1:8088
• 大批量抓取失败、进度卡住 → 公共代理额度受限或 IP 被限制 → 在设置页配置私有代理节点
• 文章状态显示"已删除" → 作者已在公众号后台删除 → 正文不可获取，仅能导出标题等基础信息

运行边界与合规提醒

• 数据留在本地：文章数据缓存在浏览器 IndexedDB，导出文件下载到你自己磁盘，工具不向第三方上传你的抓取结果
• 账号用途限定：程序声明不会把扫码登录的公众号作为公共账号池供他人爬取，登录态只服务于你自己的抓取
• 版权边界：抓取内容的版权归原作者所有，建议用于个人学习、研究与存档，未经授权不得转载发布

1. 用yarn dev启动服务，先挑一个文章数量少的公众号，走通"同步 → 抓取 → 导出"完整流程
2. 在设置页确定导出目录名变量模板，形成一套打算长期沿用的归档结构
3. 需要阅读量和评论数据时，先把本地 Credential 服务跑通再开始批量抓取
4. 长期使用时改用 Docker 部署或配置私有代理节点，降低失败率

第一批文章导出到本地后，后续按固定节奏做增量同步即可。

【免费下载链接】wechat-article-exporter一款在线的 微信公众号文章批量下载 工具，支持导出阅读量与评论数据，无需搭建任何环境，可通过 在线网站 使用，支持 docker 私有化部署和 Cloudflare 部署。 支持下载各种文件格式，其中 HTML 格式可100%还原文章排版与样式。项目地址: https://gitcode.com/gh_mirrors/we/wechat-article-exporter