小红书作品下载终极指南：从安装到批量收藏，3 步就能上手
【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结果作品、用户链接；采集小红书作品信息；提取小红书作品下载地址；下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader
周六晚上，你刷到一条收藏过万的旅行攻略，想保存下来却处处碰壁：长按图片只有压缩图，下载视频要开会员，九张图还得一张张手动操作。小红书作品下载这件事，正是 XHS-Downloader 这款开源工具最擅长的——它能把图文、视频、LivePhoto 动图完整保存到本地，画质不打折，还能批量处理。
一句话总结：粘贴链接、选择方式、点击下载，整个过程不到一分钟。
为什么普通方法保存小红书内容这么难
先别急着动手，我们把问题看清楚。小红书对内容的保护比较严密，普通用户的保存手段通常会遇到四道坎：
- 动态图片：LivePhoto 动图一旦保存就变成静态图片，精彩瞬间直接丢失；
- 视频画质：不登录、不走官方渠道，能拿到的视频分辨率往往很低；
- 批量效率：一个九图作品要一张张存，收藏夹里上百条内容想想就头疼；
- 格式兼容：部分原图使用特殊格式，下载后本地播放器根本打不开。
上图是 XHS-Downloader 的主界面：输入链接、点击下载，就这么简单。
说白了，问题不在于「能不能存」，而在于「存得好不好、快不快」。XHS-Downloader 的思路很直接：从底层解析小红书的数据接口，把作品信息、下载地址、文件资源一次性取出来，再交给你自由支配。
它能做什么：一张表看懂核心能力
这款小红书作品下载工具的核心能力可以归纳为四个字：链接提取 + 作品采集。展开说，它支持：
| 能力 | 具体表现 |
|---|---|
| 提取链接 | 账号发布、收藏、点赞、专辑的作品链接，搜索结果里的作品和用户链接，都能一键提取 |
| 采集信息 | 获取作品的标题、描述、标签、点赞收藏数据、发布时间等完整信息 |
| 下载文件 | 图文、视频、LivePhoto 动图全部支持，还能指定图文作品只下载某几张图片 |
| 智能管理 | 自动跳过已下载作品、断点续传、按作者归档、自定义命名格式 |
除了这些，还有几个容易被忽略的实用细节：支持多链接同时输入、支持剪贴板监听（复制链接自动开始下载）、提供中文和英文双语界面、文件命名规则可以自由组合字段。
谁最需要它：三类人群对照
- 普通收藏党：追的博主更新太勤，收藏夹永远整理不完，需要「复制即下载」的省心方案；
- 内容创作者：做同领域素材库、竞品分析、灵感收集，批量采集是刚需；
- 开发者：需要把下载能力集成进自己的工具链，API 和 MCP 模式正好派上用场。
不管你是哪一类，接下来的操作都只需要三步。
第一步：安装，三种方式任选其一
方式一：源码运行（功能最全）
电脑上装好 Python 3.12 及以上版本后，依次执行：
git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader pip install -r requirements.txt依赖装完后，运行python main.py就能启动图形界面。想省事的话，也可以直接用uv sync --no-dev同步依赖，再uv run main.py启动。
方式二：直接运行可执行文件（适合新手）
Windows 10 及以上、macOS 用户可以直接使用项目打包好的程序压缩包，解压后双击main即可运行，无需安装 Python。唯一要注意的是，macOS 首次运行需要在终端执行一次xattr -cr 项目文件夹路径来解除系统安全限制。
方式三：Docker 部署（适合服务器）
docker pull joeanamier/xhs-downloader docker run -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader镜像里已装好全部依赖，数据目录通过卷挂载到本地，随时可以换机器继续用。
💡 小提示：如果只是日常下载作品，选方式二最省心；如果还想体验用户脚本、API 联动这些进阶功能，建议用方式一。
第二步：选择适合你的使用方式
安装完成只是开始，XHS-Downloader 提供了多种操作入口，对应不同场景：
| 使用方式 | 适合人群 | 一句话点评 |
|---|---|---|
| 图形界面 | 新手 | 粘贴即下载，零学习成本 |
| 命令行 | 批量处理 | 一条命令搞定多链接 |
| 服务器（API/MCP） | 开发者 | 可编程、可被 AI 调用 |
| 用户脚本 | 网页党 | 浏览器里直接采集链接 |
图形界面：粘贴即下载
启动后在输入框粘贴作品链接即可，多个链接用空格分隔，程序会自动提取有效链接；点一下「读取剪贴板」，连复制都省了。界面下方的快捷键也很直白：S进设置、M开启剪贴板监听、R查看下载记录、U检查更新。
命令行：批量与精准下载
命令行模式适合批量处理，参数一目了然。
如果你要处理大量链接，或者只想下载图文作品里的某几张图，命令行是最高效的方式：
# 下载单个作品 python main.py --url "小红书作品链接" # 批量下载：多个链接用空格分隔，整体用引号包裹 python main.py --url "链接1" "链接2" "链接3" # 图文作品只下载第 1、3、5 张图片 python main.py --url "作品链接" --index 1 3 5这里的--index参数是命令行独有的便利：一个九图作品，你只想要其中三张，一条命令搞定，省流量也省空间。
服务器模式：API 与 MCP
运行python main.py api会启动一个本地服务，访问http://127.0.0.1:5556/docs能看到自动生成的接口文档。想集成到自己的系统里？一段简单的 Python 请求就够了：
import requests # 前提：已通过 python main.py api 启动本地服务 server = "http://127.0.0.1:5556/xhs/detail" data = { "url": "小红书作品链接", "download": True, # 是否同时下载文件 "index": [1, 3, 5], # 只下载第 1、3、5 张图片 "proxy": "http://127.0.0.1:10808", # 可选：走代理请求 } response = requests.post(server, json=data, timeout=10) print(response.json())第三步：配置 Cookie，解锁高清画质
这一步最容易被忽略，却直接影响下载质量。默认情况下，视频作品只能拿到低分辨率版本；在设置里填入一个有效的网页 Cookie（无需登录账号），就能解锁高清画质。
在浏览器开发者工具的「网络」面板里筛选web_session请求，即可复制 Cookie。
具体操作：打开小红书网页版，按F12打开开发者工具，切到「网络」面板并勾选「保留日志」，刷新页面后在筛选栏输入web_session，从请求的 Cookie 一栏复制完整内容，粘贴进程序的cookie参数即可。配置会自动保存在Volume/settings.json文件里，之后无需重复设置。
进阶玩法：浏览器脚本与 MCP 联动
用户脚本：浏览器里直接采集
如果你装了 Tampermonkey（油猴）扩展，可以安装项目自带的用户脚本，在小红书网页上直接操作：
通过 URL 安装用户脚本，几步就完成。
脚本菜单提供发布、点赞、收藏、专辑等各类链接的提取入口。
装上之后，脚本可以自动滚动页面，把账号发布、点赞、收藏、专辑的作品链接一次性提取到剪贴板；再配合主程序的「剪贴板监听」，复制完链接，下载自动开始——这就是官方推荐的「脚本采集 + 程序下载」组合拳。
MCP 模式：让 AI 帮你下载
程序还支持 MCP（Model Context Protocol）模式，运行python main.py mcp后，AI 助手就能通过标准协议调用下载能力：
用自然语言告诉 AI「下载这个作品的第 2 张图」，它就能替你完成。
常见问题与报错处理
Q：下载的视频画质还是糊的？A：先检查是否配置了有效的 Cookie。小红书对未登录请求会限制视频分辨率，填上 Cookie 后重启程序再试。
Q：动图下载下来是静态的？A：在设置里确认live_download开关已开启。这类文件通常是 HEIC 格式，如果本地播放器不支持，把图片格式改为 PNG 或 WEBP 即可。
Q：批量下载到一半断网了？A：不用担心，程序内置断点续传，且会自动记录已下载的作品 ID。重新运行后，未完成的继续下载，已完成的自动跳过，不会重复。
Q：多张图片只想下载其中几张？A：直接切到命令行模式，用--index 1 3 5指定序号即可，图形界面下也可以借助 API 参数实现。
Q：会不会重复下载同一篇作品？A：默认开启了下载记录功能，同一作品只下载一次。想保留历史数据做管理的话，可以开启record_data，作品信息会持久化到 SQLite 数据库。
写在最后
说到底，小红书作品下载不该是一件让人头疼的事。从粘贴链接到批量收藏，XHS-Downloader 把整条链路都替你打通了：主程序负责下载，用户脚本负责采集，API 和 MCP 负责扩展，各司其职又彼此配合。想深入研究的读者，可以看看项目源码：下载引擎在 source/application/download.py，命令行入口在 source/CLI/main.py，完整的参数说明都写在 README.md 里。
现在就打开终端，跑一条命令，把第一篇想收藏的小红书作品下载到本地吧。遇到任何问题，欢迎查阅项目文档、参与社区讨论——开源工具的生命力，正来自于每一位使用者的反馈。
温馨提示：下载内容请仅用于个人收藏与学习，尊重原创作者的劳动成果。
【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结果作品、用户链接；采集小红书作品信息；提取小红书作品下载地址；下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
