如何免费下载高清小红书作品：XHS-Downloader 单链接 3 分钟到 300 条批量的完整实操

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

XHS-Downloader 是一款开源的小红书链接提取与作品采集工具，输入单条或批量作品链接，即可把原图图集和高清视频文件下载到本地，并自动跳过已下载的作品。它适合找素材的内容创作者、盯竞品账号的运营人员，以及想把收藏夹搬到本地的普通用户。

手动批量保存小红书作品：为什么 300 条笔记做不完

算一笔账就明白了。一篇多图笔记平均 5~9 张图，打开、逐张看大图、长按保存、返回列表，一篇平均要 1 分钟。300 篇笔记至少要 5 个小时，而且只算图文——视频作品靠截图根本保存不下来。保存下来的图片还是压缩后的版本，放大就糊，做素材没法用。

问题可以拆成两件事：把"要哪些作品"提取成链接，再把链接变成本地文件。这两步都靠人做，耗时的就是人；拆开交给程序，时间就能省下来。

两条命令下载小红书作品：从克隆到首次跑通

项目需要 Python 3.12 及以上版本。如果本地装了 uv（Python 包管理器），安装过程只有两条命令：

# 克隆源码并安装运行依赖（不装开发依赖） git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev # 启动程序，默认进入图形界面 uv run main.py

不想碰命令行的话，去项目 Releases 页下载程序压缩包，解压后双击main直接运行，Windows 和 macOS 都有对应包。

环境就绪后下第一个作品。复制一条作品链接（形如https://www.xiaohongshu.com/explore/作品ID?xsec_token=XXX）：

# 下载单个小红书作品，链接整体放在引号里 python main.py --url "https://www.xiaohongshu.com/explore/作品ID?xsec_token=XXX"

程序会识别链接、拉取作品信息并保存文件，终端打印标题、类型和保存位置。图文默认存成 JPEG，视频优先取分辨率最高的源文件。

批量下载、挑图、高清视频：3 个最高频的小红书下载场景

一条命令批量下载多条小红书作品

一批链接（来自收藏夹、推荐页或搜索结果）可以一次性放进命令，链接之间用空格分隔，程序自动过滤出有效部分，不用事先清洗：

# 链接列表用空格分隔，顺带指定保存根目录 python main.py --url "链接A 链接B 链接C" --work_path "./my_downloads"

我实测 300 条左右链接，程序单条处理多为几秒，加上失败重试，整批约 20 分钟跑完。请求失败会自动重试，中断后重跑会接着来，已下载的作品直接跳过，不重复花时间。

小红书图集怎么只下载想要的几张图

图集动辄十几张，你可能只要其中两三张。用--index指定取哪几张：

# --index 只对单个作品链接生效，序号之间用空格分隔 python main.py --url "图集作品链接" --index "1 3 5"

有个限制要注意：设置了--index时只处理首个链接，不能和批量混用；不设它时，一条命令里放多个链接才是正常姿势。

小红书高清视频文件怎么拿：Cookie

下载的视频总是低分辨率，原因基本是 Cookie 没配置。不配也能下，但视频被限制在低清晰度；填上 Cookie 就能拿到高清源文件，而且不需要登录账号。

拿法：浏览器打开小红书首页，按F12打开开发者工具，切到"网络"选项卡，勾选"保留日志"，过滤框输入cookie-name:web_session，选 Fetch/XHR 筛选器，点开任意作品，选中一个数据包，全选复制 Cookie，填进Volume/settings.json的cookie字段，重启程序生效。

批量下载小红书要改的 5 个参数

Volume/settings.json首次运行自动生成，命令行参数和 GUI 选项都和这个文件一一对应，改完重启生效。日常只需盯 5 个：

• cookie：小红书网页版 Cookie，非登录项。视频画质不达标时，先补这个。
• name_format：文件命名格式，默认"发布时间 作者昵称 作品标题"。字段可自由组合发布时间、作者昵称、作品标题、作品 ID、点赞数量等，建素材库时很有用。
• folder_mode：开启后每个作品的文件放进单独文件夹，文件夹名与文件名一致，整理大批作品更清爽。
• image_format：图文下载格式，支持 JPEG、WEBP、PNG、HEIC、AUTO，默认 JPEG；想省空间可换 WEBP。
• author_archive：开启后作品按"作者ID_作者昵称"分文件夹归档，作者改昵称时文件名自动更新。按账号整理素材库的人建议开。

选形态：GUI、浏览器脚本、API、MCP 分别适合谁

🔧 同一个项目有 4 种形态，按使用习惯挑：

图形界面：不带参数启动main.py默认就是它，粘贴链接直接下载，还有"读取剪贴板"——复制链接后在程序里点一下即可读入；剪贴板监听模式下，复制到的新链接会自动排队下载。偶尔下几个作品的人不用学命令。

浏览器用户脚本：装好 Tampermonkey 扩展后，把仓库里现成的 static/XHS-Downloader.js 导入即可。脚本装好并刷新小红书页面后，脚本菜单里就有"提取发布作品链接""提取收藏作品链接""提取点赞作品链接""提取专辑作品链接"等选项。实测用"提取收藏作品链接"批量导出 300 条链接约 3 分钟。

脚本到程序的联动：把配置文件里script_server设为true（TUI、API、MCP 模式生效），保持程序在后台运行，之后在浏览器脚本菜单点"推送下载任务"，链接直接发给程序下载，省去复制粘贴。文件命名、格式以程序配置为准。

API 模式：运行python main.py api起本地服务，浏览器打开http://127.0.0.1:5556/docs就是自动生成的交互式接口文档。核心接口是 POST /xhs/detail，传作品链接拿作品信息，可附带下载开关；调用时需在请求头携带鉴权令牌（启动终端会输出）。写自动化脚本的人适合这条线。

MCP 模式：运行python main.py mcp（源码运行需先额外安装 fastmcp 库），在支持 MCP 的 AI 客户端里填http://127.0.0.1:5556/mcp并带上令牌，之后用对话就能查作品信息、下作品文件。

想深入定制，核心请求与下载逻辑在 source/application/ 目录；example.py 里有一份带完整参数注释的 XHS 类调用示例，从它改起最省事。

下载失败怎么办：小红书下载常见问题速查

⚠️ 四条高频问题，直接给解法：

视频一直是低分辨率？Cookie 没配。把cookie参数填进配置文件重启即可，无需登录账号。

过几天旧链接失效了？作品链接携带日期信息，隔太久再用的旧链接可能触发风控。下载前重新提取一遍链接。

下载过的作品会不会再下一次？默认不会。下载成功的作品 ID 记录在Volume/ExploreID.db，同样链接自动跳过。要强制重下，从该数据库删掉对应记录。

批量下载会被平台盯上吗？程序内置请求延时机制，默认请求间隔均值 6 秒，正常批量没问题。但用户脚本的"自动滚动页面"默认关闭——开启后页面快速滚动加载，可能被平台判定为自动化操作，账号有风控风险。稳妥做法是手动滚动几次再提取。

适合谁用，以及 1 分钟内能做完的第一步

找素材的创作者、盯竞品的运营、要样本数据的分析师，以及想把收藏夹搬回本地的普通用户都合适：它把"提取链接"和"下载文件"拆成两个可自由组合的环节，只取其一也能用，两者都开源免费。第一步 1 分钟内可完成：从收藏夹挑一篇作品，复制链接，跑一次python main.py --url "链接"，看看一条命令换回的原始文件长什么样。

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