小红书批量下载终极指南：XHS-Downloader 从链接提取到高清下载一次搞定

小红书批量下载终极指南：XHS-Downloader 从链接提取到高清下载一次搞定

【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结果作品、用户链接；采集小红书作品信息；提取小红书作品下载地址；下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader

周五深夜，阿然盯着一位博主的装修笔记合集犯了难——300 多篇图文要逐条复制链接、逐张保存图片，怕是天亮都忙不完。直到她用上 XHS-Downloader 这款开源的小红书链接提取与作品采集工具：把链接丢进去，图文、视频、动图自动批量下载，点赞、评论、发布时间等作品信息也一并抓取归档，这才真正从"搬运工"变成了"收藏家"。

XHS-Downloader 是一个免费开源的小红书作品批量下载工具，能提取账号发布、收藏、点赞、专辑的作品链接，采集作品信息与下载地址，并支持图形界面、命令行、浏览器脚本、API、MCP 多种玩法。接下来我会像老用户带路一样，把从零上手到进阶玩法的完整路线讲给你听。

没有它 vs 有了它：一张表看懂差距

一句话总结：它把"逐篇、逐图、逐条"的手工劳动，压缩成了"复制、粘贴、回车"三连。

首次体验：三种启动方式，从零到跑通

方式一：直接下载程序包，最省事

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（设置）等快捷键，界面长这样：

贴心细节值得点赞：程序支持剪贴板监听，复制链接后自动识别；下载记录默认开启，同一作品第二次遇到时直接跳过，绝不重复占硬盘；中途断网还能断点续传，文件完整性也有校验机制。

场景实战：两招搞定"批量下载"

批量收集某位作者的全部作品

想攒下某位摄影博主的全部图集？两个工具配合即可：

1. 浏览器安装 Tampermonkey 扩展，再添加项目自带的用户脚本；
2. 在作者主页点击脚本菜单，脚本会自动滚动页面、加载全部作品，一键提取发布、收藏、点赞、专辑里的所有链接；
3. 在程序配置中把script_server设为true，保持程序后台运行，浏览器里点"推送下载任务"，主程序自动接手下载。

脚本下载多个文件时会自动打包成压缩包，还支持"全选/全不选"勾选图片，体验接近手机 App。

命令行精准下载：只要第 1、3、5 张图

图文笔记里往往混着无关配图，命令行模式可以只挑想要的序号：

python main.py --url "小红书作品链接" --index "1 3 5" --download true

--index对图文/图集作品生效，多个序号用空格分隔。想批量处理多个链接也简单，所有链接用引号包住、空格隔开即可。完整参数表可以通过python main.py --help查看：

避坑地图：新手最容易踩的 4 个坑

其中最关键的是 Cookie 配置。别担心，它不需要登录账号，步骤很简单：

1. 浏览器打开https://www.xiaohongshu.com/explore；
2. 按F12打开开发者工具，切到"网络"选项卡；
3. 过滤框输入web_session，点击任意作品抓取数据包；
4. 复制完整 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