零基础搞定小红书作品下载XHS-Downloader 图文视频动图采集全攻略【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader想把小红书上的图文、视频、动态图片完整存到本地却总被画质、格式和批量下载卡住XHS-Downloader 是一款开源的小红书作品下载工具能提取作品链接、采集作品信息并批量下载图文、视频与动态图片。这篇教程从零开始带你走完从安装到进阶的全流程全程不用接触任何晦涩技术。从一个存不下来的瞬间说起先说个我自己的经历。去年做旅行攻略刷到一篇特别详尽的目的地笔记九张图张张精美还有一张会动的 LivePhoto。我心想存下来慢慢看结果长按保存的图片糊成一团还带水印动图变成了静图视频更是找不到下载入口。无奈之下我只能逐张截图折腾半小时效果还差强人意。后来翻开源社区时发现了 XHS-Downloader才知道原来保存小红书作品这件事可以做得这么干净利落——原图画质、完整动图、全分辨率视频一个链接全搞定。它不只是一个下载器更像一个链接采集 信息提取 文件下载的完整工具箱下面我会按实际使用顺序把它讲清楚。动手前先认清它能做什么在开始安装之前我们花一分钟看看它的能力边界这样后面用起来心里有数。简单来说它覆盖了三条链路1. 链接提取给收藏狂魔用提取账号发布、收藏、点赞、专辑中的全部作品链接提取搜索结果中的作品链接和用户链接提取推荐页里的作品链接2. 信息采集给做资料库的人用采集作品标题、描述、类型、发布时间、作者信息、互动数据可将作品信息持久化保存为 SQLite 数据库或按单篇保存为 txt / Markdown 文件3. 文件下载最核心的能力下载图文作品的每一张原图支持PNG / WEBP / JPEG / HEIC格式自定义下载视频作品并可按分辨率、码率、文件大小三种偏好挑选画质下载 LivePhoto 动态图片文件支持多链接批量下载、断点续传、自动跳过已下载作品最打动我的一点是它连下载记录都帮你管好了。同一个作品下载过一次下次再遇到会自动跳过不会白白浪费流量和时间。十分钟上手选一种方式启动它安装方式有三种按你的使用习惯挑一个就行方式一直接用预编译程序新手首选到项目 Releases 页面下载对应平台的压缩包解压后双击运行main即可。Windows 和 macOS 用户都能直接用不用装 Python。下载路径默认在_internal/Volume/Download配置文件会自动生成在同级目录。方式二源码运行可定制性最强git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader pip install -r requirements.txt python main.py如果你装了uv更推荐这条更快的路径uv sync --no-dev uv run main.py方式三Docker 部署适合服务器 / NASdocker pull joeanamier/xhs-downloader docker run -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader提示如果只是偶尔下载几个作品用方式一就够了想长期维护、批量处理、二次开发建议用方式二。第一次下载从输入链接到文件落地启动程序后你会看到一个简洁的终端界面操作流程简单到令人意外把作品链接粘贴进输入框一次可以粘贴多个链接用空格分隔点击下载作品文件等待片刻文件就会按预设规则出现在下载文件夹里支持的链接类型很全包括explore详情页、user/profile主页下的作品、以及xhslink.com短链分享码程序会自动识别有效链接你不需要手动处理。对于图文作品如果你只想下载其中某几张图可以用命令行模式指定序号python main.py --url https://www.xiaohongshu.com/explore/作品ID --index 1 3 5这样只会下载第 1、3、5 张图片是不是很贴心四个设置让下载体验直接翻倍用过几天之后我建议你去程序设置界面或直接编辑Volume/settings.json做几处调整体验会有质的提升① 配置 Cookie解锁高清视频不配置 Cookie 也能正常下载但视频只能拿到低分辨率版本。配置 Cookie无需登录账号只需打开浏览器、按 F12 从网络请求里复制一份即可画质立刻提升一个档次。② 选择图片格式默认是 JPEG想要更高质量可以试试WEBP或HEIC。值得注意的是部分作品没有 HEIC 版本这时程序会回退到 WEBP属于正常现象。③ 自定义文件命名默认命名是发布时间 作者昵称 作品标题你也可以在name_format里加入收藏数、点赞数、作品类型、作者 ID 等字段方便日后按自己的习惯归档查找。④ 打开作者归档设置author_archive后每个作者的作品会存入以作者ID_昵称命名的独立文件夹。更妙的是如果作者改了昵称程序会自动更新已下载文件中对应的昵称部分你甚至可以通过mapping_data为某个作者设置专属别名。配置文件的写法也很直观{ image_format: WEBP, video_preference: resolution, folder_mode: true, author_archive: true, live_download: true, download_record: true }修改完重启程序即可生效不需要额外的操作。进阶玩法浏览器脚本实现批量采集如果你想整理一位博主的所有作品或者在搜索结果里批量收藏内容这时候就该请出配套的用户脚本了。在浏览器安装 Tampermonkey 扩展后导入项目static/目录下的XHS-Downloader.js浏览小红书页面时就会多出一个功能菜单它的核心玩法是提取链接 → 交给程序下载两步走在博主主页点提取发布作品链接脚本会自动滚动页面、加载全部作品并把所有链接复制到剪贴板发布、收藏、点赞、专辑、搜索页都支持把链接粘贴进程序批量下载或开启脚本服务器联动在配置文件中把script_server设为true保持程序后台运行浏览时直接点推送下载任务一键完成下载顺带一提脚本还支持多图作品打包成压缩包下载、下载前勾选需要的图片等细节功能用起来相当顺手。给技术流命令行、API 与 MCP 三件套如果你是开发者或想让下载任务接入自己的工具链XHS-Downloader 还提供了三种可编程的玩法命令行模式所有参数都可以通过 CLI 传入适合写进自动化脚本python main.py --url 作品链接1 作品链接2 --image_format WEBP python main.py --url 作品链接 --index 2 4 --folder_mode trueAPI 模式运行python main.py api启动本地服务默认端口 5556访问http://127.0.0.1:5556/docs可看到自动生成的交互式文档。核心接口是POST /xhs/detailimport requests server http://127.0.0.1:5556/xhs/detail data { url: 小红书作品链接, download: True, index: [1, 3], proxy: http://127.0.0.1:10808 } response requests.post(server, jsondata, timeout10) print(response.json())MCP 模式这是最有意思的一个。运行python main.py mcp启动 MCP 服务后你可以在支持 MCP 的客户端比如各类 AI 助手里配置一个XHS-Downloader工具然后直接用自然语言对话来操作比如告诉 AI下载这个小红书作品的第 2 张图片它就会自动调用工具完成下载并返回结果——真正把下载变成了 AI 可以替你完成的任务。避坑指南这些细节提前知道用了几个月我把踩过的坑整理成几条帮你省下摸索时间旧链接可能被风控作品链接携带日期信息太久之前获取的链接可能失效建议下载时使用最新提取的链接自动滚动有风险用户脚本的自动滚动功能默认关闭是有原因的——频繁自动滚动可能被平台判定为自动化操作有账号风控风险建议按需小范围使用想重新下载旧作品程序默认开启下载记录重复下载会直接跳过。如果你确实想重下需要先删除数据库里对应的作品 ID剪贴板监听很好用开启后程序会自动读取剪贴板中的链接并开始下载浏览时复制即下载适合批量整理收藏夹程序内置请求延时机制这是为了不给平台服务器造成压力批量下载时耐心等待即可不要自行调高并发常见疑问速答Q视频画质不清晰怎么办A八成是没配置 Cookie。参考上文在设置中填入一份 Cookie无需登录画质限制就会解除。Q动态图片下载后打不开A确认已开启live_download开关动图以 HEIC 格式保存大多数现代播放器都支持个别老播放器需要转换格式。Q批量下载中途断网了A不用担心程序支持断点续传重新运行会接着下载未完成的部分已完成的文件不会重复下载。Q能下载别人所有历史作品吗A用配套用户脚本在博主主页一键提取全部发布链接再交给程序批量下载即可这就是推荐脚本 程序组合的原因。从第一次成功下载到现在XHS-Downloader 已经成了我整理小红书内容的固定工具旅行攻略存图、收藏夹批量归档、为内容创作收集素材它都处理得井井有条。项目采用 GPL-3.0 开源协议所有处理都在本地完成不依赖任何付费服务。核心逻辑集中在 source/application/ 模块感兴趣的话也可以直接读源码了解它的实现思路。工具虽好也请记得尊重原创内容只保存自己有权使用的作品。希望这篇攻略能帮你把收藏夹真正装进硬盘从此不再为存不下内容发愁。【免费下载链接】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 是一款开源的小红书作品下载工具能提取作品链接、采集作品信息并批量下载图文、视频与动态图片。这篇教程从零开始带你走完从安装到进阶的全流程全程不用接触任何晦涩技术。从一个存不下来的瞬间说起先说个我自己的经历。去年做旅行攻略刷到一篇特别详尽的目的地笔记九张图张张精美还有一张会动的 LivePhoto。我心想存下来慢慢看结果长按保存的图片糊成一团还带水印动图变成了静图视频更是找不到下载入口。无奈之下我只能逐张截图折腾半小时效果还差强人意。后来翻开源社区时发现了 XHS-Downloader才知道原来保存小红书作品这件事可以做得这么干净利落——原图画质、完整动图、全分辨率视频一个链接全搞定。它不只是一个下载器更像一个链接采集 信息提取 文件下载的完整工具箱下面我会按实际使用顺序把它讲清楚。动手前先认清它能做什么在开始安装之前我们花一分钟看看它的能力边界这样后面用起来心里有数。简单来说它覆盖了三条链路1. 链接提取给收藏狂魔用提取账号发布、收藏、点赞、专辑中的全部作品链接提取搜索结果中的作品链接和用户链接提取推荐页里的作品链接2. 信息采集给做资料库的人用采集作品标题、描述、类型、发布时间、作者信息、互动数据可将作品信息持久化保存为 SQLite 数据库或按单篇保存为 txt / Markdown 文件3. 文件下载最核心的能力下载图文作品的每一张原图支持PNG / WEBP / JPEG / HEIC格式自定义下载视频作品并可按分辨率、码率、文件大小三种偏好挑选画质下载 LivePhoto 动态图片文件支持多链接批量下载、断点续传、自动跳过已下载作品最打动我的一点是它连下载记录都帮你管好了。同一个作品下载过一次下次再遇到会自动跳过不会白白浪费流量和时间。十分钟上手选一种方式启动它安装方式有三种按你的使用习惯挑一个就行方式一直接用预编译程序新手首选到项目 Releases 页面下载对应平台的压缩包解压后双击运行main即可。Windows 和 macOS 用户都能直接用不用装 Python。下载路径默认在_internal/Volume/Download配置文件会自动生成在同级目录。方式二源码运行可定制性最强git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader pip install -r requirements.txt python main.py如果你装了uv更推荐这条更快的路径uv sync --no-dev uv run main.py方式三Docker 部署适合服务器 / NASdocker pull joeanamier/xhs-downloader docker run -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader提示如果只是偶尔下载几个作品用方式一就够了想长期维护、批量处理、二次开发建议用方式二。第一次下载从输入链接到文件落地启动程序后你会看到一个简洁的终端界面操作流程简单到令人意外把作品链接粘贴进输入框一次可以粘贴多个链接用空格分隔点击下载作品文件等待片刻文件就会按预设规则出现在下载文件夹里支持的链接类型很全包括explore详情页、user/profile主页下的作品、以及xhslink.com短链分享码程序会自动识别有效链接你不需要手动处理。对于图文作品如果你只想下载其中某几张图可以用命令行模式指定序号python main.py --url https://www.xiaohongshu.com/explore/作品ID --index 1 3 5这样只会下载第 1、3、5 张图片是不是很贴心四个设置让下载体验直接翻倍用过几天之后我建议你去程序设置界面或直接编辑Volume/settings.json做几处调整体验会有质的提升① 配置 Cookie解锁高清视频不配置 Cookie 也能正常下载但视频只能拿到低分辨率版本。配置 Cookie无需登录账号只需打开浏览器、按 F12 从网络请求里复制一份即可画质立刻提升一个档次。② 选择图片格式默认是 JPEG想要更高质量可以试试WEBP或HEIC。值得注意的是部分作品没有 HEIC 版本这时程序会回退到 WEBP属于正常现象。③ 自定义文件命名默认命名是发布时间 作者昵称 作品标题你也可以在name_format里加入收藏数、点赞数、作品类型、作者 ID 等字段方便日后按自己的习惯归档查找。④ 打开作者归档设置author_archive后每个作者的作品会存入以作者ID_昵称命名的独立文件夹。更妙的是如果作者改了昵称程序会自动更新已下载文件中对应的昵称部分你甚至可以通过mapping_data为某个作者设置专属别名。配置文件的写法也很直观{ image_format: WEBP, video_preference: resolution, folder_mode: true, author_archive: true, live_download: true, download_record: true }修改完重启程序即可生效不需要额外的操作。进阶玩法浏览器脚本实现批量采集如果你想整理一位博主的所有作品或者在搜索结果里批量收藏内容这时候就该请出配套的用户脚本了。在浏览器安装 Tampermonkey 扩展后导入项目static/目录下的XHS-Downloader.js浏览小红书页面时就会多出一个功能菜单它的核心玩法是提取链接 → 交给程序下载两步走在博主主页点提取发布作品链接脚本会自动滚动页面、加载全部作品并把所有链接复制到剪贴板发布、收藏、点赞、专辑、搜索页都支持把链接粘贴进程序批量下载或开启脚本服务器联动在配置文件中把script_server设为true保持程序后台运行浏览时直接点推送下载任务一键完成下载顺带一提脚本还支持多图作品打包成压缩包下载、下载前勾选需要的图片等细节功能用起来相当顺手。给技术流命令行、API 与 MCP 三件套如果你是开发者或想让下载任务接入自己的工具链XHS-Downloader 还提供了三种可编程的玩法命令行模式所有参数都可以通过 CLI 传入适合写进自动化脚本python main.py --url 作品链接1 作品链接2 --image_format WEBP python main.py --url 作品链接 --index 2 4 --folder_mode trueAPI 模式运行python main.py api启动本地服务默认端口 5556访问http://127.0.0.1:5556/docs可看到自动生成的交互式文档。核心接口是POST /xhs/detailimport requests server http://127.0.0.1:5556/xhs/detail data { url: 小红书作品链接, download: True, index: [1, 3], proxy: http://127.0.0.1:10808 } response requests.post(server, jsondata, timeout10) print(response.json())MCP 模式这是最有意思的一个。运行python main.py mcp启动 MCP 服务后你可以在支持 MCP 的客户端比如各类 AI 助手里配置一个XHS-Downloader工具然后直接用自然语言对话来操作比如告诉 AI下载这个小红书作品的第 2 张图片它就会自动调用工具完成下载并返回结果——真正把下载变成了 AI 可以替你完成的任务。避坑指南这些细节提前知道用了几个月我把踩过的坑整理成几条帮你省下摸索时间旧链接可能被风控作品链接携带日期信息太久之前获取的链接可能失效建议下载时使用最新提取的链接自动滚动有风险用户脚本的自动滚动功能默认关闭是有原因的——频繁自动滚动可能被平台判定为自动化操作有账号风控风险建议按需小范围使用想重新下载旧作品程序默认开启下载记录重复下载会直接跳过。如果你确实想重下需要先删除数据库里对应的作品 ID剪贴板监听很好用开启后程序会自动读取剪贴板中的链接并开始下载浏览时复制即下载适合批量整理收藏夹程序内置请求延时机制这是为了不给平台服务器造成压力批量下载时耐心等待即可不要自行调高并发常见疑问速答Q视频画质不清晰怎么办A八成是没配置 Cookie。参考上文在设置中填入一份 Cookie无需登录画质限制就会解除。Q动态图片下载后打不开A确认已开启live_download开关动图以 HEIC 格式保存大多数现代播放器都支持个别老播放器需要转换格式。Q批量下载中途断网了A不用担心程序支持断点续传重新运行会接着下载未完成的部分已完成的文件不会重复下载。Q能下载别人所有历史作品吗A用配套用户脚本在博主主页一键提取全部发布链接再交给程序批量下载即可这就是推荐脚本 程序组合的原因。从第一次成功下载到现在XHS-Downloader 已经成了我整理小红书内容的固定工具旅行攻略存图、收藏夹批量归档、为内容创作收集素材它都处理得井井有条。项目采用 GPL-3.0 开源协议所有处理都在本地完成不依赖任何付费服务。核心逻辑集中在 source/application/ 模块感兴趣的话也可以直接读源码了解它的实现思路。工具虽好也请记得尊重原创内容只保存自己有权使用的作品。希望这篇攻略能帮你把收藏夹真正装进硬盘从此不再为存不下内容发愁。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考