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-devuv 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 秒，不用登录账号：
- 无痕窗口打开小红书 explore 页；
- F12 打开开发者工具，切到"网络"，勾上"保留日志"，筛
cookie-name:web_session； - 点开任意请求，把 Cookie 字段整个复制，贴进
settings.json的cookie项。
图形界面、命令行、API、MCP 四种方式怎么选
| 方式 | 典型场景 | 第一步 |
|---|---|---|
| 图形界面 | 个人少量、偶尔下 | 粘链接，点"下载作品文件" |
| 命令行 | 按序号挑图、换格式、跑脚本 | python main.py -u "链接" -i "3 5 7" |
| API | 接进自己的采集流程 | python main.py api，再 POST/xhs/detail |
| MCP | 让 AI 助手替你点下载 | python main.py mcp，把http://127.0.0.1:5556/mcp/填进客户端 |
API 模式起好之后，浏览器访问http://127.0.0.1:5556/docs，自动生成的接口文档直接能调试；想自己接的，二次开发示例在 example.py。
出问题先自查 ⚠️
- 链接提示获取失败 → 链接里带日期信息，放久了会失效 → 重新提取一条新链接再试
- 同一作品第二次没反应 → 下载记录默认开着，自动跳过了 → 删
Volume/ExploreID.db里对应 ID，或关掉download_record - 开了全局代理后下载失败 → 代理和请求流程冲突 → 关掉全局代理重试
- Linux 上"读取剪贴板"没反应 → 缺 xclip 组件 →
sudo apt-get install xclip - 视频只有低清晰度 → 没配 Cookie → 按上面 30 秒的步骤补一个
- 跑得比预期慢 → 内置 6 秒请求延时，防风控用的 → 保持默认，别硬改
做设计找参考的、写文案攒素材的、想写脚本做自动化采集的，用着最顺手。工具是免费的，但下载的内容请只留作个人学习和研究，尊重原创作者的版权，别商用、别二次传播。
【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
