免费批量下载小红书作品：XHS-Downloader 采集与素材归档教程

2026/11/4 1:11:37

免费批量下载小红书作品：XHS-Downloader 采集与素材归档教程

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

XHS-Downloader 是一款免费开源的小红书采集工具：输入作品链接后，它负责解析图文、视频、livePhoto 的真实下载地址并保存到本地，同时抓取标题、作者、点赞数等元信息。对内容创作者、运营和数据整理者而言，批量下载小红书素材从逐张截图变成了粘贴链接后等待归档。

五分钟跑起来：源码启动最短路径

先获取代码（要求 Python 不低于 3.12）：

git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader

推荐用 uv 同步依赖并启动，一条命令串起来完成：

uv sync --no-dev && uv run main.py

程序启动后进入图形界面，把作品链接粘贴到中部输入框，点击「下载作品文件」即可看到每个文件的实时状态。如果你不想装运行环境，也可选择免安装的可执行程序版本（解压后直接运行）或 Docker 镜像（数据卷挂载到Volume目录）启动。

能帮你做什么：三种典型用法

单篇作品存档

把单个作品链接粘贴进程序，它会先识别作品类型（图文、视频或 livePhoto），再匹配对应的下载方案，文件自动命名并归档。标题、描述、作者、点赞评论数、发布时间等信息一并抓取，并可持久化保存，方便日后检索。程序对链接做了清洗：explore、discovery、user/profile页面链接以及xhslink.com短链都直接可用，多个链接用空格分隔即可一次提交。

批量收集账号内容

要采集某个账号的全部发布作品，或某个搜索结果页的作品、用户链接，配合浏览器用户脚本操作：它挂载在小红书网页版页面，发布、收藏、点赞、专辑页的链接都能一键提取，支持自动滚动加载更多内容。提取的链接批量粘回主程序，即可完成批量下载。

本地素材归档

图文、图集、视频、livePhoto 走同一套下载通道，支持断点续传与完整性校验，中断后不必从头再来。已下载作品的 ID 会写入记录，重复提交同一作品直接跳过，不占流量与时间。

效率与整理：从手动粘贴到半自动归档

半自动化采集

「监听剪贴板」模式让程序常驻后台，检测到你复制了小红书链接就自动触发下载，省去粘贴与点击的重复动作——刷内容时复制链接，工具在另一侧同步完成采集。

更高一级的联动是用户脚本与主程序对接。给浏览器安装 Tampermonkey 扩展后，通过项目提供的脚本 URL 安装（源码见 static/XHS-Downloader.js），页面上会出现功能菜单，提取到的链接可直接复制保存。

若再打开配置文件里的script_server开关并让程序保持后台运行，在浏览器里点「推送下载任务」，任务会直接发给程序处理，复制粘贴这一环节也省掉了。

文件自动整理

文件命名格式默认为「发布时间作者昵称作品标题」，可自由组合点赞数、评论数、作品 ID 等字段——做数据分析时把互动数据写进文件名，后期整理表格省事不少。图片下载格式支持 AUTO、PNG、WEBP、JPEG、HEIC，默认 JPEG 兼容性最好，追求画质可切到 HEIC，个别作品没有该格式时自动回退为 WEBP。

开启「作者归档」后，每位作者的作品存进独立文件夹；作者改昵称时，文件夹名与文件名中的昵称部分会自动同步更新，长期跟进的账号不会乱。其他常用开关：图片、视频可分别独立关闭，作品下载记录开关决定是否跳过已下载内容，「修改文件时间」开关可把本地文件的修改时间改成作品发布时间，便于按时间线管理素材。

命令行与开发者接口

习惯终端的用户可用命令行模式精细控制参数，例如用--index只下载图文作品中的某几张图片；执行python main.py --help可查看全部参数的中文说明。API 模式下启动后访问http://127.0.0.1:5556/docs即可打开交互式接口文档，方便二次开发；MCP 模式把采集能力接入 AI 对话工具，让模型直接调用采集流程。这两种模式面向有编程背景的开发者，日常使用不必涉及。