XHS-Downloader：免费开源的小红书原图下载工具，四步把链接变成硬盘里的原图

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

收藏夹里躺了几十条舍不得删的小红书笔记，链接放久了会失效，重新保存的图又被平台压缩过，根本没法用。XHS-Downloader 就是一个免费开源的小红书原图下载工具：粘贴作品链接，它直接把原图、原视频落到你本地，无需登录。

一分钟看懂它

• 落盘的是原始分辨率文件，不是网页压缩图，image_format可指定 PNG、WEBP、JPEG、HEIC 或 AUTO。
• 支持断点续传，已下载的作品自动跳过，重启程序也不会重复下载，下载记录由 source/module/recorder.py 持久化管理。
• 多个链接一起粘贴、空格分隔即可，它会自动提取有效链接，explore作品页和xhslink.com短链都认。
• 支持 API 与 MCP 两种被调用的方式，仓库根目录的 example.py 是一份完整的调用示例。
• 不配任何凭证也能跑，配上 Cookie 后视频能取到高分辨率版本。

四步跑起来

第 1 步 拉取代码

# 把源码克隆到本地并进入目录 git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader

依赖 Python 3.12 及以上，先用python --version确认一下版本。

第 2 步 安装依赖

# 用 pip 按清单装依赖；装了 uv 的话可改用 uv sync --no-dev，速度更快 pip install -r requirements.txt

第 3 步 启动程序

# 不带参数时默认打开窗口图形界面 python main.py

第 4 步 第一次下载

# 命令行模式，把第一个作品链接交给它，完成一次小红书视频下载 python main.py --url "作品链接"

下载完成后，文件默认落在./Volume/Download文件夹，配置文件是./Volume/settings.json，两者都在项目根目录下自动生成，迁移时直接整个文件夹带走即可。

三种真实场景

图形界面：粘贴链接就能下

不想碰命令行时，直接开着窗口用。把链接粘进"创建任务"输入框，多个链接用空格分隔，它自动提取有效链接后提交。窗口里还能开启剪贴板监听：开启后在任意网页复制一个作品链接，程序自己就把任务接过来。

命令行：只挑想存的那几张

长图文动辄几十张，你只想存其中两三张时，命令行最快。用--index指定图片序号即可：

# 只下载作品里第 3、6 张图；加 --help 可查看全部参数说明 python main.py --url "作品链接" --index 3 6

程序调用与批量：API、MCP 交给脚本干活

想让别的程序或 AI 调用下载能力，或者一次处理几百条链接时，看这个场景。一行命令就能把服务跑起来：

# API 模式，交互式文档地址 http://127.0.0.1:5556/docs python main.py api # MCP 模式，把 http://127.0.0.1:5556/mcp 配进支持 MCP 的对话工具 python main.py mcp

API 模式下 POST/xhs/detail就能采集作品信息并触发下载；MCP 模式下配好地址，说一句"帮我下载这个链接"就行。批量做小红书批量下载时，思路是"浏览器提链接、程序管下载"：在 Tampermonkey 里导入项目自带的 static/XHS-Downloader.js 用户脚本，小红书页面会多出提取发布、点赞、收藏作品链接的菜单，一点就把成批链接复制到剪贴板。再把配置里的script_server设为true，浏览器里点"推送下载任务"，程序在后台直接接手下载。

设置与参数

所有配置项由 source/module/settings.py 统一管理，首次运行自动生成settings.json。常用参数：

关键的是cookie。Cookie 就是网页请求里携带的身份标识串，没配它时视频只能下到较低分辨率。获取只需三步：浏览器打开小红书网页，按F12打开开发者工具，切到"网络"标签刷新页面，在任意请求的标头里整段复制 Cookie 字段，粘进配置文件后重启程序生效。

避坑速查

• 下载卡住或报错→ 先关掉全局代理再试，然后看程序日志里的具体报错。
• 视频清晰度上不去→ 多半是没配 Cookie，按上文配好、重启程序再下载。
• 链接提示失效→ 作品链接自带日期信息，旧链接容易被风控拦截，尽量用最新抓取的链接，内置请求延时保持默认即可。

收藏夹里那些怕失效的笔记，现在已经是硬盘里的原图文件，链接过不过期都不再重要。花十分钟把它跑起来，后面就只剩下存。🌟

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