XHS-Downloader 小红书下载工具全攻略三步上手把收藏夹一次搬进硬盘【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader深夜十一点你刷到一条超详细的收纳教程随手点了收藏。三个月后那条笔记还躺在收藏夹里——有些甚至已被原作者删除点开只剩一片空白。想把高清原图存下来右键保存的却是压缩版想离线看视频网上一搜工具不是要收费就是要登录。XHS-Downloader 正是为此而生的开源免费小红书下载工具无需注册账号把作品链接粘贴进去它就能自动采集作品信息、解析下载地址把图文和视频原样带回你的硬盘。这篇教程会带你从零开始走完全流程先装好环境再亲手完成第一次下载随后用一张总览表看懂它的全部能力最后解锁批量下载与画质优化这些进阶姿势。动手前先花两分钟确认环境选好安装方式在正式折腾之前有两件小事值得先弄清楚能帮你省掉后面一大半麻烦。第一件Python 版本够不够。项目要求 Python 3.12 及以上版本太老的解释器跑不起来。打开终端执行python --version看一眼不够就先去官网装个新版。第二件代码从哪来。把仓库克隆到本地git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader依赖安装有两条路线按你的习惯挑一条就行。如果偏爱传统 Python 生态选 pip如果追求速度和省心强烈推荐 uv——它会自动锁定依赖版本重装时快很多。对比项pip 路线uv 路线需要什么Python 3.12 和 pipPython 3.12 和 uv安装依赖pip install -r requirements.txtuv sync --no-dev启动程序python main.pyuv run main.py适合谁熟悉传统 Python 的老手想少踩坑、装得快的朋友依赖装完工具就绪可以开始干活了。第一次下载粘贴链接、点击下载、确认落盘位置在项目根目录敲下python main.py回车程序的主界面就会铺在终端里。界面走的是深色风格一眼就能找到中间那个输入框。整个流程其实只有三步复制链接。去小红书复制作品页链接explore作品页、xhslink.com短链、个人主页里的作品链接都可以识别。想一次下载多篇没问题把几个链接用空格隔开、一起粘贴进去即可程序会自动筛出有效链接。点击下载。按下界面上醒目的下载作品文件按钮程序会依次完成请求数据 → 解析资源 → 保存文件你只需要盯着进度条慢慢等。确认结果。下载完成后去文件目录里看一眼作品已经安安静静地躺在那里了。文件落在哪取决于你的运行方式见下表运行形态作品文件位置配置文件位置源码运行./Volume/Download./Volume/settings.json打包程序.\_internal\Volume\Download.\_internal\Volume\settings.json界面的快捷键也很顺手Q退出、S打开设置、R查看下载记录、M开启剪贴板监听、U检查更新。第一次下载到这一步就成功了接下来看看它还有哪些本事。一张表看懂它到底能干什么XHS-Downloader 的功能比下载作品这四个字丰富得多。下面这张总览表把它的看家本领一次列全能力解决什么问题一句话亮点图文原图下载右键保存的图片总被压缩支持自定义格式还能按序号挑图视频下载想离线看、想存高清版可解锁高画质下载偏好可调LivePhoto 动图图文里的动图单独存独立开关想存就存账号作品提取想把某位博主的内容批量备份发布、收藏、点赞、专辑链接一键提取搜索结果提取想收集某一主题的内容作品和用户链接都能提取断点续传大文件下载到一半断了接着下不用从头再来跳过重复重复下载白费流量下载记录自动识别已存作品自动归档文件散落一地、难以整理按作者、按作品自动分文件夹剪贴板监听复制完链接还要手动粘贴开启后复制即下载双语界面中英文切换麻烦zh_CN/en_US随时切换挑几个细说。图文下载时图片格式可以在 AUTO、PNG、WEBP、JPEG、HEIC 之间自由选择追求原图质量选 AUTO 或 PNG 就行视频下载时可以选择分辨率优先、码率优先或文件大小优先配合 Cookie 还能拿到更高清晰度的资源。至于账号内容提取输入一个作者主页发布、收藏、点赞、专辑的作品链接都能成批抓出来配合自动滚动加载收藏夹再大也能一次清空。进阶玩法从命令行批量下载到浏览器一键推送基础操作掌握后XHS-Downloader 还提供了好几种玩法覆盖不同的使用习惯。第一种命令行模式适合批量操作和脚本化。不想开界面一条命令就能下载。所有参数都支持缩写常用写法如下# 一次提交多个作品链接空格分隔引号包裹 python main.py --url 作品链接A 作品链接B 作品链接C # 长图文只挑第 3、6、9 张图下载 python main.py --url 作品链接 --index 3 6 9 # 指定保存目录顺便把界面语言切成英文 python main.py --url 作品链接 --work_path /data/素材库 --language en_US其中--index是最实用的参数面对几十张图的长图文只想存其中几张时把它指出来即可不必全量下载。第二种用户脚本让浏览器变成提取器。如果你的浏览器装了 Tampermonkey把项目里的static/XHS-Downloader.js导入为用户脚本页面右上角就会出现一个功能菜单提取发布、点赞、收藏作品链接提取搜索结果一键推送下载任务。配合自动滚动页面功能长列表也能一网打尽。更妙的是连接服务器玩法在配置文件里把script_server设为true让主程序在后台待命你在浏览器里点一下推送下载任务下载工作就交给程序完成——浏览器负责提取程序负责下载各干各的效率拉满。第三种API 与 MCP 模式适合开发者与 AI 工作流。运行python main.py api浏览器访问http://127.0.0.1:5556/docs就能看到自动生成的交互式接口文档通过 POST 请求/xhs/detail即可采集作品信息并触发下载运行python main.py mcp在支持 MCP 的对话工具里配置好地址后你甚至可以直接对 AI 说帮我下载这个链接。习惯容器化部署的朋友还可以用docker pull joeanamier/xhs-downloader拉取镜像直接运行TUI、API、MCP 三种模式都支持。进阶设置配好 Cookie让下载更快更稳下载体验要好几个设置值得花两分钟调一下。其中最关键的是Cookie。程序本身不强制要求登录但没有 Cookie 时视频只能拿到低分辨率版本配置 Cookie 后不仅能解锁高画质请求也更稳定。获取方法并不复杂用浏览器打开小红书网页版按F12打开开发者工具切到网络选项卡刷新页面在请求列表里找到任意xhs/v1开头的接口在请求详情中复制完整的Cookie字段粘贴到程序设置或配置文件中。配置文件./Volume/settings.json首次运行会自动生成程序所有参数都由source/module/settings.py统一管理。改完配置记得重启程序才生效。下面是几个最常用的参数参数它管什么给你的小建议cookie请求数据用的身份凭据建议配置解锁高清视频proxy网络代理网络受限时填写image_format图片落地格式想要原图选 AUTO 或 PNGfolder_mode每篇作品单独成文件夹作品多时建议开启author_archive按作者归档长期追更某位博主时强烈建议download_record记录已下载作品 ID保持开启自动跳过重复write_mtime文件时间戳同步发布时间归档强迫症福音note_format顺手保存作品文字信息可选 txt / md 格式下载记录由source/module/recorder.py持久化管理重启程序也不会丢断点续传和请求延时机制都已内置正常使用即可。常见问题新手最容易问的五个问题Q1下载到一半断了要重新来吗不用。程序内置断点续传中断后重新发起下载会从断点继续已经完成的文件部分不会白费。Q2为什么我下载的视频不够清晰大概率是没配 Cookie。按上文步骤配置后重启程序再下一次就能拿到更高画质的资源。Q3必须登录账号、必须配 Cookie 吗都不强制。不配 Cookie 也能正常下载图片和低分辨率视频只是画质受限。全程无需登录你的小红书账号。Q4提示链接失效或被风控怎么办小红书链接自带日期信息太旧的链接容易被拦截。建议用最新复制的链接下载并避免短时间高频请求——程序内置的延时机制就是为了这个保持默认即可。Q5想升级到最新版本怎么操作源码运行的用户执行git pull拉取最新代码再同步一次依赖即可用打包程序的话下载新版本后把旧版_internal\Volume文件夹复制过去设置就无缝迁移了。写在最后把喜欢的内容留下也把分寸守住到这里XHS-Downloader 的完整玩法你已经摸清了。最后用一张速览表帮你对号入座你的场景推荐的玩法一句话上手偶尔存几篇图形界面 TUIpython main.py批量下载、写脚本命令行 CLIpython main.py --url ...浏览器重度用户用户脚本Tampermonkey 加载脚本页面内提取开发者、AI 工作流API / MCPpython main.py api或python main.py mcp工具是开源的、免费的、持续维护的但请记得下载的内容只建议用于个人学习、灵感收藏等非商业用途。每一个作品背后都是一位创作者的劳动尊重原创是使用任何工具的前提。现在打开终端跑起你的第一次下载吧——把那些让你心动过的瞬间真正留在自己的硬盘里。【免费下载链接】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 正是为此而生的开源免费小红书下载工具无需注册账号把作品链接粘贴进去它就能自动采集作品信息、解析下载地址把图文和视频原样带回你的硬盘。这篇教程会带你从零开始走完全流程先装好环境再亲手完成第一次下载随后用一张总览表看懂它的全部能力最后解锁批量下载与画质优化这些进阶姿势。动手前先花两分钟确认环境选好安装方式在正式折腾之前有两件小事值得先弄清楚能帮你省掉后面一大半麻烦。第一件Python 版本够不够。项目要求 Python 3.12 及以上版本太老的解释器跑不起来。打开终端执行python --version看一眼不够就先去官网装个新版。第二件代码从哪来。把仓库克隆到本地git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader依赖安装有两条路线按你的习惯挑一条就行。如果偏爱传统 Python 生态选 pip如果追求速度和省心强烈推荐 uv——它会自动锁定依赖版本重装时快很多。对比项pip 路线uv 路线需要什么Python 3.12 和 pipPython 3.12 和 uv安装依赖pip install -r requirements.txtuv sync --no-dev启动程序python main.pyuv run main.py适合谁熟悉传统 Python 的老手想少踩坑、装得快的朋友依赖装完工具就绪可以开始干活了。第一次下载粘贴链接、点击下载、确认落盘位置在项目根目录敲下python main.py回车程序的主界面就会铺在终端里。界面走的是深色风格一眼就能找到中间那个输入框。整个流程其实只有三步复制链接。去小红书复制作品页链接explore作品页、xhslink.com短链、个人主页里的作品链接都可以识别。想一次下载多篇没问题把几个链接用空格隔开、一起粘贴进去即可程序会自动筛出有效链接。点击下载。按下界面上醒目的下载作品文件按钮程序会依次完成请求数据 → 解析资源 → 保存文件你只需要盯着进度条慢慢等。确认结果。下载完成后去文件目录里看一眼作品已经安安静静地躺在那里了。文件落在哪取决于你的运行方式见下表运行形态作品文件位置配置文件位置源码运行./Volume/Download./Volume/settings.json打包程序.\_internal\Volume\Download.\_internal\Volume\settings.json界面的快捷键也很顺手Q退出、S打开设置、R查看下载记录、M开启剪贴板监听、U检查更新。第一次下载到这一步就成功了接下来看看它还有哪些本事。一张表看懂它到底能干什么XHS-Downloader 的功能比下载作品这四个字丰富得多。下面这张总览表把它的看家本领一次列全能力解决什么问题一句话亮点图文原图下载右键保存的图片总被压缩支持自定义格式还能按序号挑图视频下载想离线看、想存高清版可解锁高画质下载偏好可调LivePhoto 动图图文里的动图单独存独立开关想存就存账号作品提取想把某位博主的内容批量备份发布、收藏、点赞、专辑链接一键提取搜索结果提取想收集某一主题的内容作品和用户链接都能提取断点续传大文件下载到一半断了接着下不用从头再来跳过重复重复下载白费流量下载记录自动识别已存作品自动归档文件散落一地、难以整理按作者、按作品自动分文件夹剪贴板监听复制完链接还要手动粘贴开启后复制即下载双语界面中英文切换麻烦zh_CN/en_US随时切换挑几个细说。图文下载时图片格式可以在 AUTO、PNG、WEBP、JPEG、HEIC 之间自由选择追求原图质量选 AUTO 或 PNG 就行视频下载时可以选择分辨率优先、码率优先或文件大小优先配合 Cookie 还能拿到更高清晰度的资源。至于账号内容提取输入一个作者主页发布、收藏、点赞、专辑的作品链接都能成批抓出来配合自动滚动加载收藏夹再大也能一次清空。进阶玩法从命令行批量下载到浏览器一键推送基础操作掌握后XHS-Downloader 还提供了好几种玩法覆盖不同的使用习惯。第一种命令行模式适合批量操作和脚本化。不想开界面一条命令就能下载。所有参数都支持缩写常用写法如下# 一次提交多个作品链接空格分隔引号包裹 python main.py --url 作品链接A 作品链接B 作品链接C # 长图文只挑第 3、6、9 张图下载 python main.py --url 作品链接 --index 3 6 9 # 指定保存目录顺便把界面语言切成英文 python main.py --url 作品链接 --work_path /data/素材库 --language en_US其中--index是最实用的参数面对几十张图的长图文只想存其中几张时把它指出来即可不必全量下载。第二种用户脚本让浏览器变成提取器。如果你的浏览器装了 Tampermonkey把项目里的static/XHS-Downloader.js导入为用户脚本页面右上角就会出现一个功能菜单提取发布、点赞、收藏作品链接提取搜索结果一键推送下载任务。配合自动滚动页面功能长列表也能一网打尽。更妙的是连接服务器玩法在配置文件里把script_server设为true让主程序在后台待命你在浏览器里点一下推送下载任务下载工作就交给程序完成——浏览器负责提取程序负责下载各干各的效率拉满。第三种API 与 MCP 模式适合开发者与 AI 工作流。运行python main.py api浏览器访问http://127.0.0.1:5556/docs就能看到自动生成的交互式接口文档通过 POST 请求/xhs/detail即可采集作品信息并触发下载运行python main.py mcp在支持 MCP 的对话工具里配置好地址后你甚至可以直接对 AI 说帮我下载这个链接。习惯容器化部署的朋友还可以用docker pull joeanamier/xhs-downloader拉取镜像直接运行TUI、API、MCP 三种模式都支持。进阶设置配好 Cookie让下载更快更稳下载体验要好几个设置值得花两分钟调一下。其中最关键的是Cookie。程序本身不强制要求登录但没有 Cookie 时视频只能拿到低分辨率版本配置 Cookie 后不仅能解锁高画质请求也更稳定。获取方法并不复杂用浏览器打开小红书网页版按F12打开开发者工具切到网络选项卡刷新页面在请求列表里找到任意xhs/v1开头的接口在请求详情中复制完整的Cookie字段粘贴到程序设置或配置文件中。配置文件./Volume/settings.json首次运行会自动生成程序所有参数都由source/module/settings.py统一管理。改完配置记得重启程序才生效。下面是几个最常用的参数参数它管什么给你的小建议cookie请求数据用的身份凭据建议配置解锁高清视频proxy网络代理网络受限时填写image_format图片落地格式想要原图选 AUTO 或 PNGfolder_mode每篇作品单独成文件夹作品多时建议开启author_archive按作者归档长期追更某位博主时强烈建议download_record记录已下载作品 ID保持开启自动跳过重复write_mtime文件时间戳同步发布时间归档强迫症福音note_format顺手保存作品文字信息可选 txt / md 格式下载记录由source/module/recorder.py持久化管理重启程序也不会丢断点续传和请求延时机制都已内置正常使用即可。常见问题新手最容易问的五个问题Q1下载到一半断了要重新来吗不用。程序内置断点续传中断后重新发起下载会从断点继续已经完成的文件部分不会白费。Q2为什么我下载的视频不够清晰大概率是没配 Cookie。按上文步骤配置后重启程序再下一次就能拿到更高画质的资源。Q3必须登录账号、必须配 Cookie 吗都不强制。不配 Cookie 也能正常下载图片和低分辨率视频只是画质受限。全程无需登录你的小红书账号。Q4提示链接失效或被风控怎么办小红书链接自带日期信息太旧的链接容易被拦截。建议用最新复制的链接下载并避免短时间高频请求——程序内置的延时机制就是为了这个保持默认即可。Q5想升级到最新版本怎么操作源码运行的用户执行git pull拉取最新代码再同步一次依赖即可用打包程序的话下载新版本后把旧版_internal\Volume文件夹复制过去设置就无缝迁移了。写在最后把喜欢的内容留下也把分寸守住到这里XHS-Downloader 的完整玩法你已经摸清了。最后用一张速览表帮你对号入座你的场景推荐的玩法一句话上手偶尔存几篇图形界面 TUIpython main.py批量下载、写脚本命令行 CLIpython main.py --url ...浏览器重度用户用户脚本Tampermonkey 加载脚本页面内提取开发者、AI 工作流API / MCPpython main.py api或python main.py mcp工具是开源的、免费的、持续维护的但请记得下载的内容只建议用于个人学习、灵感收藏等非商业用途。每一个作品背后都是一位创作者的劳动尊重原创是使用任何工具的前提。现在打开终端跑起你的第一次下载吧——把那些让你心动过的瞬间真正留在自己的硬盘里。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考