3 条命令跑起来的 XHS-Downloader：小红书无水印下载还能这么省心

3 条命令跑起来的 XHS-Downloader：小红书无水印下载还能这么省心

【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader

XHS-Downloader 是一款小红书无水印下载工具，把作品链接交给它，原画质文件直接落到本地。截图发出去糊、长按保存带水印这两件烦心事，到这里都翻篇了。全程开源免费，没有会员墙。

从双击到出图：XHS-Downloader 快速上手的最短路径

最省事的是现成程序：从 Releases 拿对应系统的压缩包，解压后双击main（Windows 是main.exe），图形界面就开了。

• 文件默认存到_internal\Volume\Download；
• 配置在_internal\Volume\settings.json。

macOS 第一次跑之前，先在终端执行一次，去掉安全标记：

xattr -cr 项目文件夹路径

不想装程序就用源码，要求 Python 3.12 以上，3 条命令起一个环境：

git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev

uv run main.py

起来之后，把链接粘进输入框，空格分隔，一次塞十条都没问题，点"下载作品文件"。懒得复制就点"读取剪贴板"，直接吃你刚复制的内容。

它凭什么拿到原画质：原理与画质细节

机制就一句：程序向小红书网页接口问出作品的原始媒体地址，再顺着地址把源文件取下来，页面端的水印和压缩被整段绕开。好比点外卖前直接拨了餐厅后厨的电话，报菜名取餐，而不是隔着玻璃柜台举着手机拍。

几个同类工具容易漏掉的细节：

• video_preference可指定分辨率优先、码率优先或体积优先；
• image_format支持 PNG、WEBP、JPEG、HEIC，默认 JPEG，修图选 PNG、省空间选 WEBP；
• livePhoto 动图能完整保存；
• 内置请求延时均值 6 秒，防触发风控，建议别动。

批量搬空博主主页：用户脚本提取链接的操作步骤

逐个复制博主主页的链接太慢。装一个 Tampermonkey 用户脚本：在小红书网页端打开主页，脚本能取到发布、收藏、点赞、专辑里的全部作品链接，搜索结果页的作品和用户链接也收。脚本支持自动滚动加载，默认关闭，打开后默认滚 50 次，次数可改，加载完一键复制。

只下某篇笔记的第 3、5、7 张图：命令行按序号下载

图文 30 张全下再删太费劲。命令行专门治这个：

python main.py -u "作品链接" -i "3 5 7"

-i只下指定序号的图片，多个序号用空格分隔。顺手加--image_format webp就换了输出格式。完整参数清单在 source/CLI/main.py，跑python main.py --help也会列出来。

文件长期好找：按作者自动归档的配置步骤

三个开关配合起来，文件半年后也好翻：

• author_archive设为true，每个作者按"作者ID_作者昵称"单独建文件夹，作者改昵称会自动跟着更新；
• folder_mode打开后，每篇作品单独一个目录；
• name_format改命名规则，默认就是"发布时间 作者昵称 作品标题"。

下载记录默认开着，同一篇作品第二次会被直接跳过，不占重复空间。

30 秒配 Cookie：高清视频解锁方法

没配 Cookie，视频只有低分辨率版本。配一个只要 30 秒，不用登录账号：

1. 无痕窗口打开小红书 explore 页；
2. F12 打开开发者工具，切到"网络"，勾上"保留日志"，筛cookie-name:web_session；
3. 点开任意请求，把 Cookie 字段整个复制，贴进settings.json的cookie项。

图形界面、命令行、API、MCP 四种方式怎么选

API 模式起好之后，浏览器访问http://127.0.0.1:5556/docs，自动生成的接口文档直接能调试；想自己接的，二次开发示例在 example.py。

出问题先自查 ⚠️

1. 链接提示获取失败 → 链接里带日期信息，放久了会失效 → 重新提取一条新链接再试
2. 同一作品第二次没反应 → 下载记录默认开着，自动跳过了 → 删Volume/ExploreID.db里对应 ID，或关掉download_record
3. 开了全局代理后下载失败 → 代理和请求流程冲突 → 关掉全局代理重试
4. Linux 上"读取剪贴板"没反应 → 缺 xclip 组件 →sudo apt-get install xclip
5. 视频只有低清晰度 → 没配 Cookie → 按上面 30 秒的步骤补一个
6. 跑得比预期慢 → 内置 6 秒请求延时，防风控用的 → 保持默认，别硬改

做设计找参考的、写文案攒素材的、想写脚本做自动化采集的，用着最顺手。工具是免费的，但下载的内容请只留作个人学习和研究，尊重原创作者的版权，别商用、别二次传播。

【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader