小红书内容批量下载 3 步上手：用 XHS-Downloader 一次性搞定图文与视频采集

小红书内容批量下载 3 步上手用 XHS-Downloader 一次性搞定图文与视频采集【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader阿岚在一家生活方式公司做内容运营每天早上打开小红书收藏夹里躺着上百条待整理的笔记。她过去的做法是一条条点开、截图、存相册、再拖进文件夹一个上午就这么报销了。直到有人塞给她一个叫 XHS-Downloader 的开源工具。这个工具专攻小红书链接提取、作品信息采集与文件下载能把复制链接→粘贴→自动保存压缩到几秒钟顺带把作者、标题、点赞数、发布时间这些元数据一起捞回来。这篇文章就用阿岚的完整经历带你从零跑通它全程不超过半小时。一分钟速览它到底能帮你干哪些活先别急着装用一张表看清楚这个工具的全貌。XHS-Downloader 支持四种玩法覆盖从手残党到程序员的所有需求玩法适合谁怎么启动典型场景图形界面GUI零基础用户双击main或运行python main.py偶尔下几条复制粘贴就完事命令行CLI批量党、脚本党python main.py -u 链接1 链接2一次处理几十上百个链接浏览器用户脚本边刷边存的用户装 Tampermonkey 开启脚本服务器浏览小红书时一键推入下载队列API / MCP开发者、AI 助手python main.py API或MCP把下载能力接进自己的程序至于能下什么一句话总结图文PNG/WEBP/JPEG/HEIC、视频、LivePhoto 动图全都支持还能单独提取某个作品里指定序号的图片。下载的同时作品信息点赞、评论、发布时间、作者昵称会被一并采集你可以决定要不要存成数据文件。上手第一步先让第一条笔记落进你的硬盘安装走的是当下最流行的 uv 方案两步搞定git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev uv run main.py不想折腾命令行直接去仓库 Release 页下载对应系统的可执行文件解压后双击运行即可效果一样。程序起来后就是下面这个界面中文界面没有任何学习成本。阿岚的第一次操作只用了十秒复制一条笔记链接 → 粘贴进输入框 → 点下载无水印作品文件。程序自动提取链接、请求数据、把图片或视频保存到./Volume/Download/目录。多个链接之间用空格分隔一次粘贴一堆也没问题。界面上还有读取剪贴板按钮点了自动识别你刚复制的链接懒人福音。这里有个贴心设计程序默认开启下载记录已经下载过的作品会自动跳过你不用担心重复劳动。想重新下载在设置里清掉记录就行。想让视频更清晰先学会这 5 步配置 Cookie阿岚很快发现一个问题默认下载的视频画质不够高。答案其实很简单——不配 Cookie拿不到高清资源。就像你去饭店只报暗号不结账人家只给你上基础套餐。配 Cookie 的步骤长这样浏览器打开小红书官网并登录按F12打开开发者工具切到网络选项卡刷新页面在筛选框输入web_session点击任意请求找到请求头里的Cookie字段整段复制把内容填进配置文件./Volume/settings.json的cookie项保存后重启程序配置文件你可以理解成偏好设置中心所有行为都在这一个 JSON 里管着。阿岚重点改了几项{ name_format: 发布时间 作者昵称 作品标题, image_format: WEBP, author_archive: true, write_mtime: true, language: zh_CN }name_format文件命名模板支持任意组合image_format图文保存格式AUTO会按原图保存author_archive按作者建文件夹归档整理素材神器write_mtime把文件修改时间改成作品发布时间素材库按时间排序就靠它进阶玩法一条命令批量收割整个账号的作品手动一条条粘贴还是太慢命令行模式就是为批量而生的。运行下面这条命令阿岚把某博主 30 条作品的链接空格分隔塞进去一次全下完python main.py -u 链接1 链接2 链接3 -aa true -l zh_CN-aa打开作者归档-l切回中文提示。想看完整参数python main.py -h程序会打印一张参数对照表如果你只想下载某条图文里的第 1、3、5 张图加上-i 1 3 5即可。配合-if PNG还能顺手转格式。所有 CLI 参数都能与配置文件互操作命令行传的值优先用完不污染配置文件。边刷边存浏览器里点一下就把任务推给程序命令行再快也得先拿到链接。阿岚后来发现最省力的姿势是用户脚本装好 Tampermonkey导入项目里的用户脚本在设置里把script_server打开之后浏览小红书时页面会自动弹出下载面板勾选想要的图片就能推送到本地程序下载。注意脚本服务器要先启动GUI 设置里开启即可它充当浏览器和本地程序的信使。一个完整实战串场从 clone 到拿到归档好的 12 条作品光说不练假把式我们把上面的知识串成一条完整的任务链——为旅行博主小鹿建一个本地素材库第 1 步环境准备。执行上面的git clone和uv sync --no-dev装好依赖。第 2 步配置 Cookie。按前文的 5 步拿到 Cookie填进./Volume/settings.json顺手把author_archive设为true、name_format设为发布时间 作者昵称 作品标题。第 3 步单点验证。先跑uv run main.py用 GUI 下载一条小鹿的笔记确认图片/视频都正常落地排除链接和网络问题。第 4 步批量执行。退出 GUI运行python main.py -u 链接A 链接B 链接C ... -l zh_CN把 12 条链接一次丢进去程序按顺序处理自动跳过已下载的。第 5 步检查成果。打开./Volume/Download/你会看到按作者名小鹿命名的文件夹里面是命名规整、按发布时间排列的作品文件元数据记录也存了下来。整个过程从第 1 步到第 5 步阿岚实际用时不到 20 分钟。选择困难症看这里什么场景该用哪种姿势只想偶尔下几条、不想碰命令行直接 GUI。复制粘贴加点击三秒一条不需要任何前置知识。要整理某个博主的全部作品或定期采集命令行 作者归档。-aa true自动按作者分文件夹配合download_record天然去重适合固定节奏的采集任务。边刷小红书边随手保存浏览器用户脚本。省去复制链接的步骤勾选即推送最适合收集灵感素材。想把下载能力接进自己的程序或 AI 助手上 API/MCP。python main.py API启动服务向http://127.0.0.1:5556/xhs/detail发一个 POST 请求就能拿到作品数据和下载地址python main.py MCP则开放http://127.0.0.1:5556/mcp/接口AI 客户端配置一下就能直接调用作者踩过的坑写下来免得你再摔一遍最后聊几句实战心得都是真金白银换来的第一画质问题先查 Cookie 而不是查网络。我一度以为高清下载是玄学后来才发现 90% 的情况是 Cookie 过期或没配全。配置后视频、动图都能拿到更高质量的资源。第二别手贱删掉下载记录文件。去重依赖它。你要是清空了记录又批量重下等于把下载过的作品重新下一遍浪费流量也容易触发平台限流。真想重下精准删那一条就行。第三网络不稳时调大容错。配置文件里的timeout超时、max_retry重试次数、chunk分块大小都是可以调的需要代理就填proxy。批量大任务前建议先跑两条链接试水别一上来就塞几百个。最后也是最重要的一条工具帮你提效但请合理控制请求频率只下载个人使用或已获授权的内容尊重创作者的版权。批量下载不是用来搬运抄袭的这是底线。现在轮到你了。打开终端clone 这个项目粘贴第一条链接30 分钟后你也能像阿岚一样准时下班。如果卡在哪一步先跑python main.py -h看参数说明大部分问题都能自己解决。去试试吧素材库不会自己长出来。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考