小红书内容如何批量下载？XHS-Downloader 上手指南-开发者社区

小红书内容如何批量下载？XHS-Downloader 上手指南

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

刷到一篇不错的小红书笔记想留档，或者想把某位作者的内容整批采集下来，一条条手动保存确实费劲。XHS-Downloader 是一款小红书内容采集工具，批量下载小红书作品文件是它的主业：粘贴多个链接即可自动提取作品信息，把图文、视频文件保存到本地。下面按功能、安装、日常用法和进阶配置四部分说明。

一、XHS-Downloader 能做什么：小红书作品采集与保存

把作品链接交给它，它会提取作品信息和下载地址，再下载文件到本地。除了图片与视频，视频封面、livePhoto 动图也能一并保存；作品数据可持久化存入文件，还开放了 API 和 MCP 两种调用方式，方便二次开发。

常用能力大致有这几点：

兼容四种链接格式：https://www.xiaohongshu.com/explore/作品ID、https://www.xiaohongshu.com/discovery/item/作品ID、https://www.xiaohongshu.com/user/profile/作者ID/作品ID，以及https://xhslink.com/分享码短链
单次可粘贴多个链接，空格分隔，程序自动提取有效链接
记录已下载作品 ID，重复任务自动跳过；下载中断支持断点续传
图文作品可选 PNG、WEBP、JPEG、HEIC 格式，视频可配置分辨率、码率等下载偏好
每个作品可存独立文件夹，也可按作者归档，文件命名格式可自定义
支持后台监听剪贴板，复制新链接后自动开始下载

二、三种方式跑起 XHS-Downloader

直接运行：双击即可

只下载文件的话，这条路径最省事。从项目发布页下载 Mac OS 或 Windows 的程序压缩包，解压后双击main就能用。作品默认存到.\Volume\Download，配置文件在.\Volume\settings.json。Mac 用户首次运行要先在终端执行xattr -cr 项目文件夹路径移除安全标记，执行一次即可。

源码运行：需要 Python 3.12

想改配置、做二次开发时建议源码运行。克隆仓库后安装依赖即可启动：

git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader pip install -r requirements.txt python main.py

Docker 运行：一条命令拉起来

有 Docker 环境时直接拉镜像运行，端口和挂载卷按需要调整：

docker pull joeanamier/xhs-downloader docker run --name xhs -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader

注意 Docker 模式不支持命令行调用，读取剪贴板与监听剪贴板也不可用，粘贴链接下载不受影响。

三、日常使用：批量链接、剪贴板与自动去重

批量下载的核心动作就是贴链接。多个链接用空格分开粘进输入框，程序会自己挑出有效链接开始处理。如果你刚在浏览器里复制过链接，点一下"读取剪贴板"就能省掉二次粘贴；开启剪贴板监听后，复制链接的动作本身就会触发下载。

重复下载不用人工判断。程序会把下载成功的作品 ID 存进数据库，再次遇到同一作品直接跳过。确实要重下某个作品时，先从下载记录里删掉对应 ID 再执行。

文件整理规则在设置里调。命名格式默认是"发布时间作者昵称作品标题"，还可以加入点赞数量、作品标签等字段；开启文件夹模式后每个作品单独一个文件夹，按作者归档则按作者ID_作者昵称建目录，作者改名时文件名会自动更新。

一个容易忽略的点：作品链接里带日期信息，用之前采集的旧链接可能触发风控，建议尽量使用最新获取的链接。

四、进阶玩法：用户脚本、命令行参数与 Cookie 配置

用户脚本：想在浏览器里直接干活时用得上。装好 Tampermonkey 或 Violentmonkey，按 URL 安装 static/XHS-Downloader.js 即可。脚本能在页面里提取发布、收藏、点赞、专辑、推荐和搜索结果的作品链接，提取到的一批链接贴回程序就是现成的批量任务。主程序保持运行并把script_server设为true后，脚本还能把下载任务直接推送给程序处理。

命令行参数：适合脚本化、定时任务这类自动化场景。最简用法是python main.py --url "链接"，加--work_path指定保存路径，加--proxy走代理，加--index "1 3 5"只下指定序号的图片——不过设置了--index时只会处理第一个链接。完整参数列表用--help查看。

Cookie 与请求头：Cookie 不是必须项，但不配置时视频只能拿到低分辨率。获取步骤：浏览器访问小红书 explore 页，按 F12 打开开发者工具，切到"网络"选项卡并勾选"保留日志"，过滤框输入cookie-name:web_session，选 Fetch/XHR 筛选器，点击任意作品后从请求头里全选复制 Cookie，贴进程序的设置即可。请求头方面，程序用impersonate参数模拟真实浏览器指纹，默认值是chrome146，一般不用动。