XHS-Downloader 完整教程：一条命令批量下载小红书作品，自动转格式并按作者归档

XHS-Downloader 完整教程一条命令批量下载小红书作品自动转格式并按作者归档【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader你收藏夹里那些刷到的干货笔记——多图攻略、教程视频、会动的图——想存进硬盘逐条右键另存太慢图片是 HEIC 打不开视频下回来只有标清。XHS-Downloader 这个小红书下载工具就是干这个的把作品链接批量解析、下载成本地文件格式转换、命名规则、按作者归档全部顺手办完。先看它管到哪一步从链接到文件的完整链路别急着装先搞清楚它在工作流里站哪个位置。它的核心就是一条数据链作品链接 → 解析作品信息 → 下载文件 → 归档整理收链接浏览器用户脚本能一键批量提取账号发布、收藏、点赞、专辑的作品链接以及搜索结果、推荐页里的作品和用户链接结果直接进剪贴板解析信息程序拿到链接后自动提取标题、作者、发布时间、互动数据以及图片和视频的真实下载地址下载归档按你设的格式下图片、视频和 livePhoto支持断点续传、跳过已下载、按作者建文件夹。它不管的部分不替你决定下什么内容链接得你自己圈出来、不自动登录你的小红书账号Cookie 是可选配置、无需登录、也不做内容再分发。定位就是链接给到它文件还给你把它放在逛完页面 → 整理进本地素材库这一段最合适。十分钟跑通第一次下载源码运行是最快的路需要 Python 3.12 及以上git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader pip install -r requirements.txt python main.py习惯uv的话后两步换成uv sync --no-dev和uv run main.py。不想碰源码的直接去 Releases 下载打包好的可执行文件解压双击就能跑。启动后是 TUI 界面一个输入框 几个按钮。把链接粘进输入框多个链接用空格隔开程序自动清洗出有效链接点下载作品文件剩下的它自己来。四种链接格式都认explore链接、discovery/item链接、user/profile链接以及xhslink.com短链直接复制粘贴即可。界面下方有几个快捷键值得记住S进设置、R看下载记录、M开启剪贴板监听。最后一个最省事——开着之后你在任何地方复制一条小红书链接程序就自动开始下载连粘贴这步都省了。到这里最小闭环已经跑通。随手用浏览器里圈链接程序后台自动收解决什么麻烦一条一条复制链接是最累的部分这个用法把圈链接变成页面上点一下的事。什么时候用日常刷小红书、顺手囤素材的时候频率最高、门槛最低。怎么做浏览器装好 Tampermonkey 扩展新建脚本把项目里static/XHS-Downloader.js的内容整段粘进去保存刷新小红书页面侧边多出脚本菜单。菜单里能提取账号发布 / 收藏 / 点赞 / 专辑的作品链接、搜索结果的作品与用户链接、推荐页作品链接提取结果自动写入剪贴板。逛一圈页面几十条链接已经躺在剪贴板里切回主程序直接下。再进一步可以让脚本和主程序联动在Volume/settings.json里把script_server设为true主程序保持后台运行浏览器里点推送下载任务链接直接送进主程序下载全程不切窗口。有个细节提醒脚本的自动滚动功能默认是关的官方明确提示开启后可能被平台判定为自动化操作、有风控风险。低频的批量提取手动往下滑几屏再提取最稳妥。批量用命令行一次灌入几十条链接解决什么麻烦TUI 适合现在就要下这几个而固定流程比如每周整理某博主更新更适合写成一条命令、丢进脚本或定时任务里跑。什么时候用你明确知道自己要下哪一批、希望参数可复现的时候。怎么做命令行模式把 TUI 的所有设置都变成了参数。最常用三条# 单条 python main.py --url https://www.xiaohongshu.com/explore/作品ID?xsec_tokenXXX # 多条空格分隔、整体加引号 python main.py --url 链接1 链接2 链接3 # 图文作品只挑几张图 python main.py --url 作品链接 --index 1 3 5不确定参数就敲python main.py --help帮助面板列得全命令行最实用的隐藏技巧是--update_settings命令行里试出一组顺手参数后加上它参数就写回配置文件之后所有模式共用这套设置。调参过程变成了可复现的命令不用在 JSON 里盲改。可编程用把下载能力交给脚本和 AI解决什么麻烦前两个用法都是你指挥它这个用法反过来——让你的公众号机器人、定时任务、甚至 AI 助手来指挥它。什么时候用你在搭自动化流程或 AI 工作流需要一个现成的小红书作品信息 文件下载零件。怎么做API 模式一条命令启动服务默认跑在127.0.0.1:5556python main.py api浏览器打开http://127.0.0.1:5556/docs就是自动生成的交互文档。核心接口POST /xhs/detail传 JSON 即可import httpx resp httpx.post( http://127.0.0.1:5556/xhs/detail, json{url: 作品链接, download: True, index: [1, 3, 5]}, timeout60, )接口还支持cookie、proxy、skip跳过有下载记录的作品参数缺省值自动沿用配置文件接入成本很低。MCP 模式则是给 AI 助手准备的python main.py mcp在支持 MCP 的客户端里配置一个 Streamable HTTP 服务地址填http://127.0.0.1:5556/mcp/之后直接在对话框说帮我把这个链接下载下来只要第 1、3、5 张图AI 通过 MCP 工具完成操作。调优与排障6 个值得动的参数和 3 个高频坑所有模式的参数都汇总在Volume/settings.json首次运行自动生成改完重启生效TUI 里按S也能改。真正值得动手的就这几个参数 / 坑默认值什么时候改它、它救什么急image_formatJPEG想要接近原图质量就设AUTO没有 HEIC 版本的作品会自动降级不会拿到打不开的文件name_format发布时间 作者昵称 作品标题归档习惯不合口味时改支持点赞数、作品ID 等字段空格分隔author_archivefalse按作者建文件夹作者ID_作者昵称追更固定博主时开配合mapping_data还能给作者起别名folder_modefalse每个作品的文件多、想单独一个文件夹时开cookie空视频想要高清必配。无需登录浏览器 F12 → 网络面板 → 过滤web_session→ 从任意请求复制完整 Cookie 填入max_retry/timeout/proxy5 / 10 / 无请求经常失败时的第一组要动的参数网络特殊就加代理高频坑基本都绕不开三件事视频只有标清→ 没配 Cookie按上表配一下即可没下载过却被跳过→ 下载记录在作祟。程序把下载过的作品 ID 存在Volume/ExploreID.db即使文件删了也会按已下载跳过想重下就清掉对应记录或临时关掉download_record让程序改查文件是否存在链接报错→ 作品链接自带日期信息旧链接容易触发风控尽量用刚提取的最新链接其次调大重试和超时比反复重启程序有用。下周就能照做的三步跑通最小闭环装好程序从自己收藏夹挑 5 条笔记走一遍脚本提取 → 粘贴下载把image_format和author_archive按自己的归档习惯调一遍固化一个流程挑一个重复性需求比如每周追更某博主用命令行加--update_settings把参数写死之后一条命令跑完按需开服务有对接需求再启动python main.py api或mcp没有就别占着端口。想深入看仓库根目录的README.md是全量中文文档配置参数、Docker 部署、Cookie 教程都在里面二次开发从example.py入手里面是XHS类的完整调用示例核心逻辑在source/application/目录下载主体在download.py解析在explore.py。先把第一条链路跑顺收藏夹里的几百条笔记才真正有机会进硬盘。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考