小红书下载工具 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 的人多半会犯嘀咕：这到底是个命令行工具，还是浏览器插件？答案其实很简单——它是同一个项目，只是根据不同使用场景提供了四种打开方式，就像同一个搬家团队，可以坐货车、开吊车，也可以走快递、用无人机。

不管走哪条路，底层逻辑都是同一套：链接进来 → 采集信息 → 下载文件 → 归档落盘。下面我们就沿着一条链接从浏览器到硬盘的旅程，把整个"搬家"过程走一遍。

圈货装袋：在浏览器里把作品链接一键装进口袋

搬家的第一步是"挑货"——把看中的东西从架子上拿下来。如果一个个手动复制作品地址，采集一百条就要点一百次，手都抽筋。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_token=XXX
• https://www.xiaohongshu.com/discovery/item/作品ID?xsec_token=XXX
• https://www.xiaohongshu.com/user/profile/作者ID/作品ID?xsec_token=XXX
• https://xhslink.com/分享码（分享短链）

输入链接后，按下"下载作品文件"按钮，剩下的交给程序：自动跳过已下载过的作品、断点续传、下载 livePhoto 动图、按你设置的格式保存图片，全程无需干预。界面还提供"读取剪贴板""清空输入框"等贴心按钮，主界面按 S 键即可进入设置界面。

命令行 CLI：一条命令完成批量下载

如果你习惯终端操作，或者想把下载写进定时任务，命令行模式会更顺手。它把主程序的所有设置都变成了命令参数，敲一句python main.py --help就能看到完整的参数面板。

最常见的用法是直接下载一个链接：

python main.py --url "https://www.xiaohongshu.com/explore/作品ID?xsec_token=XXX"

批量下载多个链接，用空格分隔并整体加引号：

python main.py --url "链接1 链接2 链接3"

只下载图文作品的某几张图，用--index指定序号：

python main.py --url "https://www.xiaohongshu.com/explore/作品ID?xsec_token=XXX" --index "1 3 5"

常用参数速查：

值得注意的还有--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_token=XXX", "download": True, # 是否同时下载文件 "index": [1, 3, 5], # 只下载这几张图 }, timeout=60, ) 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 设置界面？直接编辑这个文件，改完重启程序即可生效。

值得动手的配置项

关于图片格式多说一句：程序支持 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