小红书无水印下载：4 个入口带走原画质作品，附避坑清单
项目地址: 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 条命令跑起来：装依赖、启动、粘链接
环境要求只有一条：Python 3.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：一张表对号入座
| 入口 | 适合谁 | 一句话用法 |
|---|---|---|
| 图形界面 | 新手、日常少量 | 粘链接，点下载 |
| 命令行 | 要指定序号、格式 | --index "1 3 5" 一条命令 |
| API | 接入自己的脚本 | POST /xhs/detail 传作品链接 |
| 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 是目前相当省心的方案：开源免费，链接解析、原画质、格式转换、按作者归档一应俱全，四个入口覆盖新手到开发者。一条底线：下载内容仅限个人学习、研究或素材积累，尊重原创版权，不用于商用或二次传播。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
