小红书作品下载别再靠截屏，这款开源工具让图文、视频、动图一次到位-开发者社区

小红书作品下载别再靠截屏，这款开源工具让图文、视频、动图一次到位

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

提到小红书作品下载，很多人的第一反应是"截图保存"或"右键另存"。直到你遇到这些瞬间：九宫格图片得一张张手动保存到崩溃；动态图片保存下来只剩一张静图；视频画质糊得看不清字幕——你才会意识到，普通保存方式根本拿不到作品的原貌。

问题不在你，而在方法。XHS-Downloader 是一款开源的小红书作品下载工具，能完整获取图文、视频和动态图片，还支持批量处理、剪贴板监听、命令行调用与 Docker 部署。无论你是零基础用户，还是想把它接进自己系统的开发者，都能找到顺手的使用姿势。

它到底能帮你做什么

一句话概括：粘贴链接，把小红书作品完整下载到本地。围绕这件事，它提供了几项核心能力：

全类型覆盖：图文、视频、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 的话，uv sync --no-dev同步依赖后，用uv run main.py启动即可。

路线二：直接运行程序，适合不想碰代码的普通用户。从项目的 Releases 页面下载对应平台的压缩包，解压后双击main就能用。如果你在 Mac 上首次运行被系统拦截，在终端执行一次xattr -cr 项目文件夹路径就能解除限制。

基础操作：粘贴链接，点一下下载

启动后你会看到主界面，核心区域只有一个问题：请输入小红书图文/视频作品链接。

这里有个小技巧：多个链接之间用空格分隔，一次回车就能连续下载。程序会自动从乱七八糟的分享文案里提取有效链接，你不需要手动整理。界面上还有"读取剪贴板"按钮，复制过链接后点它，省去手动粘贴的步骤。

常用的快捷键也值得记一下：Q退出、U检查更新、S程序设置、R查看下载记录、M开启监听、A关于项目。

场景进阶：三个高频用法

掌握基础操作后，下面这三个进阶用法能帮你省下大量时间。

用法一：命令行批量下载，还能挑图片

图文作品动辄十几张图，有时候你只想要其中几张，怎么办？命令行模式可以精准指定图片序号：

# 下载单个作品 python main.py --url "https://www.xiaohongshu.com/explore/作品ID?xsec_token=xxx" # 批量下载多个作品（用引号包住，空格分隔） python main.py --url "链接1" "链接2" "链接3" # 只下载图文作品的第 2、4、6 张图 python main.py --url "作品链接" --index 2 4 6

命令行模式同样支持--cookie、--proxy、--image_format等参数，方便写进脚本做定时任务。注意一点：指定了--index时只处理第一个作品链接，两者不要混用。

用法二：剪贴板监听，复制即下载

在浏览小红书时看到什么就复制什么，程序会像小助手一样自动接住链接开始下载。主界面按M键开启监听模式，之后你在任何 App 里复制小红书链接，它都会自动识别并处理，日志区会实时显示每个文件的下载进度。

这个模式特别适合"逛到哪存到哪"的收藏型用户——不用来回切换窗口，收集灵感的过程几乎无感。

用法三：配一个 Cookie，视频画质翻倍

如果发现下载的视频只有低清版本，先别怀疑工具，多半是没配 Cookie。小红书对未登录访客默认返回低分辨率视频，而配置 Cookie 后就能拿到高清资源，整个过程不需要登录账号。

获取方式也很简单：浏览器打开任意小红书页面，按F12打开开发者工具，切到"网络"面板，刷新页面后随便点一个请求，在"标头"里找到 Cookie 字段复制下来，填入程序设置即可。

开发者视角：API 与 MCP 怎么接

如果你想把下载能力接进自己的工具链，程序提供了两种服务模式。

API 模式：运行python main.py api启动本地服务，然后向/xhs/detail发送 POST 请求，传入url、download、index等参数，就能拿到作品的结构化数据或触发下载。接口文档会自动生成在http://127.0.0.1:5556/docs。

MCP 模式：运行python main.py mcp后，在支持 MCP 的 AI 客户端里添加一个 Streamable HTTP 服务，地址填http://127.0.0.1:5556/mcp/。配置完成后，你就能在对话里直接说"帮我下载这个作品的第 3 张图"，AI 会替你调用工具完成操作。