XHS-Downloader：免费开源的小红书原图下载工具，链接一贴作品就落盘
【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader
收藏夹里舍不得删的小红书笔记，网页保存的图一压缩就没法用，链接放久了又打不开。XHS-Downloader 是一个免费开源的小红书作品采集工具，把链接粘进去，它自动完成解析、下载、归档，原图和视频直接存进硬盘，无需登录账号。
30秒判断：它是不是你要的
- 存到的是原始分辨率文件，不是网页压缩版；图片格式可指定 PNG、WEBP、JPEG、HEIC 或 AUTO
- 无需登录账号，拿到作品链接就能下，Cookie 也是可选项
- 已下载的作品自动跳过，批量重跑、重启程序都不会重复下载
- 支持一次粘贴多个链接（空格分隔），自动提取其中的有效链接
已下载 ID 的持久化记录由 source/module/recorder.py 负责管理，文件修改时间还能同步成作品发布时间，整理起来很顺手。
最短上手路径：四步出第一个作品
先拉源码并进入目录：
git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader装依赖，要求 Python 3.12 及以上，两种装法任选：
# pip 安装 pip install -r requirements.txt # uv 安装（更快） uv sync --no-dev启动图形界面：
python main.py把第一个作品链接粘进输入框，点"下载作品文件"。完成后文件默认落在./Volume/Download，配置文件是./Volume/settings.json，都在项目根目录里，方便整体迁移。
按场景用：它怎么接住你的活
只存几张图：命令行挑着下
长图文动辄几十张，只想存其中几张时，用--index指定图片序号：
python main.py --url "作品链接" --index 3 6 9想换个保存路径或语言，加两个参数即可：
python main.py --url "作品链接" --work_path "D:\素材库" --language zh_CN其他参数执行python main.py --help可查，中文界面下都有说明。
让 AI 替你下：接入 MCP
把下载能力交给 AI 对话工具，一行命令起服务：
python main.py mcp然后把http://127.0.0.1:5556/mcp/配进你用的支持 MCP 的对话工具，说一句"帮我下载这个链接"就行。想走 API 调用的话，python main.py api启动后 POST/xhs/detail即可采集作品信息并触发下载。项目根目录的 example.py 是一份完整调用示例，二次开发照着改。
进阶：让它自动替你干活
收藏夹、点赞列表里有几百条笔记时，思路是：浏览器负责搬链接，程序负责下载。在 Tampermonkey 里导入项目自带的 static/XHS-Downloader.js 用户脚本，小红书网页右上角会多出一个功能菜单，可批量提取发布、点赞、收藏作品链接并复制到剪贴板，还支持自动滚动加载，长列表也能完整提取。
最顺的组合拳是：把配置里的script_server设为true，让主程序在后台当服务器；浏览器里点"推送下载任务"，脚本把任务推给程序，下载交给程序完成，浏览器只管提取。再顺手把author_archive设为true，几百条笔记会自动按作者分好文件夹。
有一句话要讲在前面：未配置 Cookie 时，视频只能下到低分辨率版本。Cookie 就是网页请求里携带的身份标识串，获取只需三步：
- 浏览器打开小红书网页版，按
F12打开开发者工具； - 切到"网络"标签，刷新页面，找到任意一个请求；
- 在请求标头里整段复制 Cookie 字段，粘进设置里，重启程序生效。
常用参数速查
| 参数 | 作用 | 默认值 |
|---|---|---|
work_path | 作品保存根路径 | 项目根目录/Volume |
folder_name | 作品存放文件夹名 | Download |
image_format | 图片下载格式（AUTO/PNG/WEBP/JPEG/HEIC） | JPEG |
image_download | 图片下载开关 | true |
video_download | 视频下载开关 | true |
folder_mode | 每篇作品单独一个文件夹 | false |
author_archive | 每个作者单独一个文件夹 | false |
download_record | 记录已下载 ID，自动跳过 | true |
proxy | 网络代理 | 无 |
所有配置项由 source/module/settings.py 统一管理，首次运行自动生成settings.json。
翻车自救：先查这三处
- 下载卡住或失败：多半是全局代理在干扰请求。关掉全局代理再试，仍不行就看程序日志里的具体报错。
- 视频清晰度上不去：多半是没配 Cookie。按上文三步配好、重启程序再下即可。
- 链接提示失效：作品链接自带日期信息，太旧的链接容易被风控拦截。用最新抓取的链接，且别在短时间内高频请求，内置的请求延时保持默认就好。
收藏夹里那些怕失效的笔记，就是值得备份的原因。花十分钟把链接变成硬盘里的文件，剩下的交给 XHS-Downloader，现在就可以动手试第一个链接 🌟
【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考