小红书下载工具 XHS-Downloader 怎么用？一条链接从浏览器到硬盘的完整搬家指南

小红书下载工具 XHS-Downloader 怎么用一条链接从浏览器到硬盘的完整搬家指南【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader还在对着小红书里上百条收藏一条条右键另存为每次整理素材都要被 HEIC 图片、低画质视频、乱糟糟的文件名折腾到崩溃XHS-Downloader 是一款开源的小红书下载工具专为小红书XiaoHongShu / RedNote内容采集场景打造集链接提取、作品信息采集、图文与视频文件下载于一体把逛—选—存—归档整条流程压缩成一次操作。读完这篇文章你将收获看清 XHS-Downloader 的全部能力以及四种打开方式分别适合谁在浏览器里批量圈货几十上百条作品链接一键装进剪贴板用主程序界面、命令行、API / MCP 三种姿势把链接变成硬盘里的文件通过一份配置文件调教下载与归档习惯并绕开 Cookie、格式、重复下载等常见坑先认识这位搬家总管一个工具四种打开方式第一次接触 XHS-Downloader 的人多半会犯嘀咕这到底是个命令行工具还是浏览器插件答案其实很简单——它是同一个项目只是根据不同使用场景提供了四种打开方式就像同一个搬家团队可以坐货车、开吊车也可以走快递、用无人机。打开方式形态适合谁典型用途主程序TUI终端里的图形界面普通用户粘贴链接、点按钮下载、改设置命令行CLI纯命令参数脚本爱好者、批处理带参数直接下载可写进自动化服务器API / MCP本地 HTTP 服务开发者、AI 工具把下载能力对接给自己的程序用户脚本浏览器扩展脚本逛小红书的人在页面上批量提取作品链接不管走哪条路底层逻辑都是同一套链接进来 → 采集信息 → 下载文件 → 归档落盘。下面我们就沿着一条链接从浏览器到硬盘的旅程把整个搬家过程走一遍。圈货装袋在浏览器里把作品链接一键装进口袋搬家的第一步是挑货——把看中的东西从架子上拿下来。如果一个个手动复制作品地址采集一百条就要点一百次手都抽筋。XHS-Downloader 的 Tampermonkey 用户脚本static/XHS-Downloader.js就是来干这个活的。安装方法很简单浏览器先装好 Tampermonkey 扩展再把项目里的static/XHS-Downloader.js作为新脚本导入即可。装好后打开小红书页面侧边会多出一个功能菜单支持一键提取提取推荐页面的作品链接提取账号发布 / 收藏 / 点赞 / 专辑的作品链接提取搜索结果的作品链接与用户链接提取结果会自动写入剪贴板你可以直接切到主程序粘贴下载。脚本还支持自动滚动页面加载更多内容默认关闭可在脚本设置中打开滚动次数也能自定义。这一站的意义在于你不再需要逐条复制逛一圈页面几十上百条链接就已经躺在剪贴板里了。小提示脚本只做可见即可得的数据提取不涉及任何破解功能批量提取时建议关闭自动滚动避免被平台判定为自动化操作。更妙的是脚本还能和主程序联动保持程序在后台运行TUI、MCP、API 模式都行在作品页面点一下脚本菜单里的推送下载任务浏览器就把链接直接甩给程序由它负责下载——这就是浏览器圈货程序收货的经典组合。打包发车把链接变成硬盘文件手动点按钮或命令行一把梭货挑好了接下来是打包上车。这一步有两种姿势主程序界面适合手动操作命令行适合批量与自动化你按习惯选。主程序 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 --help就能看到完整的参数面板。最常见的用法是直接下载一个链接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把本次命令行参数写回配置文件--settings-s读取指定配置文件--help-h查看全部参数说明值得注意的还有--note_format作品信息保存格式支持 txt / md / all和--video_preference视频选择策略分辨率 / 码率 / 体积优先。用--update_settings可以把某次命令行参数永久写进配置下次启动自动生效特别适合先试一把、满意再固化的工作流。自动化驿站API 与 MCP让程序与 AI 替你把货搬回家前面几种方式都是人操作机器这一站反过来让别的程序来调用 XHS-Downloader。这对开发者和 AI 工具用户特别有价值相当于在门口设了个驿站谁来下单都接。API 模式标准 HTTP 接口启动 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())接口还支持cookie、proxy、skip跳过已有下载记录的作品等可选参数足够你对接自己的程序。MCP 模式给 AI 助手装上下载之手MCP 模式则是为 AI 助手准备的。启动python main.py mcp后在支持 MCP 的客户端里配置一个可流式传输的 HTTP 服务地址填http://127.0.0.1:5556/mcp/AI 就能直接指挥它获取作品信息或下载文件。这样一来你的微信公众号机器人、自动化脚本、AI 工作流都能复用这一套采集能力而不必自己重新对接小红书接口。想嵌入自己的脚本进阶玩家还可以去看example.py里的XHS类调用示例——用几十行 Python 代码初始化对象、调用extract()方法就能把下载能力嵌进你自己的脚本里。这才是这个工具的终极打开方式。收尾调教与避坑一份配置文件管住归档三个高频问题一次说清无论走哪条路程序首次运行后都会在项目根目录的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默认 5 次重试和timeout默认 10 秒网络环境特殊的话设置proxy代理即可。下一步行动把搬家变成你的日常习惯现在你已经完整走通了 XHS-Downloader 的整套流程浏览器脚本圈链接、主程序界面手动下载、命令行批量自动化、API/MCP 对接程序与 AI。对多数人来说用户脚本 主程序这一组合已经够用想更省事就再配一份顺手的settings.json让下载行为完全符合你的归档习惯。想尝鲜的话源码方式运行最直接克隆仓库https://gitcode.com/gh_mirrors/xh/XHS-Downloader后用pip install -r requirements.txt或uv sync --no-dev装好依赖执行python main.py即可懒得配环境的也可以用 Docker 镜像直接跑起来。配置项还在持续丰富未来大概率还会有分辨率调整、水印等新玩法。收藏本文下次更新回来看看把每一次逛小红书都变成一次高效的内容采集。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考