XHS-Downloader小红书批量下载工具怎么用四条链路把收藏变成本地文件【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader对着小红书里上百条收藏一条条右键另存整理到一半还发现图片是 HEIC 格式打不开——这种体验想必不少人都经历过。今天要介绍的XHS-Downloader就是一款专治这类痛点的开源小红书下载工具它能从账号主页、搜索页、推荐页批量提取作品链接也能直接采集作品信息、下载图文与视频还支持 API 与 MCP 调用把采集—下载—归档压成一次操作。读完你将收获看清全貌一个工具如何用四种形态服务四类人群批量圈链接用浏览器用户脚本把几十条作品链接一键导进剪贴板三种落地姿势TUI 界面、命令行、API/MCP 各自怎么把链接变成文件少走弯路配置调教与高频避坑问答一次到位先建立整体认知一个工具四种打开方式很多人第一次接触 XHS-Downloader 都会困惑这到底是个命令行还是浏览器插件答案是同一个项目按你的使用习惯提供了四种形态底层共用同一套逻辑链接进来 → 采集信息 → 下载文件 → 归档落盘。形态长什么样适合谁典型场景主程序TUI终端图形界面普通用户粘贴链接、点按钮下载命令行CLI纯命令参数脚本爱好者批量下载、写进定时任务服务器API / MCP本地 HTTP 服务开发者、AI 工具把下载能力对接给程序用户脚本浏览器扩展脚本逛小红书的人页面上批量提取链接接下来就沿着一条链接从浏览器到硬盘的旅程把四条链路挨个走一遍。第一站浏览器里圈货用用户脚本批量提取链接下载的前提是拿到链接。手动复制一百条作品地址要一百次点击手都会抽筋。XHS-Downloader 自带的 Tampermonkey 用户脚本static/XHS-Downloader.js就是来解决这个痛点的。装好脚本打开小红书页面侧边会多出一个功能菜单支持一键提取推荐页作品链接、账号发布/收藏/点赞/专辑的作品链接、搜索结果的作品链接与用户链接。提取结果自动写入剪贴板还能开启自动滚动页面加载更多内容默认关闭滚动次数可自定义。提示脚本只做可见即可得的数据提取不涉及破解功能批量提取时建议关闭自动滚动避免被平台判定为自动化操作。这一站的意义在于你不再需要逐条复制逛一圈页面几十上百条链接已经躺在剪贴板里了。第二站主程序收货TUI 界面把链接变成文件拿到链接后在项目根目录运行python main.py进入 TUI 界面。主界面正中是一个输入框支持一次粘贴多条链接用空格分隔即可程序会自动提取有效链接无需手动清洗。支持的链接格式包括https://www.xiaohongshu.com/explore/作品ID?xsec_tokenXXXhttps://www.xiaohongshu.com/discovery/item/作品ID?xsec_tokenXXXhttps://www.xiaohongshu.com/user/profile/作者ID/作品ID?xsec_tokenXXXhttps://xhslink.com/分享码分享短链点下载作品文件后交给程序自动跳过已下载过的作品、断点续传、下载 livePhoto 动图、按你设置的格式保存图片全程无需干预。第三站命令行自动化一条命令直达下载想写进定时任务或脚本命令行模式CLI更顺手它把主程序的所有设置都变成了命令参数。最常见用法是直接下载python main.py --url https://www.xiaohongshu.com/explore/作品ID?xsec_tokenXXX批量下载多个链接空格分隔并整体加引号python main.py --url 链接1 链接2 链接3只下载图文作品的某几张图用--index指定序号python main.py --url 作品链接 --index 1 3 5常用参数速查参数简写作用--url-u作品链接多个用空格分隔--index-i只下载指定序号的图片--image_format-if图片格式AUTO / PNG / WEBP / JPEG / HEIC--cookie-ck小红书网页版 Cookie无需登录--proxy-p网络代理--folder_mode-fm每个作品存进单独文件夹--author_archive-aa按作者归档文件夹名为作者ID_作者昵称--update_settings-us把本次命令行参数写回配置文件完整参数随时敲python main.py --help查看。第四站开放给程序API 与 MCP 让机器替你干活前三站是人在操作第四站反过来让别的程序来调用 XHS-Downloader对开发者和 AI 工具用户特别有价值。启动 API 模式只需一条命令python main.py api服务默认跑在http://127.0.0.1:5556浏览器打开/docs即可看到自动生成的交互式文档。核心接口是POST /xhs/detail传 JSON 即可获取作品信息或触发下载。MCP 模式则是为 AI 助手准备的启动python main.py mcp后在支持 MCP 的客户端里配置一个 Streamable HTTP 服务地址填http://127.0.0.1:5556/mcp/AI 就能直接指挥它获取作品信息或下载文件。这样一来公众号机器人、自动化脚本、AI 工作流都能复用这套采集能力不必自己重新对接小红书接口。收尾调教一份配置文件管住所有下载行为无论走哪条链路程序首次运行后都会在项目根目录的Volume文件夹里生成settings.json。直接编辑这个文件改完重启即生效。最值得动手的几个配置项配置项默认值说明image_formatJPEG图片格式想要原格式就设AUTOname_format发布时间 作者昵称 作品标题文件命名规则支持点赞数、作品ID等字段folder_modefalse开启后每个作品单独一个文件夹author_archivefalse开启后按作者建文件夹昵称变更自动更新download_recordtrue记录已下载作品ID避免重复下载video_preferenceresolution视频选择策略分辨率 / 码率 / 体积优先提示部分作品没有 HEIC 版本时程序会自动降级为 WEBP不会让你拿到一堆打不开的文件。避坑指南四个高频问题一次说清1. 视频画质太低怎么办未配置 Cookie 时视频只能下载低分辨率版本。去浏览器访问小红书任意页面按 F12 打开开发者工具在网络面板里过滤web_session从任意请求中复制完整 Cookie 填入程序即可无需登录账号。2. 重复下载同一作品程序默认开启下载记录功能数据存在Volume/ExploreID.db已下载过的作品会自动跳过。文件误删想重下先清理数据库里对应的作品 ID 再下载。3. 请求经常失败或超时内置请求延时机制你还可以在配置里调大max_retry默认5次和timeout默认10秒网络环境特殊就设置proxy代理。4. 链接是几天前提取的会不会失效作品链接携带日期信息使用旧链接可能触发风控建议下载时使用最新获取的作品链接。现在就去试试对你我这样的普通用户用户脚本 TUI 主程序的组合已经足够顺手想更省事再配一份顺手的settings.json即可。想尝鲜的话源码运行最直接克隆https://gitcode.com/gh_mirrors/xh/XHS-Downloader后用pip install -r requirements.txt或uv sync --no-dev装好依赖执行python main.py就能开跑懒得配环境也可以用 Docker 镜像直接跑。进阶玩家还可以看看example.py里的XHS类调用示例把下载能力嵌进你自己的脚本——这才是这个工具的终极打开方式。收藏这篇文章等配置项更新了再回来看看新玩法。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考