XHS-Downloader 使用教程：3 分钟跑通小红书无水印下载

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

XHS-Downloader 是一款免费的 Python 开源工具，专门做小红书无水印下载：粘贴作品链接，它就把图文或视频原样存到本地，还提供批量保存账号作品和 API 接口。

三分钟跑通：从安装到第一次保存

先确认本机装了 Python 3.12 及以上版本，然后按下面顺序敲四条命令，即可获取项目、装好依赖并启动程序。

git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev # 没有 uv 就用：pip install -r requirements.txt python main.py

程序启动后会出现图形界面窗口。在输入框里粘贴任意一条小红书作品链接，点「下载作品文件」，稍等片刻，无水印的图文或视频就存到本地了；嫌手动粘贴麻烦，可以直接点「读取剪贴板」。

三个典型场景，各走各的路

单个作品：识别这些链接格式就能下

把下面任一格式的链接贴进输入框，程序都能识别：

• https://www.xiaohongshu.com/explore/作品ID
• https://www.xiaohongshu.com/discovery/item/作品ID
• https://www.xiaohongshu.com/user/profile/作者ID/作品ID
• https://xhslink.com/短链码

输入框一次可以放多个链接，用空格分隔即可批量下载。手机上复制出的短链不用转换，直接粘就行。

账号级批量：一次性抓走发布、收藏、点赞作品

要下载某个账号名下的内容，最快的路是配合项目自带的浏览器用户脚本。在账号主页点脚本菜单里的「提取发布作品链接」「提取点赞作品链接」「提取收藏作品链接」，页面会自动滚动加载并复制全部链接；账号专辑、搜索结果里的作品链接和用户链接也能这样批量抓。

提取结果都在剪贴板里，回到程序输入框点「读取剪贴板」，再触发一次下载，就完成了小红书批量下载工具这一环。

自动化联动：用户脚本直接推送下载任务

装好用户脚本后，可以省掉复制粘贴这一步：让 XHS-Downloader 在后台保持运行，访问任意作品页时点脚本菜单里的「推送下载任务」，链接会直接发给本地程序处理。

在脚本设置中填入程序生成的鉴权令牌后即可用，浏览到想存的笔记顺手推一下，适合边刷边攒素材。

进阶玩法：命令行、API 与 MCP

命令行常用参数

习惯终端的话，直接带参数调用，四条命令覆盖最常用的用法：

python main.py --url "https://xhslink.com/xxx" python main.py --url "链接1 链接2 链接3" python main.py --url "作品链接" --index "1 3 5" # 只下载图集第 1、3、5 张 python main.py --url "作品链接" --work_path "D:\XHS" --cookie "Cookie 值"

加--help可以看全部参数，比如--folder_mode（每个作品独立文件夹）、--video_preference（视频偏好）。

API 与 MCP 模式

API 模式适合二次开发和系统对接，MCP 模式则让 AI 助手直接调用下载能力，两者都要携带启动时终端输出的鉴权令牌。

python main.py api python main.py mcp

文件存成什么样，由你定

默认情况下，文件保存在项目根目录的Volume/Download里；首次运行会生成Volume/settings.json，改这一份配置就能固定你的保存习惯。

高清视频下载建议配上 Cookie：不配也能下，但视频画质受限。获取步骤：

1. 浏览器无痕模式打开https://www.xiaohongshu.com/explore；
2. F12 打开开发者工具 →「网络」，勾选「保留日志」；
3. 点进任意作品，在请求头里找到带web_session的那条，整段复制；
4. 粘贴到程序的 Cookie 配置项即可，视频就能下到更高清晰度。

卡住了先看这里

三类高频问题按这个顺序排查：

1. 链接无效：确认贴的是作品链接而不是纯用户主页；短链或长链接都试试，必要时换一个 Cookie。
2. 下载卡顿：先检查网络与代理配置；请求走不通时调大timeout和max_retry。
3. 保存失败：看磁盘空间和work_path所在目录的写入权限，路径里避免特殊字符。

性能参数方面，三个建议：timeout按网络情况放宽、大文件用大一点的chunk、断点续传保持默认开启，中断后再跑同一批链接即可接着下。

下载的内容请留作个人学习研究，尊重原创作者的权益，并遵守小红书平台的服务条款。控制批量频率，把工具用在该用的地方。

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