XHS-Downloader：十分钟内完成一批小红书无水印下载

XHS-Downloader：十分钟内完成一批小红书无水印下载

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

XHS-Downloader 是一款小红书无水印下载工具，把作品链接丢进去，原画质文件十分钟内落到本地。图形界面、命令行、API、MCP 四种入口都免费开放。

用惯了手动保存，你一定被这三件事磨过：截图画质糊得没法用；长按保存带水印，发出去像盗版；批量下完一堆文件，三天后分不清哪张图是哪篇笔记的。

它为什么能拿到原画质

原理一句话就能讲清：XHS-Downloader 向小红书网页接口查询作品的原始媒体地址，再顺着地址把源文件直接搬下来，页面端加的水印和压缩被整个跳过。相当于你直接找店员要了原图，而不是隔着橱窗拍一张。

两个容易被同类工具忽略的细节：

• 视频可按video_preference选分辨率优先、码率优先或体积优先；
• 图文可指定输出 PNG、WEBP、JPEG、HEIC，想修图选 PNG，想省空间选 WEBP；
• livePhoto 动图文件也能完整保存。

免安装运行和源码启动方法

用现成程序。从 Releases 下载对应系统的压缩包，解压后双击main（Windows 是main.exe），图形界面直接打开。

• 文件默认存到_internal\Volume\Download；
• 配置在_internal\Volume\settings.json。

macOS 首次运行前记得在终端执行一次xattr -cr 项目文件夹路径，清掉安全标记，否则系统会拦着不让启动。

用源码跑。环境要求 Python 3.12 以上，三条命令收工：

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

启动后把作品链接粘进输入框——多个链接用空格分隔，一次粘十条也没问题——点"下载作品文件"即可。不想粘贴就点"读取剪贴板"，直接处理你刚复制的内容。

批量下载进阶用法

一键搬空一个博主主页

一个个复制链接不现实。配一个 Tampermonkey 用户脚本：在小红书网页端打开博主主页，脚本能提取发布、收藏、点赞、专辑里的全部作品链接，搜索结果里的作品和用户链接也能抓。脚本可自动滚动加载内容，默认滚 50 次，次数可改，页面加载完一键复制，粘回程序回车，一批作品几分钟收工。

只要某篇笔记的第 3、5、7 张图

图文几十张全下再删太蠢，命令行专门治这个：

python main.py -u "作品链接" -i "3 5 7"

只下指定序号的图片。顺手加--image_format webp还能换格式。完整参数清单见 CLI 参数说明，运行python main.py --help也会列出来。

文件长期好找，按作者自动归档

配置文件里三个开关配合：

• author_archive打开后，每个作者按"作者ID_作者昵称"单独建文件夹，作者改昵称会自动更新文件名；
• folder_mode让每篇作品单独建目录；
• name_format自定义命名规则，默认就是"发布时间 作者昵称 作品标题"。

下载记录默认开启，同一篇作品第二次会直接跳过，不占重复空间。

配置 Cookie 解锁高清视频

不配 Cookie，视频只能拿到低分辨率版本。配一个就能解锁高清，全程 30 秒，不用登录账号：

1. 无痕窗口打开小红书 explore 页；
2. F12 打开开发者工具，切到"网络"选项卡，勾选"保留日志"，筛选cookie-name:web_session；
3. 点开任意请求，复制 Cookie 字段粘进配置。

图形界面、命令行、API、MCP 怎么选

复制、粘贴、手点，这套流程本身就能省掉。把配置里的script_server设为true，程序常驻后台当服务器，浏览器里点脚本菜单的"推送下载任务"，链接直接飞进程序。四种入口的分工：

入口	适合谁	一句话用法
图形界面	新手、日常少量下载	粘贴链接，点下载
命令行	有精确需求（指定序号、换格式）	一条命令搞定
API	想接入自己的脚本	POST/xhs/detail传url即可
MCP	想用自然语言驱动	配好 URL 后直接说"下载某作品"

API 与 MCP 的启动方式：

python main.py api python main.py mcp

API 模式访问http://127.0.0.1:5556/docs看自动生成的接口文档；MCP 模式在客户端里配置 URLhttp://127.0.0.1:5556/mcp/，二次开发的入口示例见 example.py。

下载失败常见原因和处理清单

现象	原因	动作
链接提示获取失败	链接携带日期信息，放太久被风控	重新提取最新链接再试
同一作品第二次没反应	下载记录默认开启，自动跳过	删掉Volume/ExploreID.db里对应 ID，或关掉download_record
开了全局代理后下载失败	代理工具和请求流程冲突	关闭全局代理再试
Linux 读取剪贴板没反应	缺少 xclip / xsel 组件	执行sudo apt-get install xclip
视频只有低清晰度	未配置 Cookie	按上文步骤 30 秒配一个
程序跑得比预期慢	内置请求延时机制，防触发风控	别硬改，保持默认

适合谁用，以及一条底线

四类人用着最顺手：做设计找参考的、写文案攒素材的、追星囤图的，以及想写脚本自动化采集的开发者。全程开源免费，没有会员墙。

一条底线说清楚：下载的内容请只用于个人学习和研究，尊重原创作者的版权，不要商用或二次传播。工具给了你方便，怎么用还得自己守分寸。

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