一条命令快速下载小红书作品:XHS-Downloader 免费开源工具完整上手指南
2026/8/20 15:10:53 网站建设 项目流程

一条命令快速下载小红书作品: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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询