企业官网建设流程全解析

XHS-Downloader 小红书作品批量下载实战指南

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

你正在刷小红书找素材，刷到一篇正合用的图文——想存原图，截图糊掉一半；逐张点保存，手指点得发酸。XHS-Downloader 就是替你干这事的开源采集工具：免费、免登录，把作品链接丢给它，它负责抓取完整信息、解析下载地址、把图片和视频原文件完整存进本地，你只管收素材。

四件麻烦事它替你包了

• 批量抓取作品链接：账号发布、收藏、点赞、专辑和搜索结果页，脚本都能一键导出链接
• 自动解析下载地址：识别作品类型，为图文、视频、livePhoto 各配最优下载方案
• 采集作品完整信息：标题、作者、点赞、评论、发布时间，可持久化存成本地文件
• 记录已下作品去重：下过的作品 ID 自动入库，再次遇到直接跳过，不重复耗流量

从零跑通第一次批量下载

把代码拉到本地

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

三种跑法挑一个

• 可执行程序：下载对应系统的压缩包，解压双击运行，零依赖，适合不想碰代码的人
• Docker 运行：拉取镜像创建容器，数据卷挂载到本地 Volume 目录统一管理，适合熟悉容器的场景
• 源码运行：装 Python ≥ 3.12，两条命令装依赖并启动，适合要做二次开发的人

pip install -r requirements.txt python main.py

第一次下载

界面启动后中间就是链接输入框，粘贴作品链接即可——explore、discovery、user/profile以及xhslink.com短链都认得，一次贴多个用空格隔开，程序会自动挑出有效部分。点「下载作品文件」，每个文件的实时状态都看得见，完成的作品会记下 ID，下次再遇到直接跳过。

配置统一写在settings.json，每个字段的含义和默认值可以直接查 source/module/settings.py，改完记得重启才生效。

剪贴板监听：复制即自动下载

开启「监听剪贴板」，把程序留在后台常驻。之后你在小红书里刷到什么、复制什么，程序检测到新链接就自动开始下载，不用回窗口、不用点按钮，复制这个动作本身就是一条下载指令。🎯

把几百条链接一次喂给它

操作：给浏览器装上 Tampermonkey，通过 URL 安装项目自带的用户脚本；打开小红书网页版，脚本会在页面挂一个功能菜单，发布、收藏、点赞、专辑、搜索结果的作品和用户链接都能一键提取，还能开自动滚动把页面内容加载全。

提取到的链接批量粘进主程序，就是一次现成的批量下载；更省事的走法是配置文件里把script_server设为true并保持程序后台运行，浏览器里点一下「推送下载任务」，脚本直接把任务推给程序处理，连复制粘贴都省了。

效果：手动刷页面、逐条复制的活全部省掉，几百条内容的采集也就是一顿饭的功夫。

命令行与服务器模式，留给想折腾的你

习惯终端的话，python main.py --help能列出全部参数说明，每条都带中文注释，完整清单见 README.md。只想拿一篇图文作品里的第 1、3、5 张图？加--index就行：

python main.py -u "作品链接" -i "1 3 5"

开发者还有两条路：python main.py api启动 API 模式，访问http://127.0.0.1:5556/docs看交互式接口文档；python main.py mcp启动 MCP 模式，把采集能力接进你的 AI 对话工具。

下载不顺时按这个顺序查

视频下出来糊成马赛克——没配 Cookie，只能拿到低分辨率流。打开浏览器「网络」面板，从请求头里抓web_session填进配置的cookie字段，不用登录账号，画质立刻上台阶。

链接能打开但下载一直报错——作品链接自带日期，太旧的链接容易被风控拦下。用脚本重新提取一份最新链接再下。

作品被跳过没下——下载记录默认开着，已下作品 ID 自动去重。想强制重下，去数据库清掉对应记录即可。

改了 settings.json 没反应——配置只在启动时读取，无效值还会静默回退默认。重启程序，顺便核一下填的值。

用户脚本下载文件失败——全局代理工具会干扰脚本的请求。先关代理再试一次。

素材到手，动手就完事

回到开头那个场景：原图和视频直接躺在本地文件夹里，没有截图糊片，也不用逐张手点保存。现在把仓库克隆下来，粘贴第一条链接，跑通你的第一次下载。🚀

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