XHS-Downloader 下载工具零基础完整指南从一条作品链接到整账号批量归档【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader深夜刷到一套收藏级穿搭笔记长按保存下来的却是糊成一团的压缩图视频链接刚复制进收藏夹过两天再点开已经失效。这种刷到却留不住的憋屈大概每个小红书重度用户都体会过。XHS-Downloader 正是为这种时刻而生的开源作品下载工具它能把小红书作品链接变成你硬盘里的高清文件——免费、免登录、装完就能跑。30 秒速览装之前先对齐预期项目一句话回答它是什么基于 AIOHTTP 开发的小红书链接提取与作品采集下载工具解决什么问题保存原图、下载高清视频、批量提取账号与搜索结果内容收费吗完全免费、开源无任何隐藏功能收费需要登录吗不需要Cookie 为可选配置配了能解锁视频高画质最快开始方式确认 Python 3.12 → 拉取源码 → 装依赖 → 运行主界面适用平台覆盖 Windows、macOS、Linux也支持 Docker 容器化运行TUI、CLI、API、MCP、浏览器用户脚本五种形态总有一种匹配你的使用习惯。它接住了哪些真实场景四个让收藏党头疼的瞬间装之前先别急着敲命令。判断一个工具值不值得用得看它接住了哪些真实场景。下面这四个瞬间你大概率经历过至少一个。把整个账号的作品链接一次性拎出来关注了一位旅行博主想把他发布过的几百条 vlog 全部收进本地——逐条复制链接手会废。XHS-Downloader 输入作者主页就能批量提取发布、收藏、点赞、专辑四类作品链接输入搜索关键词同样能成批提取搜索结果里的作品与用户链接。配合浏览器用户脚本的自动滚动页面加载多少它就能提取多少。账号级的内容从此不需要账号级的体力。高清视频离线看画质瓶颈出在配置而不是网络地铁上想缓存一条视频保存下来的却是低分辨率版本。原因往往不在网络而在缺少 Cookie程序在未配置 Cookie 时只能拿到低分辨率资源。配置 Cookie全程无需登录账号后即可解锁高画质还能按分辨率优先、码率优先、文件大小优先三种偏好挑选版本下载时保留或去除水印都随你。一次配置长期受益。原图直出的正确姿势不靠截图靠解析图集笔记保存下来总是被压缩的版本LivePhoto 动图更是直接存不下来。程序会解析作品原始资源把每一张图片按原图质量逐张下载动图单独保留图片格式支持 PNG、WEBP、JPEG、HEIC 或保持原样 AUTO。右键另存为做不到的事它替你做到。下载体验里的隐形工程断点续传、去重与自动归档大文件下到一半断了网重复下载白白浪费流量下载好的文件堆在一起分不清谁是谁。这些细节程序都替你料理好了断点续传、自动跳过已下载作品、按作者自动建文件夹、每个作品独立归档、文件修改时间同步为作品发布时间。下载记录由source/module/recorder.py持久化管理重启程序也不会丢。下载这件小事被它打理得几乎不用你操心。最短路径先让一条作品成功落盘理论说够了现在跑起来。整条路径只有四步十分钟内能出第一个成果。确认环境与拉取源码先确认本机 Python 版本不低于 3.12然后在终端执行git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader安装依赖二选一即可# 方式一pip 安装 pip install -r requirements.txt # 方式二uv 安装更快推荐 uv sync --no-dev启动主界面粘贴链接点一下python main.py界面中央是输入框把作品链接粘贴进去即可。多个链接之间用空格分隔程序会自动提取有效链接一次能提交多个支持explore作品页、xhslink.com短链等常见格式。点击下载作品文件后程序自动完成请求数据 → 解析资源 → 下载文件全流程。底部快捷键值得记一下M开启剪贴板监听、S打开设置、R查看下载记录、Q退出。注意看输入框下方的灰色提示和三个按钮——界面把所有复杂参数都藏了起来新手只需要会粘贴和点击。下载完成的文件去哪了位置清晰可查运行方式作品文件默认位置配置文件位置源码运行./Volume/Download./Volume/settings.json程序包运行.\_internal\Volume\Download.\_internal\Volume\settings.json场景对号入座四类使用者各自怎么用同样是这款工具不同人用法完全不同。看看你属于哪一类。日常收藏党界面操作加剪贴板监听适合偶尔保存单条内容的人。启动python main.py后按M开启剪贴板监听之后在任何地方复制作品链接程序都会自动识别并下载复制即下双手彻底解放。亮点一句话界面直观零学习成本。批量搬运工命令行一次带走一堆适合整理素材、批量备份的人。命令行参数灵活几十个参数任你组合# 下载单个作品 python main.py --url 小红书作品链接 # 一次提交多个链接空格分隔用引号包裹 python main.py --url 链接1 链接2 链接3 # 只下载图文的第 3、6、9 张图片 python main.py --url 作品链接 --index 3 6 9 # 自定义保存路径并指定界面语言 python main.py --url 作品链接 --work_path D:\素材库 --language zh_CN上面这张截图列出了完整的命令行参数表--index参数对几十张图的长图文尤其实用——想存哪几张就存哪几张不必全量下载。浏览器重度用户页面内提取程序负责下载装好 Tampermonkey 扩展后把项目里的static/XHS-Downloader.js导入为用户脚本小红书页面就会出现功能菜单支持提取发布、点赞、收藏作品链接与搜索结果。更妙的是联动玩法在配置文件中把script_server设为true让主程序在后台运行浏览器里点一下推送下载任务下载就交给程序完成——浏览器只负责提取程序负责下载。截图里的菜单在页面更多按钮中展开提取出的链接自动复制到剪贴板方便你随时粘贴给程序。开发者与 AI 工作流API 与 MCP 模式如果你想让代码或 AI 助手替你操作下载服务器模式正合适。运行python main.py api后访问http://127.0.0.1:5556/docs即可看到自动生成的交互式接口文档通过 POST 请求/xhs/detail采集作品信息并触发下载。运行python main.py mcp在支持 MCP 的对话工具里配置http://127.0.0.1:5556/mcp/地址就能直接说帮我下载这个链接。像上图这样AI 助手直接返回作品标题、类型等信息整个下载流程由它代劳。有更个性化的需求时项目根目录的example.py提供了完整的代码调用示例。四种场景怎么选一张表收尾场景适合人群启动方式一句话亮点日常收藏新手、随手保存python main.py剪贴板监听复制即下批量搬运运营、素材整理python main.py --url ...参数灵活可按序号挑图浏览器联动网页重度用户Tampermonkey 加载脚本页面内提取一键推送自动化接入开发者、AI 工作流python main.py api/mcp可编程调用交给机器干把默认配置调成你的偏好首次运行会自动生成./Volume/settings.json改完记得重启程序生效。常用的几个参数速查如下参数作用默认值推荐设置work_path作品保存根路径项目根路径/Volume改为你的素材目录folder_name作品文件存放文件夹名Download按需修改image_format图片下载格式JPEG追求原图选 AUTO 或 PNGimage_download图片下载总开关true不需要时关掉video_download视频下载总开关true不需要时关掉live_download动图文件下载开关false需要保存 LivePhoto 时开启video_preference视频偏好resolution想省空间可改 sizefolder_mode每个作品单独一个文件夹false作品多时建议开启author_archive每个作者单独一个文件夹false整理素材强烈推荐download_record记录已下载作品 ID 并跳过true保持开启proxy网络代理无网络受限时填写Cookie 专题解锁高画质的关键一步程序本身不登录也能用但未配置 Cookie 时视频只能下载低分辨率版本。好在获取 Cookie 不需要登录账号浏览器打开小红书网页版按F12打开开发者工具切到网络选项卡勾选保留日志刷新页面在Fetch/XHR过滤器中找到任意接口请求打开标头标签复制请求头中的完整Cookie字段粘贴到程序设置或配置文件里。上图红框标注了每一步的位置照着做一分钟就能拿到。注意 Cookie 有时效性功能异常时重新获取一份再试即可。两个容易被忽略的高价值配置name_format决定文件名长什么样默认是发布时间 作者昵称 作品标题支持插入点赞数、作品ID、作品类型等十几种字段按你的归档习惯组合即可。write_mtime把文件修改时间改成作品发布时间开启后按时间线翻文件就像翻作品时间轴素材库整齐得能治愈强迫症。避坑清单五个高频翻车现场Q1下载失败或一直卡住多半是网络问题。检查是否开着全局代理工具它会干扰请求尝试关闭后重试同时看一眼程序日志中的具体报错。Q2视频清晰度上不去十有八九是没配 Cookie。按上文步骤配置后重启程序再下载一次即可拿到高画质资源。Q3提示链接失效或被风控作品链接自带日期信息隔太久的链接容易被拦截。务必使用最新获取的链接并避免短时间内高频请求程序内置的请求延时机制保持默认即可。Q4传了多个链接只下载了第一个因为你设置了--index参数——该参数只对首个链接生效。想批量下载去掉--index再传多链接。Q5如何更新到最新版本源码运行执行git pull origin main后更新依赖程序包用户下载新版后把旧版的 Volume 配置文件夹复制过去设置无缝迁移。写在最后从单张原图到高清视频从单个作品到整账号批量提取从界面点击到命令行、浏览器脚本乃至 AI 对话——XHS-Downloader 把保存小红书内容这件事做到了一个工具能做的上限全程免费开源、持续维护还自带中英文双语言界面。最后也提醒一句下载的内容请仅用于个人学习与灵感收藏等非商业用途尊重每一位原创作者的劳动。工具是善意的用它的我们也该守住分寸。现在打开终端跑起你的第一次下载吧——把那些让你心动的瞬间真正留在自己的硬盘里 【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 XHS-Downloader 下载工具零基础完整指南：从一条作品链接到整账号批量归档
XHS-Downloader 下载工具零基础完整指南从一条作品链接到整账号批量归档【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader深夜刷到一套收藏级穿搭笔记长按保存下来的却是糊成一团的压缩图视频链接刚复制进收藏夹过两天再点开已经失效。这种刷到却留不住的憋屈大概每个小红书重度用户都体会过。XHS-Downloader 正是为这种时刻而生的开源作品下载工具它能把小红书作品链接变成你硬盘里的高清文件——免费、免登录、装完就能跑。30 秒速览装之前先对齐预期项目一句话回答它是什么基于 AIOHTTP 开发的小红书链接提取与作品采集下载工具解决什么问题保存原图、下载高清视频、批量提取账号与搜索结果内容收费吗完全免费、开源无任何隐藏功能收费需要登录吗不需要Cookie 为可选配置配了能解锁视频高画质最快开始方式确认 Python 3.12 → 拉取源码 → 装依赖 → 运行主界面适用平台覆盖 Windows、macOS、Linux也支持 Docker 容器化运行TUI、CLI、API、MCP、浏览器用户脚本五种形态总有一种匹配你的使用习惯。它接住了哪些真实场景四个让收藏党头疼的瞬间装之前先别急着敲命令。判断一个工具值不值得用得看它接住了哪些真实场景。下面这四个瞬间你大概率经历过至少一个。把整个账号的作品链接一次性拎出来关注了一位旅行博主想把他发布过的几百条 vlog 全部收进本地——逐条复制链接手会废。XHS-Downloader 输入作者主页就能批量提取发布、收藏、点赞、专辑四类作品链接输入搜索关键词同样能成批提取搜索结果里的作品与用户链接。配合浏览器用户脚本的自动滚动页面加载多少它就能提取多少。账号级的内容从此不需要账号级的体力。高清视频离线看画质瓶颈出在配置而不是网络地铁上想缓存一条视频保存下来的却是低分辨率版本。原因往往不在网络而在缺少 Cookie程序在未配置 Cookie 时只能拿到低分辨率资源。配置 Cookie全程无需登录账号后即可解锁高画质还能按分辨率优先、码率优先、文件大小优先三种偏好挑选版本下载时保留或去除水印都随你。一次配置长期受益。原图直出的正确姿势不靠截图靠解析图集笔记保存下来总是被压缩的版本LivePhoto 动图更是直接存不下来。程序会解析作品原始资源把每一张图片按原图质量逐张下载动图单独保留图片格式支持 PNG、WEBP、JPEG、HEIC 或保持原样 AUTO。右键另存为做不到的事它替你做到。下载体验里的隐形工程断点续传、去重与自动归档大文件下到一半断了网重复下载白白浪费流量下载好的文件堆在一起分不清谁是谁。这些细节程序都替你料理好了断点续传、自动跳过已下载作品、按作者自动建文件夹、每个作品独立归档、文件修改时间同步为作品发布时间。下载记录由source/module/recorder.py持久化管理重启程序也不会丢。下载这件小事被它打理得几乎不用你操心。最短路径先让一条作品成功落盘理论说够了现在跑起来。整条路径只有四步十分钟内能出第一个成果。确认环境与拉取源码先确认本机 Python 版本不低于 3.12然后在终端执行git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader安装依赖二选一即可# 方式一pip 安装 pip install -r requirements.txt # 方式二uv 安装更快推荐 uv sync --no-dev启动主界面粘贴链接点一下python main.py界面中央是输入框把作品链接粘贴进去即可。多个链接之间用空格分隔程序会自动提取有效链接一次能提交多个支持explore作品页、xhslink.com短链等常见格式。点击下载作品文件后程序自动完成请求数据 → 解析资源 → 下载文件全流程。底部快捷键值得记一下M开启剪贴板监听、S打开设置、R查看下载记录、Q退出。注意看输入框下方的灰色提示和三个按钮——界面把所有复杂参数都藏了起来新手只需要会粘贴和点击。下载完成的文件去哪了位置清晰可查运行方式作品文件默认位置配置文件位置源码运行./Volume/Download./Volume/settings.json程序包运行.\_internal\Volume\Download.\_internal\Volume\settings.json场景对号入座四类使用者各自怎么用同样是这款工具不同人用法完全不同。看看你属于哪一类。日常收藏党界面操作加剪贴板监听适合偶尔保存单条内容的人。启动python main.py后按M开启剪贴板监听之后在任何地方复制作品链接程序都会自动识别并下载复制即下双手彻底解放。亮点一句话界面直观零学习成本。批量搬运工命令行一次带走一堆适合整理素材、批量备份的人。命令行参数灵活几十个参数任你组合# 下载单个作品 python main.py --url 小红书作品链接 # 一次提交多个链接空格分隔用引号包裹 python main.py --url 链接1 链接2 链接3 # 只下载图文的第 3、6、9 张图片 python main.py --url 作品链接 --index 3 6 9 # 自定义保存路径并指定界面语言 python main.py --url 作品链接 --work_path D:\素材库 --language zh_CN上面这张截图列出了完整的命令行参数表--index参数对几十张图的长图文尤其实用——想存哪几张就存哪几张不必全量下载。浏览器重度用户页面内提取程序负责下载装好 Tampermonkey 扩展后把项目里的static/XHS-Downloader.js导入为用户脚本小红书页面就会出现功能菜单支持提取发布、点赞、收藏作品链接与搜索结果。更妙的是联动玩法在配置文件中把script_server设为true让主程序在后台运行浏览器里点一下推送下载任务下载就交给程序完成——浏览器只负责提取程序负责下载。截图里的菜单在页面更多按钮中展开提取出的链接自动复制到剪贴板方便你随时粘贴给程序。开发者与 AI 工作流API 与 MCP 模式如果你想让代码或 AI 助手替你操作下载服务器模式正合适。运行python main.py api后访问http://127.0.0.1:5556/docs即可看到自动生成的交互式接口文档通过 POST 请求/xhs/detail采集作品信息并触发下载。运行python main.py mcp在支持 MCP 的对话工具里配置http://127.0.0.1:5556/mcp/地址就能直接说帮我下载这个链接。像上图这样AI 助手直接返回作品标题、类型等信息整个下载流程由它代劳。有更个性化的需求时项目根目录的example.py提供了完整的代码调用示例。四种场景怎么选一张表收尾场景适合人群启动方式一句话亮点日常收藏新手、随手保存python main.py剪贴板监听复制即下批量搬运运营、素材整理python main.py --url ...参数灵活可按序号挑图浏览器联动网页重度用户Tampermonkey 加载脚本页面内提取一键推送自动化接入开发者、AI 工作流python main.py api/mcp可编程调用交给机器干把默认配置调成你的偏好首次运行会自动生成./Volume/settings.json改完记得重启程序生效。常用的几个参数速查如下参数作用默认值推荐设置work_path作品保存根路径项目根路径/Volume改为你的素材目录folder_name作品文件存放文件夹名Download按需修改image_format图片下载格式JPEG追求原图选 AUTO 或 PNGimage_download图片下载总开关true不需要时关掉video_download视频下载总开关true不需要时关掉live_download动图文件下载开关false需要保存 LivePhoto 时开启video_preference视频偏好resolution想省空间可改 sizefolder_mode每个作品单独一个文件夹false作品多时建议开启author_archive每个作者单独一个文件夹false整理素材强烈推荐download_record记录已下载作品 ID 并跳过true保持开启proxy网络代理无网络受限时填写Cookie 专题解锁高画质的关键一步程序本身不登录也能用但未配置 Cookie 时视频只能下载低分辨率版本。好在获取 Cookie 不需要登录账号浏览器打开小红书网页版按F12打开开发者工具切到网络选项卡勾选保留日志刷新页面在Fetch/XHR过滤器中找到任意接口请求打开标头标签复制请求头中的完整Cookie字段粘贴到程序设置或配置文件里。上图红框标注了每一步的位置照着做一分钟就能拿到。注意 Cookie 有时效性功能异常时重新获取一份再试即可。两个容易被忽略的高价值配置name_format决定文件名长什么样默认是发布时间 作者昵称 作品标题支持插入点赞数、作品ID、作品类型等十几种字段按你的归档习惯组合即可。write_mtime把文件修改时间改成作品发布时间开启后按时间线翻文件就像翻作品时间轴素材库整齐得能治愈强迫症。避坑清单五个高频翻车现场Q1下载失败或一直卡住多半是网络问题。检查是否开着全局代理工具它会干扰请求尝试关闭后重试同时看一眼程序日志中的具体报错。Q2视频清晰度上不去十有八九是没配 Cookie。按上文步骤配置后重启程序再下载一次即可拿到高画质资源。Q3提示链接失效或被风控作品链接自带日期信息隔太久的链接容易被拦截。务必使用最新获取的链接并避免短时间内高频请求程序内置的请求延时机制保持默认即可。Q4传了多个链接只下载了第一个因为你设置了--index参数——该参数只对首个链接生效。想批量下载去掉--index再传多链接。Q5如何更新到最新版本源码运行执行git pull origin main后更新依赖程序包用户下载新版后把旧版的 Volume 配置文件夹复制过去设置无缝迁移。写在最后从单张原图到高清视频从单个作品到整账号批量提取从界面点击到命令行、浏览器脚本乃至 AI 对话——XHS-Downloader 把保存小红书内容这件事做到了一个工具能做的上限全程免费开源、持续维护还自带中英文双语言界面。最后也提醒一句下载的内容请仅用于个人学习与灵感收藏等非商业用途尊重每一位原创作者的劳动。工具是善意的用它的我们也该守住分寸。现在打开终端跑起你的第一次下载吧——把那些让你心动的瞬间真正留在自己的硬盘里 【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考