10分钟上手 XHS-Downloader：小红书作品批量无水印下载指南
【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader
想把小红书上一组笔记图无水印存下来，你多半试过右键另存为、手机截图，结果不是带水印就是画质糊——这正是XHS-Downloader这款免费的小红书作品批量下载器要解决的。它把作品链接变成干净的图片、视频和作品数据，全程在你自己的电脑上完成，不上传任何文件。
先搞清楚：XHS-Downloader 能替你做什么
在往下走之前，先用一张卡判断它是不是你要找的东西：
| 项目 | 说明 |
|---|---|
| 适合谁 | 想批量保存小红书作品的创作者、做资料整理的人、需要接接口的开发者 |
| 解决什么问题 | 把作品链接一键转成无水印图片、视频，并附带作品数据 |
| 与替代方案差异 | 全在本地处理、数据不外传、可二次开发，而插件/云服务往往受权限或收费限制 |
| 是否免费 | 完全免费开源（GPL v3.0），作者不提供付费版 |
| 上手难度 | 低——有图形界面、命令行、Docker 三种入口，装好即用 |
它同时覆盖图文、视频、封面和动态图（livePhoto），还内置了"下载记录"，你重复丢同一批链接进去，它会自动跳过已经存过的，不会反复占空间。
快速上手：10分钟内跑通第一次下载
你只需要 Python 3.12 以上。最省事的方式是用 uv 管理依赖：
git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev uv run main.py最后一步会直接弹出图形界面，左侧是任务队列、剪贴板模式、下载记录等入口，你往输入框贴链接就能跑。如果你更习惯传统 pip，也可以建个虚拟环境后执行pip install -r requirements.txt，再用python main.py启动。
不想装 Python？项目也提供了 Docker 镜像和 Mac/Windows 的可执行压缩包，解压双击main就能用，文件默认存到.\Volume\Download。
命令行党可以直接用参数式调用，一次丢进多条链接、空格分隔：
python main.py -u "作品链接1 作品链接2 作品链接3" -fm true -aa true这条命令的意思是：批量下载这些作品，每个作品单独建文件夹（-fm），再按作者归档到各自目录（-aa）。完整的参数表可以运行python main.py -h查看。
核心能力拆解：从单条到批量
批量下载：一次粘贴多条作品链接
使用场景：你收藏了一整列笔记，想一次收进本地，不想一个个点。怎么操作：在 GUI 输入框或命令行-u参数里粘贴多条链接（空格分隔），程序会自动识别出有效链接，支持explore、discovery/item、user/profile以及xhslink.com分享码这几种形式。注意点：设了--index（只下指定序号图片）时，就只处理第一条链接了；想批量就别带这个参数。
无水印高清：Cookie 决定画质
使用场景：你发现视频存下来总是糊的，图片也想拿原图。怎么操作：在配置里填入小红书网页版 Cookie（无需登录），程序就能拿到更高分辨率的视频源，并用--image_format指定图片保存为 PNG、WEBP、JPEG、HEIC 或 AUTO。注意点：Cookie 不是强制项，但未配置时视频只能下到低分辨率；图片格式里 HEIC 部分作品没有，会退回成 WEBP。
用户脚本：让浏览器帮你收集链接
使用场景：链接一条条复制太累，尤其面对一整页作品时。怎么操作：浏览器装好 Tampermonkey 后引入项目自带的用户脚本，它能在作品页弹出"选择要下载的图片"面板，也能提取推荐、发布、收藏、点赞、专辑和搜索结果里的链接；开启服务器模式后，点"推送下载任务"就能把活交给后台的主程序干。
注意点：脚本里那个"自动滚动页面"默认是关的，手动开启有被判定为自动化操作、触发风控的风险，非必要别动。
开发者向：API 与 MCP 接入
使用场景：你想把下载能力嵌进自己的脚本或 AI 助手里，而不是手动点。怎么操作：先用python main.py token生成一个鉴权令牌（长期有效，别外传），再启动对应服务：
python main.py api # REST 接口，访问 /docs 有交互式文档 python main.py mcp # MCP 服务，可接入支持 MCP 的 AI 工具然后 POST/xhs/detail，请求体里带上作品链接和download: true，请求头加Authorization: Bearer 你的令牌：
data = {"url": "作品链接", "download": True} headers = {"Authorization": "Bearer 你的鉴权令牌"} response = post("http://127.0.0.1:5556/xhs/detail", json=data, headers=headers, timeout=10)注意点：API 和 MCP 模式都要带令牌，缺失或无效会返回 403；Docker 下跑 API/MCP 时命令行调用和剪贴板功能是没的，属正常现象。
如果你是做二次开发，仓库根目录的 example.py 给了一段带注释的最小调用，改改参数就能跑，核心源码都在 source/。
方案对比：为什么选本地下载器
同样想"把小红书内容存下来"，路不止一条，差别在你平时最关心的几件事上：
| 你关心的 | XHS-Downloader | 浏览器插件 | 付费云服务 |
|---|---|---|---|
| 钱 | 免费 | 部分功能收费 | 按量/订阅收费 |
| 上手 | 中低，GUI/命令行/Docker 都有 | 低，装脚本即用 | 低，网页点几下 |
| 数据归谁 | 全在你本机 | 以本地为主 | 先传到第三方服务器 |
| 无水印 | 原生支持 | 看具体插件 | 常带水印 |
| 可定制性 | 高，能改代码/接接口 | 低 | 基本没有 |
| 隐私 | 不上传文件 | 依赖浏览器权限 | 数据离开电脑 |
手工"另存为"那档就更别提了——水印、画质、效率全输。所以当你既要批量又要干净文件、还不想把东西交给别人时，本地方案是少数几个选项里最稳的。
避坑指南：这些情况你大概率会撞上
⚠️ 下面几条是真实高频问题，对照着看能少绕很多弯路。
- 你可能遇到视频存下来很糊，这时应该去补一份完整的 Cookie（里面要含
web_session字段），只缺 Cookie 是画质上不去最常见的原因。
- 你可能遇到请求被限流、速度忽快忽慢，这时应该保持默认的请求延时（程序内置约 6 秒间隔），别为了快把间隔压没，那样更容易触发风控。
- 你可能遇到"明明没存过却被跳过下载"，这时应该知道下载记录是默认开启的，想重下就得先删掉数据库里对应的作品 ID。
- 你可能遇到旧链接突然下不动，这时应该换最新获取的链接——作品链接里带日期信息，太老的链接容易被风控。
- 你可能看到脚本里有"自动滚动页面"想打开，这时应该先停手：它有被判自动化、连累账号的风险，默认关闭是有原因的。
最后
XHS-Downloader 把"提取链接、去水印、批量下载、接接口"这几件事收进了一个免费开源的本地工具里，GUI 看着顺手、命令行跑得快、API 留给想折腾的人。装好、贴上链接、存下干净的文件，就是你今天能走通的最短路径。
- 项目说明与完整参数表：README.md
- 二次开发最小示例：example.py
- 核心源码：source/
- 依赖清单：requirements.txt
- 获取代码：
git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader
【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
