XHS-Downloader 小红书内容采集工具：三步完成作品批量保存
【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader
XHS-Downloader 是一款小红书内容采集工具，支持小红书批量下载与作品保存：可识别多种格式的作品链接，重复作品自动跳过，并附带浏览器用户脚本，用于提取账号发布、点赞、收藏的作品链接。适合需要把小红书图文与视频作品归档到本地的个人用户和内容整理者。
免安装启动的三步流程
对大多数用户来说，预编译程序是最快的启动方式（支持 Windows 10 及以上与 macOS）：
- 下载程序压缩包并解压到本地文件夹；
- 双击运行
main程序，进入图形界面； - 在输入框粘贴作品链接（多个链接用空格分隔，支持
explore、discovery/item、user/profile页面链接及xhslink.com短链接），点击开始即可批量下载。
macOS 首次运行时，可执行文件未经过签名，会触发系统安全限制，在终端执行一次xattr -cr 项目文件夹路径移除安全标记后即可正常使用。除预编译程序外，也可以在本地以源码方式运行：先git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader，在 Python ≥ 3.12 环境下pip install -r requirements.txt（依赖清单见 requirements.txt），再执行python main.py启动；使用 uv 则执行uv sync --no-dev后uv run main.py；熟悉 Docker 的用户直接拉取joeanamier/xhs-downloader镜像并映射 5556 端口即可。
按场景组织小红书作品
批量下载已整理好的作品列表
适用于手头已经有一批作品链接的情况：
- 在界面输入框或命令行一次性传入多个链接，例如
python main.py --url "链接1 链接2 链接3"，程序会自动提取有效链接； - 需要指定保存目录时追加
--work_path "目标路径"； - 图文作品只下载部分图片时，用
--index "1 3 5"指定序号（该参数下仅处理首个链接）； - 界面中还可以开启"监听剪贴板"，复制链接后程序自动接收并下载，无需手动粘贴。
收集某位博主的主页作品
适用于把某个账号的全部发布作品收集到本地：
- 安装 Tampermonkey 扩展，并安装仓库内的用户脚本 static/XHS-Downloader.js；
- 打开该博主的主页，在脚本菜单选择提取发布作品链接，脚本可以自动滚动页面直至加载全部作品；
- 将提取到的链接粘贴回主程序，批量保存作品文件；
- 脚本同时支持提取收藏、点赞与专辑作品链接，多文件作品默认以压缩包形式下载。
图文与视频混合下载
- 程序会自动识别作品类型：图文作品可按 PNG、WEBP、JPEG、HEIC 等格式保存，通过
--image_format参数或配置文件设置； - 视频作品可单独配置封面下载开关，
--video_preference支持按分辨率、码率或大小选择视频版本； - 每个作品的文件会存入独立文件夹，作者昵称变化时文件名自动更新，方便按作者检索。
去重与断点续传
- 下载成功的作品 ID 会写入
./Volume/ExploreID.db数据库，再次提交相同链接时自动跳过； - 文件下载支持断点续传，大文件中断后无需从头开始；
- 若关闭下载记录功能，程序改为检查文件是否已存在，存在则跳过。
进阶配置
高清画质的 Cookie 配置
未设置 Cookie 时，视频作品只能下载到低分辨率文件，因此想要高清画质建议配置一次 Cookie（无需登录账号也可获取）：
- 浏览器访问
https://www.xiaohongshu.com/explore，登录账号（可跳过）； - 按
F12打开开发人员工具，切换到"网络"选项卡并勾选"保留日志"； - 在过滤框输入
cookie-name:web_session，选择Fetch/XHR筛选器，点击页面上任意作品； - 选中任一数据包，全选复制 Cookie，粘贴到程序或配置文件中。
代理设置
当本地网络无法直接访问时，需要在配置文件中设置proxy参数，或在命令行追加--proxy "代理地址"；--proxy_download用于控制下载文件阶段是否同样走该代理。
请求方式调整
程序以模拟真实浏览器的方式发起请求。如果请求数据时遇到异常，可以更换impersonate参数指定的浏览器模拟目标，或在./Volume/settings.json中调整超时、重试次数等参数；该配置文件首次运行自动生成，修改后需重启程序生效。
常见问题速查
| 问题 | 可能原因 | 处理方式 |
|---|---|---|
| 视频画质低 | 未配置 Cookie | 按上文步骤获取并填入web_sessionCookie |
| macOS 双击无法启动 | 可执行文件未签名被系统拦截 | 终端执行一次xattr -cr 项目文件夹路径 |
| 源码运行提示缺少模块 | Python 版本不足或依赖未安装 | 使用 Python ≥ 3.12 并执行pip install -r requirements.txt |
| 重复提交的作品被跳过 | 作品 ID 已在下载记录数据库中 | 删除./Volume/ExploreID.db中对应记录后再下载 |
| 下载文件找不到 | 使用了默认保存路径 | 程序运行方式下默认在.\Volume\Download，或查看--work_path指定目录 |
| Linux 下读取剪贴板无反应 | 缺少 xclip 或 xsel 命令 | 执行sudo apt-get install xclip后重试 |
开始前核对清单
- 选择启动方式：预编译程序、源码运行（Python ≥ 3.12）或 Docker 镜像；
- 按需配置 Cookie、代理与保存路径，核对
./Volume/settings.json； - 完成下载后到保存目录核对文件，需要时开启作者分文件夹归档。
更多功能细节与参数说明，请查阅仓库文档 README.md。
【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考