wechatDownload 中文使用教程

一、项目速览

入门 · 1 分钟版

它是什么：wechatDownload 是一个桌面端 GUI 工具，能批量下载微信公众号的历史文章，并保存为 HTML、MHTML、Markdown、PDF、DOCX 或 CSV 表格。它还能顺带下载文章里的图片、视频、音频以及评论区内容。

它解决什么问题：微信公众号没有官方的批量导出功能。如果你想做内容备份、离线阅读、数据归档（比如把某垂直领域的文章整理成知识库），或者需要把公众号内容转入 Notion/Obsidian 等笔记工具，手动的“复制-粘贴-保存”流程极其低效。这个工具把整个过程自动化了。

谁最该用：
- 内容创作者/研究者：需要批量抓取某个公众号的全部文章做分析
- 知识管理爱好者：想把微信文章存到本地知识库，避免链接失效
- 后端/爬虫开发者：想快速获取公众号文章数据，再二次加工

一句话判断：如果你需要“一次性把某个公众号翻个底朝天”的下载工具，这是目前 GitHub 上最成熟的开源方案之一（8.4k Star）。

二、核心功能与架构

进阶 · 推荐细读

核心功能拆解

批量下载历史文章：输入公众号 ID 后，工具会自动翻页获取该公众号的所有历史文章。你可以设置下载的起始页数、时间范围，甚至只下载原创文章。下载过程中支持暂停/继续，不会因为网络波动前功尽弃。

多格式导出：这是它最实用的设计。同一篇文章可以同时保存为：
- HTML/MHTML：保留原始排版，适合浏览器直接打开
- Markdown：适合导入笔记软件（Obsidian、Notion 等）
- PDF/DOCX：适合打印或分享给非技术人员
- CSV：导出文章标题、链接、发布时间等元数据，方便做数据分析

多媒体资源下载：文章内的图片、封面图、视频、音频都会按文章分类存储，文件名以“日期+标题”命名，不会乱成一团。

评论与合集下载：除了正文，还能抓取评论区（含回复），以及公众号的合集/专栏内容。这对做内容研究的人来说是刚需。

架构逻辑

这个工具本质上是一个浏览器自动化 + 微信开放能力的组合体：
1. 你提供公众号里任意一篇文章的链接
2. 工具通过微信内置浏览器的认证机制获取临时密钥（类似 session token）
3. 利用这个密钥，调用微信后台的接口翻页拉取文章列表
4. 逐篇下载内容并转码

作者视角补充：这里有个关键限制——必须用微信内置浏览器打开链接才能获取密钥。如果你习惯用 Chrome/Safari 打开微信链接，会一直卡在“获取密钥”这一步。这个坑我专门测过，原因是微信对非官方浏览器的请求做了签名校验，绕不过去。

软件主界面展示

三、动手实践

入门

环境准备

这个项目是纯客户端工具，不需要配后端或数据库。你只需要：

下载最新版本：前往 GitHub Releases 页面下载对应系统的压缩包（Windows 选 .exe，Mac 选 .dmg 或 .app）
微信客户端：确保电脑上安装了微信（用于打开链接获取密钥）
一个目标公众号：先想好你要下载哪个公众号的内容

如果你是 macOS 用户，下载后如果提示“无法验证开发者”，去 系统设置 → 隐私与安全性 中允许运行即可。

最小可运行示例

第一步：获取公众号 ID

打开软件，找到目标公众号里任意一篇文章（比如从手机微信转发到电脑），复制文章链接，粘贴到软件的输入框中，点击 “获取公众号ID”。

获取公众号ID的界面

软件会自动解析出该公众号的唯一 ID（类似 gh_xxxxxxxxxxxx）。

第二步：获取密钥

点击 “复制链接” 按钮，软件会自动把链接复制到剪贴板。然后：
- 打开电脑微信
- 把链接粘贴到“文件传输助手”并发送
- 点击这个链接（必须在微信内置浏览器中打开）

稍等 5-15 秒，软件会自动检测到密钥并填入。你会看到状态栏提示“获取密钥成功”。

常见踩坑 1：如果等了 30 秒还没获取到密钥，检查两件事：① 是否在微信内置浏览器打开的链接（非系统默认浏览器）；② 微信版本是否为 4.0 及以上（旧版微信的接口不同）。

第三步：开始下载

密钥获取成功后，在软件中设置：
- 下载格式：建议先选 HTML（最稳定），想导入笔记再选 Markdown
- 下载页数：如果不确定公众号文章总数，先填 3 页试跑
- 是否下载评论：勾上“下载评论”会多花一些时间

点击 “开始下载”，工具会逐页拉取文章并保存到本地文件夹。你可以在软件界面看到实时进度。

下载过程中的界面

常见踩坑 2：部分公众号的文章是“纯文字”（无图无排版），早期版本会下载失败。4.6 版本已修复这个问题。如果你下载某个公众号一直报错，建议先更新到最新版。

验证结果

下载完成后，打开软件指定的输出目录（默认在桌面或软件目录下的 download 文件夹），你应该能看到：
- 以文章标题命名的文件夹/文件
- 如果是 HTML 格式，双击即可在浏览器打开，排版与原文一致
- 如果是 Markdown 格式，可以直接拖入 Obsidian 或 VS Code 查看

四、进阶玩法

深入 · 老手可选

MCP 调用：把下载能力嵌入你的工具链

4.4 版本开始支持 MCP（Model Context Protocol），这意味着你可以把公众号下载能力接入到 AI 编程助手（如 Cursor、Claude Desktop）中，让 AI 帮你批量操作。

配置方式：

在软件设置中开启 MCP 服务（默认监听 0.0.0.0:8080），然后在你的 AI 工具中配置 MCP 客户端：

{
  "mcpServers": {
    "wechatDownload": {
      "url": "http://localhost:8080/mcp",
      "tools": [
        "download_articles",
        "get_article_list",
        "get_public_account_id"
      ]
    }
  }
}

之后你就可以在 AI 助手的对话中直接说：“帮我下载公众号‘长风的储物柜’最近 10 篇文章，保存为 Markdown 格式”，AI 会调用 MCP 接口完成操作。

作者视角补充：MCP 目前还是实验性功能，如果你不是 AI 工具的重度用户，可以跳过。但如果你是做后端开发的，建议先看这个——它意味着你可以把这个下载能力封装成微服务，供团队其他成员调用。

定时自动下载

虽然软件没有内置定时任务，但你可以用系统自带的计划任务 + 命令行参数来实现：

# Windows 计划任务示例（假设软件支持命令行参数）
# 注意：目前软件主要依赖 GUI 操作，命令行参数需等后续版本支持
# 这里展示的是思路：用 AutoIt 或 Python 脚本模拟点击

实际更可行的方案是：用 Python 的 pyautogui 库编写一个简单的 GUI 自动化脚本，每天定时启动软件、填入公众号 ID、点击下载。

数据清洗与二次加工

下载的 CSV 文件包含了文章标题、链接、发布时间、阅读量等字段。你可以用 Pandas 快速分析：

import pandas as pd

df = pd.read_csv('公众号文章列表.csv')
# 筛选阅读量最高的 10 篇
top_10 = df.sort_values('阅读量', ascending=False).head(10)
# 导出为 Excel
top_10.to_excel('公众号爆款文章.xlsx', index=False)

五、判断与建议