小红书批量下载实战XHS-Downloader 完整上手指南【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader收藏夹里的笔记越攒越多真到找素材那天却连原图、原视频都翻不回来——这是很多人在整理小红书内容时都会撞上的墙。XHS-Downloader 正是为拆掉这堵墙而生的开源小红书链接提取与作品下载工具把账号发布、收藏、点赞、专辑以及搜索结果里的作品链接成批提取出来再把图文、视频、livePhoto 动图下载到本地归档所见即所得不碰破解、无需登录。读完这篇文章你将收获一套从零装好环境、跑起程序的可照做步骤用浏览器用户脚本批量提取链接、把链接装进剪贴板的方法用图形界面完成第一次作品下载的完整流程用命令行实现批量下载、写进自动化脚本的实用技巧用 API 与 MCP 把下载能力开放给其他程序的做法一份配置文件速查表和三个高频问题的排查方案装好运行环境让工具先跑起来XHS-Downloader 是 Python 项目源码运行最灵活。先准备一个不低于 3.12 的 Python 解释器再克隆或下载源码git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader安装依赖有两种主流方式任选其一# 方式一pip 安装建议配合虚拟环境 python -m venv venv pip install -r requirements.txt python main.py # 方式二uv 安装更快推荐 uv sync --no-dev uv run main.py到这里终端里应该已经出现了图形化的主界面。程序首次运行后会在根目录的Volume文件夹里自动生成settings.json配置文件——之后的所有下载行为都由它管着。不想折腾本地环境的话也可以直接用项目根目录的Dockerfile构建镜像运行。提示Windows 用户建议用 Windows 终端运行程序显示效果最佳Mac 上如果使用打包好的可执行文件首次运行前先执行xattr -cr 项目文件夹路径解除系统安全限制。装好环境、界面弹出来工具就已经活了。下一步要解决的是下载的前置问题——拿到链接。在浏览器里圈选作品批量提取下载链接手动一条条复制作品地址采集一百条就要点一百次。XHS-Downloader 的 Tampermonkey 用户脚本源码在static/XHS-Downloader.js就是专门解决这个痛点的。先给浏览器装好 Tampermonkey 扩展再从从 URL 安装入口把脚本装进去安装界面长这样装好后打开小红书任意页面侧边会出现一个功能菜单支持一键提取提取推荐页面的作品链接提取账号发布、收藏、点赞、专辑的作品链接提取搜索结果的作品链接与用户链接提取结果会自动写入剪贴板你还可以在脚本设置里开启自动滚动加载更多内容默认关闭滚动次数可自定义。到这里逛一圈页面几十上百条链接已经躺在剪贴板里了。提示脚本只做可见即可得的数据提取不含任何破解功能批量提取时建议关闭自动滚动避免被平台判定为自动化操作。粘贴链接完成第一次下载链接到手回到主程序。主界面正中是一个输入框支持一次粘贴多条链接链接之间用空格分隔即可程序会自动提取有效链接无需手动清洗。支持的链接格式包括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进设置、R看下载记录、U检查更新按Q退出。到这里你已经完成了一次完整的小红书批量下载流程。接下来把重复劳动交给命令行。用命令行一次跑完批量下载如果想把下载写进定时任务或者与别的脚本联动命令行模式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把本次命令行参数写回配置文件--help-h查看全部参数说明注意未设置--index时才能一次传入多个链接设置了--index后即使传入多个链接程序也只处理第一个。命令行参数与配置文件一一对应所有参数定义都可以在source/CLI/main.py里查到。想彻底撒手就加一句--update_settings把这次用的参数固化进settings.json下次直接python main.py也能保持同样的下载习惯。用 API 与 MCP 把下载能力开放出去命令行还是人操作机器API 与 MCP 则是让别的程序来调用 XHS-Downloader——这对开发者和 AI 工具用户特别有价值。启动 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())MCP 模式则是为 AI 助手准备的执行python main.py mcp后在支持 MCP 的客户端里配置一个 Streamable HTTP 服务地址填http://127.0.0.1:5556/mcp/AI 就能直接指挥它获取作品信息或下载文件这样一来你的公众号机器人、自动化脚本、AI 工作流都能复用这一套采集与下载能力而不必自己重新对接小红书接口。想深入二次开发可以看根目录的example.py里面XHS类的调用示例就是最直接的模板。调教下载行为绕开常见问题无论走哪条路程序的默认行为都由Volume/settings.json控制。看不懂 TUI 设置界面就直接编辑这个文件改完重启程序生效。几个最值得动手的配置项配置项默认值说明image_formatJPEG图片下载格式想要原格式就设AUTOname_format发布时间 作者昵称 作品标题文件命名规则支持点赞数、作品ID等字段folder_modefalse开启后每个作品单独一个文件夹author_archivefalse开启后按作者建文件夹昵称变更自动更新download_recordtrue记录已下载的作品ID避免重复下载write_mtimefalse把文件修改时间改成作品发布时间video_preferenceresolution视频选择策略分辨率 / 码率 / 体积优先cookie空小红书网页版 Cookie非必需但建议配置配置相关的全部参数与默认值都定义在source/module/settings.py里对照着看就不会改错。改完配置再来看三个高频问题。问题一下载的视频画质太低原因未配置 Cookie 时视频作品只能下载低分辨率版本。解决办法打开浏览器访问小红书任意页面按 F12 打开开发者工具在网络面板勾选保留日志并过滤web_session从任意请求中复制完整的 Cookie 填入程序即可全程无需登录账号。问题二同一个作品被重复下载原因程序默认开启下载记录已下载过的作品会自动跳过只有数据库里的记录被清理后才会重新下载。解决办法正常情况下保持download_record为true即可只有文件被误删想重下时才清理Volume/ExploreID.db里对应的作品 ID。问题三请求经常失败或超时原因网络环境不稳定或者使用的作品链接过于陈旧链接携带日期信息旧链接容易被风控。解决办法调大配置文件里的max_retry和timeout网络特殊就设置proxy代理同时尽量使用最新获取的作品链接。到这里你已经掌握了 XHS-Downloader 从链接提取到作品下载的完整玩法。下一步建议你这样做装好用户脚本 主程序把逛小红书变成日常采集动作按自己的归档习惯改一份settings.json一次调教长期受益想更进一步就照着example.py把下载能力嵌进你自己的脚本进阶玩家还可以读一读source/application/下的请求与下载模块理解它的采集逻辑后你就能自己扩展出更多玩法了。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考