小红书无水印下载：4 个入口带走原画质作品，附避坑清单

小红书无水印下载：4 个入口带走原画质作品，附避坑清单

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

需要把小红书图文、视频无水印、原画质存到本地？XHS-Downloader 就是干这个的：开源的小红书批量下载工具，支持小红书原画质保存、小红书 livePhoto 下载、按作者归档下载。这一篇就是完整的 XHS-Downloader 教程，从单篇作品到整个账号的搬运，看完就能上手。

和手机"长按保存"的差距，一句话讲清

先说结论：手机长按保存拿到的是页面端压缩过、带水印的二手文件；XHS-Downloader 拿到的是服务器上的原始文件。

原理一句话：程序拿到作品链接后，向小红书网页接口问出原始资源地址，再顺着地址把源文件抓回本地，整条链路绕开了页面压缩和水印环节。

类比一下：就像在视频平台看片，手机截图存下的是"边播边截"的模糊帧，而这个工具是直接把你点播的那个源文件拷回硬盘。

几个用得上的细节：

• 视频可用video_preference指定分辨率、码率、体积三种偏好
• 图文可用image_format输出AUTO / PNG / WEBP / JPEG / HEIC，省空间选 WEBP，修图选 PNG
• livePhoto 动图文件也能一并拿下，这点不少同类工具做不到

3 条命令跑起来：装依赖、启动、粘链接

环境要求只有一条：Python3.12或更高。怕折腾直接走路线 A。

路线 A：现成程序

去仓库 Releases 页下载对应系统的压缩包，解压后双击main（Windows 是main.exe），图形界面就开了。文件默认落到_internal\Volume\Download，配置在_internal\Volume\settings.json。macOS 用户首次运行前在终端执行一次xattr -cr 项目文件夹路径，否则系统安全限制会拦着不让开。

路线 B：源码运行

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

不想用 uv，pip install -r requirements.txt装依赖也行。启动后把作品链接粘进输入框——多个链接空格分隔，一次十条没问题——点"下载作品文件"收工。界面上还有"读取剪贴板""清空输入框"两个顺手的小按钮。

🎯 四个高频场景：从单条链接到整个账号

场景一：把一个博主的作品整批搬走

一条条复制链接不现实。配合 Tampermonkey 用户脚本：在小红书网页端打开博主主页，脚本能一键提取发布、收藏、点赞、专辑里的全部作品链接，搜索结果的链接也能抓；提取时页面会自动滚动把作品加载完（默认滚动 50 次，可改）。抓完复制、粘进程序、回车，这就是小红书批量下载工具的常规打法。

场景二：只要某篇笔记的第 3、5、7 张图

图文几十张全下再删太笨，命令行专门治这个——指定链接和图片序号，只下想要的：

python main.py -u "作品链接" --index "1 3 5" --image_format webp

注意--index生效时只处理第一个链接。完整参数看 CLI 参数源码，运行python main.py --help全部列出来。

场景三：按作者归档下载，文件不再吃灰

把author_archive打开，文件按作者分文件夹存；folder_mode让每篇作品单独建文件夹；name_format自定义命名，默认"发布时间 作者昵称 作品标题"。配合默认的下载记录，同一篇作品第二次会自动跳过，不占重复空间。

场景四：剪贴板即下即用

开启剪贴板后台监听，程序盯着你的剪贴板：你在别处复制了作品链接，它自己就开始下载。适合边逛边囤的收藏型选手。

图形界面、命令行、API、MCP：一张表对号入座

进阶部分按需取用，四条都列出来：

• Cookie 配好视频就变高清：不配 Cookie，视频只能拿低分辨率版；配上一个就能解锁高清，而且不用登录账号。获取路径：浏览器无痕模式打开小红书 explore 页 → F12 打开开发者工具 → 网络标签 → 任意请求里复制 Cookie 字段 → 粘进程序设置，30 秒搞定，示意图见下。
• 浏览器脚本联动：设置里script_server设为true，程序变成后台服务器，浏览器里点一下"推送下载任务"，任务直接甩给程序，复制粘贴都省了。
• API 模式：python main.py api启动本地服务，浏览器开http://127.0.0.1:5556/docs看自动生成的接口文档，POST/xhs/detail传url、download、index等参数，方便写脚本串进自己的流程。
• MCP 模式：python main.py mcp启动后，在支持 MCP 的客户端里配置 URLhttp://127.0.0.1:5556/mcp/，自然语言说一句就能取数据或下文件，二次开发门槛很低。

🛠 翻车速查：出问题时先翻这 5 条

Q：链接贴进去提示失败？A：作品链接带时效信息，放太久会被风控拦。批量下载前用脚本重新提取一遍链接，别拿收藏夹里的旧链接硬试。

Q：同一篇作品第二次下载没反应？A：正常现象，默认记录已下载作品并自动跳过。想强制重下，关掉download_record或清理对应 ID 记录。

Q：开了全局代理后下载失败？A：先关全局代理再试，多数情况直接恢复。

Q：Linux 上"读取剪贴板"没反应？A：先装xclip或xsel，装完即可。

Q：下载速度能调快吗？A：程序内置请求延时机制防风控，硬提速率容易翻车，保持默认值就好。

如果你经常需要保存小红书内容——设计找参考、文案攒素材、追更存教程、囤 livePhoto 动图——XHS-Downloader 是目前相当省心的方案：开源免费，链接解析、原画质、格式转换、按作者归档一应俱全，四个入口覆盖新手到开发者。一条底线：下载内容仅限个人学习、研究或素材积累，尊重原创版权，不用于商用或二次传播。

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