小红书批量下载终极指南：XHS-Downloader 从链接提取到高清下载一次搞定
【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结果作品、用户链接；采集小红书作品信息；提取小红书作品下载地址；下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader
周五深夜，阿然盯着一位博主的装修笔记合集犯了难——300 多篇图文要逐条复制链接、逐张保存图片，怕是天亮都忙不完。直到她用上 XHS-Downloader 这款开源的小红书链接提取与作品采集工具：把链接丢进去，图文、视频、动图自动批量下载，点赞、评论、发布时间等作品信息也一并抓取归档，这才真正从"搬运工"变成了"收藏家"。
XHS-Downloader 是一个免费开源的小红书作品批量下载工具，能提取账号发布、收藏、点赞、专辑的作品链接，采集作品信息与下载地址，并支持图形界面、命令行、浏览器脚本、API、MCP 多种玩法。接下来我会像老用户带路一样，把从零上手到进阶玩法的完整路线讲给你听。
没有它 vs 有了它：一张表看懂差距
| 使用场景 | 手动操作 | 使用 XHS-Downloader |
|---|---|---|
| 保存单篇图文 | 复制链接 → 逐张右键存图 | 粘贴链接 → 一键下载全部图片 |
| 整理作者全部作品 | 翻页截图、手动命名 | 提取链接批量下载，按作者自动归档 |
| 下载高清视频 | 到处找解析，画质难保证 | 配置 Cookie 后按分辨率/码率优先下载 |
| 重复下载防坑 | 全凭记忆，容易漏存 | 自动记录已下载 ID，智能跳过 |
| 数据留档 | 图片存了，信息丢了 | 作品信息持久化保存，可导出文本/Markdown |
一句话总结：它把"逐篇、逐图、逐条"的手工劳动，压缩成了"复制、粘贴、回车"三连。
首次体验：三种启动方式，从零到跑通
方式一：直接下载程序包，最省事
Windows 或 Mac 用户可直接获取程序压缩包，解压后双击运行main即可。首次启动会自动生成配置文件./Volume/settings.json，所有参数都能在这里调整；作品默认存放在./Volume/Download/目录，开箱即用，零配置也能跑。
方式二：源码运行，推荐开发者
如果你喜欢自己掌控一切，用 uv 装依赖只要两条命令：
git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev uv run main.py方式三：Docker 一键部署
不想污染本地环境？一条命令把服务跑起来，数据通过卷持久化：
docker run -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader启动后你会看到深色风格的图形界面，顶部输入框就是主战场——把小红书链接粘贴进去，点击"下载作品文件"即可；底部有 Q（退出）、U（检查更新）、S（设置）等快捷键，界面长这样：
贴心细节值得点赞：程序支持剪贴板监听，复制链接后自动识别；下载记录默认开启，同一作品第二次遇到时直接跳过，绝不重复占硬盘；中途断网还能断点续传，文件完整性也有校验机制。
场景实战：两招搞定"批量下载"
批量收集某位作者的全部作品
想攒下某位摄影博主的全部图集？两个工具配合即可：
- 浏览器安装 Tampermonkey 扩展，再添加项目自带的用户脚本；
- 在作者主页点击脚本菜单，脚本会自动滚动页面、加载全部作品，一键提取发布、收藏、点赞、专辑里的所有链接；
- 在程序配置中把
script_server设为true，保持程序后台运行，浏览器里点"推送下载任务"，主程序自动接手下载。
脚本下载多个文件时会自动打包成压缩包，还支持"全选/全不选"勾选图片，体验接近手机 App。
命令行精准下载：只要第 1、3、5 张图
图文笔记里往往混着无关配图，命令行模式可以只挑想要的序号：
python main.py --url "小红书作品链接" --index "1 3 5" --download true--index对图文/图集作品生效，多个序号用空格分隔。想批量处理多个链接也简单，所有链接用引号包住、空格隔开即可。完整参数表可以通过python main.py --help查看：
避坑地图：新手最容易踩的 4 个坑
| 错误现象 | 原因 | 解决办法 |
|---|---|---|
| 视频画质很低 | 未配置 Cookie，只能拿低分辨率 | 配置网页版 Cookie 后可获取高清版本 |
| 下载频繁失败或提示风控 | 使用了很久以前获取的链接 | 用最新获取的作品链接重新采集 |
| 重新下载同一作品没反应 | 下载记录里已有该作品 ID | 删除./Volume/ExploreID.db中的对应记录 |
| 脚本自动滚动被平台检测 | 自动滚动可能被识别为自动化操作 | 该功能默认关闭，需要时再谨慎开启 |
其中最关键的是 Cookie 配置。别担心，它不需要登录账号，步骤很简单：
- 浏览器打开
https://www.xiaohongshu.com/explore； - 按
F12打开开发者工具，切到"网络"选项卡； - 过滤框输入
web_session，点击任意作品抓取数据包； - 复制完整 Cookie，粘贴到
./Volume/settings.json的cookie字段。
深度挖掘：把下载能力交给 API 和 MCP
XHS-Downloader 不只是个"下载器"，它还能变身服务器，让你的程序或 AI 助手直接调用下载能力。
启动 API 模式：python main.py api，浏览器访问http://127.0.0.1:5556/docs即可看到交互式接口文档。下面是一个可复制的调用示例，向/xhs/detail接口提交链接，程序就会返回作品信息并按需下载：
import requests response = requests.post( "http://127.0.0.1:5556/xhs/detail", json={"url": "小红书作品链接", "download": True, "index": [1, 3, 5]}, timeout=10, ) print(response.json()) # 作品信息 + 下载结果想接 AI 助手？启动 MCP 模式python main.py mcp，在支持 MCP 的客户端里填入地址http://127.0.0.1:5556/mcp/，就能用自然语言让助手"帮我下载这篇作品的图片"，适合把采集流程沉淀成团队工作流。
FAQ 速查
问：下载的文件默认存在哪里？答：./Volume/Download/目录，可在配置文件修改存储路径和文件夹名。
问：想让文件按作者分开存放怎么设？答：把author_archive设为true，程序会按"作者ID_作者昵称"建文件夹，昵称变了还会自动更新。
问：文件名能自定义吗？答：可以。name_format支持组合发布时间、作者昵称、作品标题、点赞数、作品 ID 等字段，例如"发布时间 作者昵称 作品标题"。
问：支持哪些链接格式？答：支持 explore、discovery/item、用户主页、xhslink 短链等多种格式，一次可粘贴多个链接。
问：不想下载动图怎么办？答：把live_download设为false即可关闭 LivePhoto 动图下载。
问：下载的图片想统一成指定格式？答：设置image_format为 PNG、WEBP、JPEG、HEIC 中的任意一种，也支持自动识别原始格式。
现在就开始你的内容收藏之旅
XHS-Downloader 把"复制、粘贴、回车"变成了管理小红书内容的标准动作：个人素材库、竞品内容跟踪、团队内容沉淀，都能在一套流程里搞定。它完全免费开源，长期活跃维护，遇到问题可以找作者反馈。
快速起步就三步：克隆仓库git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader，安装依赖uv sync --no-dev，然后uv run main.py；想省事的话，也可以直接下载现成程序包，双击main就能开跑。
最后提醒一句：请合理控制请求频率，尊重原创作者版权，仅下载个人使用或已获授权的内容。工具再好，合规使用才能长久。
今天就动手试试吧——把第一篇心仪的小红书作品链接丢进去，你会回来感谢自己的。
【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结果作品、用户链接；采集小红书作品信息；提取小红书作品下载地址；下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
