小红书下载工具XHS-Downloader怎么用四条采集链路让批量下载一站到位【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader还在对着小红书里上百条收藏一条条右键另存还在为整理素材时发现图片是HEIC格式而头疼XHS-Downloader 是一款开源的小红书下载工具专为小红书XiaoHongShu / RedNote内容采集场景打造它既能从账号主页、搜索页、推荐页批量提取作品链接也能直接采集作品信息、下载图文与视频文件还支持 API 与 MCP 调用把采集-下载-归档整条流水线压缩成一次操作。读完这篇文章你将收获看清 XHS-Downloader 的完整能力地图以及它提供的四条采集链路分别适合谁用浏览器用户脚本批量圈货把作品链接一键导进剪贴板用 TUI 界面、命令行、API/MCP 三种方式把链接变成硬盘里的文件通过配置文件调教下载行为并绕开 Cookie、格式、重复下载等常见坑先看懂它一个工具四张面孔很多人第一次接触 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 动图、按你设置的格式保存图片全程无需干预。在设置界面主界面按 S 键进入里你可以把下载行为调教成自己的习惯后面会有专门的配置小节。第三站命令行自动化——一条命令直达下载如果你习惯终端操作或者想把下载写进定时任务命令行模式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 https://www.xiaohongshu.com/explore/作品ID?xsec_tokenXXX --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_作者昵称--language-l界面语言zh_CN / en_US--update_settings-us把本次命令行参数写回配置文件--help-h查看全部参数说明想了解完整参数随时敲一句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 即可获取作品信息或触发下载import httpx resp httpx.post( http://127.0.0.1:5556/xhs/detail, json{ url: https://www.xiaohongshu.com/explore/作品ID?xsec_tokenXXX, download: True, # 是否同时下载文件 index: [1, 3, 5], # 只下载这几张图 }, timeout60, ) print(resp.json())MCP 模式则是为 AI 助手准备的——启动python main.py mcp后在支持 MCP 的客户端里配置一个 Streamable HTTP 服务地址填http://127.0.0.1:5556/mcp/AI 就能直接指挥它获取作品信息或下载文件。配置界面长这样这样一来你的微信公众号机器人、自动化脚本、AI 工作流都能复用这一套采集能力而不必自己重新对接小红书接口。收尾调教一份配置文件管住所有下载行为无论走哪条链路程序首次运行后都会在项目根目录的Volume文件夹里生成settings.json配置文件。看不懂 TUI 设置界面直接编辑这个文件改完重启程序即可生效。几个最值得动手的配置项配置项默认值说明image_formatJPEG图片下载格式想要原格式就设AUTOname_format发布时间 作者昵称 作品标题文件命名规则支持点赞数、作品ID等字段folder_modefalse开启后每个作品单独一个文件夹author_archivefalse开启后按作者建文件夹昵称变更自动更新download_recordtrue记录已下载的作品ID避免重复下载write_mtimefalse把文件修改时间改成作品发布时间cookie空小红书网页版 Cookie非必需但建议配置video_preferenceresolution视频选择策略分辨率 / 码率 / 体积优先关于图片格式多说一句程序支持 AUTO、PNG、WEBP、JPEG、HEIC 五种格式部分作品没有 HEIC 版本时程序会自动降级为 WEBP不会让你拿到一堆打不开的文件。避坑指南三个高频问题一次说清1. 视频画质太低怎么办未配置 Cookie 时视频作品只能下载低分辨率版本。去浏览器访问小红书任意页面按 F12 打开开发者工具在网络面板里过滤web_session从任意请求中复制完整的 Cookie 填入程序即可无需登录账号。2. 重复下载同一作品程序默认开启下载记录功能数据存在Volume/ExploreID.db已下载过的作品会自动跳过。如果文件被误删想重下先清理数据库里对应的作品 ID 再下载。3. 请求经常失败或超时内置了请求延时机制你还可以在配置里调大max_retry失败重试次数和timeout超时时间网络环境特殊的话设置proxy代理即可。下一步把采集变成你的日常习惯现在你已经完整走通了 XHS-Downloader 的四条采集链路浏览器脚本圈链接、TUI 界面手动下载、命令行批量自动化、API/MCP 对接程序与 AI。对多数人来说用户脚本 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），仅供参考