一条命令快速下载小红书作品:XHS-Downloader 免费开源工具完整上手指南
【免费下载链接】XHS-Downloader小红书(XiaoHongShu、RedNote)链接提取/作品采集工具:提取账号发布、收藏、点赞、专辑作品链接;提取搜索结果作品、用户链接;采集小红书作品信息;提取小红书作品下载地址;下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader
你是不是常为"想保存的小红书内容散落在几十条链接里"发愁?XHS-Downloader 是一款免费开源的小红书采集工具,把链接提取、作品信息抓取、文件批量下载串成一条流水线。如果你要备份收藏、整理博主图文,或给项目攒素材,这篇正适合你,读完 5 分钟就能跑通第一条下载。
先用三个关键词看懂它能做什么
提取、采集、下载,六个字概括全部核心能力,其余功能都围绕这三点展开:
- 提取:账号发布/收藏/点赞/专辑、搜索结果、推荐页,作品链接一条条帮你捞出来;
- 采集:作品标题、描述、类型、作者信息、互动数据一次拿全,可持久化存档;
- 下载:图文、视频、动图文件批量落地,还能指定格式、断点续传。
至于用什么入口,看你的习惯选就行:
| 使用姿势 | 上手成本 | 适合场景 |
|---|---|---|
| TUI 终端界面 | 零基础 | 日常下载、调整偏好设置 |
| 命令行参数 | 会复制粘贴 | 临时任务、脚本化批量 |
| 浏览器用户脚本 | 装个扩展 | 网页里批量提取链接 |
| API / MCP | 会写代码 | 接入自己的工具链 |
零基础启动:粘贴链接即可下载小红书作品
启动python main.py进入终端界面,把作品链接粘贴进去回车,剩下的交给程序。链接格式不挑:详情页、分享短链、带参数的地址都行,多个链接用空格分隔,程序会自动提取有效部分。
下载前建议先在"程序设置"里把图片格式、作者归档、语言等偏好调好,之后每次下载都按这套规则走,省得反复设置。
上图是设置界面,方向键选择、回车确认即可,全程不用记命令。
进阶提速:用命令行与用户脚本批量提取链接
不想进界面?一条命令就能完成下载,参数用完即弃、不落盘:
python main.py --url "作品链接1 作品链接2" --image-format JPEG # 多个链接空格分隔,图片统一转JPEG全部参数用python main.py --help查看,说明界面如下:
想再快一步,浏览器装个 Tampermonkey 再挂上项目自带的用户脚本:访问博主主页点一下菜单,发布/收藏/点赞/专辑的作品链接自动进剪贴板,丢给程序就能批量下载,等于"网页里圈素材、本地统一存"。
开发者接入:通过 API 与 MCP 调用小红书下载能力
二次开发只需要实例化XHS类,参数都在构造器里:
from asyncio import run from source import XHS async def main(): # download=True:解析链接的同时把文件下载到本地 async with XHS(image_format="JPEG") as xhs: # 图文统一保存为 JPEG 格式 await xhs.extract("https://www.xiaohongshu.com/explore/作品ID", download=True) run(main())完整参数与调用示例见 example.py,核心实现在 source/application/。想以服务方式接入,python main.py api会起一个本地接口;python main.py mcp则让 AI 助手直接帮你查作品、发下载任务:
解密下载又快又稳的三个保险机制
为什么几百个文件下完几乎不用返工?可以把它想象成往仓库搬书:程序先记一本台账(下载记录),搬过的书直接跳过,绝不重复劳动;搬一半被叫停,下次从断点接着搬,不用推倒重来(断点续传);搬完还逐页清点,缺页自动补(文件完整性处理)。断网、重启、重复任务,都浪费不了你的时间。相关实现可看 source/application/download.py。
速答 5 个高频疑问:下载前先弄清这几件事
Q1:下载的图片打不开?多半是 HEIC、WEBP 这类兼容性差的格式。把"图片下载格式"改成JPEG就好,这也是默认值;只有苹果生态内自用才建议选 HEIC。
Q2:视频只有低分辨率?没配 Cookie 时视频只能拿低清版。按 README 的步骤取一次 Cookie(无需登录账号),高清源就能正常拿到:
Q3:同一个作品能重复下载吗?默认开启下载记录,重复任务自动跳过,避免白跑。想强制重下,关掉"下载记录"开关或清理记录库即可。
Q4:一次能喂多少个链接?多个链接空格分隔直接丢进去,程序自动提取有效链接;xhslink 分享短链同样支持。
Q5:只想下图文里的某几张图?命令行加--index "1 3 5"指定图片序号,只下载你挑中的那几张。
现在就动手:跑通你的第一条下载命令
git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader pip install -r requirements.txt # 或 uv sync --no-dev python main.py粘贴一条作品链接回车,几秒后去Volume/Download目录查看成果。💡 想深入折腾,项目文档(README.md)、配置项说明(source/module/settings.py)都已整理齐全,照着抄就行。
【免费下载链接】XHS-Downloader小红书(XiaoHongShu、RedNote)链接提取/作品采集工具:提取账号发布、收藏、点赞、专辑作品链接;提取搜索结果作品、用户链接;采集小红书作品信息;提取小红书作品下载地址;下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考