XHS-Downloader 实测:小红书链接一键提取、图文视频批量无水印下载的保姆级记录
XHS-Downloader 实测小红书链接一键提取、图文视频批量无水印下载的保姆级记录【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader我的手机相册里躺着三百多张小红书截图、十几段录屏——这是过去三个月攒下的素材库可真到要用的时候不是带水印就是糊成一团。直到我把开源工具 XHS-Downloader 跑起来才发现小红书图文视频的无水印批量下载居然能简单到粘贴链接、回车、等文件落地。这篇文章就是我的完整实测记录原理、上手、玩法、数据、踩坑一次讲透照着做就能跑通。我为什么放弃了截图、录屏和去水印网站没有工具的时候我保存小红书内容基本是三板斧长按保存图片水印永远醒目、对视频开录屏卡顿还糊、实在不行丢给第三方去水印网站传链接有隐私顾虑画质还要被再压一轮。最崩溃的是批量场景——一篇图文九张图我要一张张点几十篇下来手指都酸了存完的图还散落在相册里找不到。对比维度手动流截图/录屏/去水印站XHS-Downloader画质经过二次压缩细节丢失直接取服务器源文件零损耗水印基本全保留天然无水印单篇耗时3-5 分钟起步几秒到几十秒批量能力逐篇手工操作多链接排队一次下完文件管理相册里乱成一团按日期/作者/自定义命名自动归档重复内容容易存重有下载记录自动跳过一句话总结这个对比问题从来不是能不能存下来而是存下来的东西还能不能二次使用。换工具之后我实测处理 20 篇图文加 5 条视频耗时从 40 分钟级别降到了 4 分钟级别这账怎么算都划算。原理一句话能说清拆链接、找直链、拉文件理解它的工作机制其实很简单你把作品链接丢给它它解析出这篇笔记背后真实的媒体文件地址再把文件原封不动下载到本地。因为它拿的是服务器上的原始文件网页端加水印、压画质的环节被整个绕开所以图片和视频都是最干净的版本。有两个细节容易被忽略展开讲讲Cookie 决定视频清晰度。不配置 Cookie 时视频作品只能拿到低分辨率版本在设置里填一个网页 Cookie 就能解锁高清视频而且不需要登录账号。这一步强烈建议做成本不到一分钟 ✅下载偏好是配置出来的。视频可以选resolution分辨率优先、bitrate码率优先或size体积优先图片格式支持AUTO / PNG / WEBP / JPEG / HEIC要省空间选 WEBP要做后期选 PNG打开live_download还能把 livePhoto 动图文件一起存下来这个能力很多同类工具都没有。三步完成安装第一次启动长这样环境要求就一条Python 3.12 及以上。然后照做git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev uv run main.py依赖安装推荐用 uv比 pip 快不少如果网络环境装不动 uv用 pip 装requirements.txt里的依赖也一样能跑。启动后就是图形界面输入框里贴链接多个链接用空格分隔点下载作品文件它还能自动读取剪贴板里的链接省掉一次粘贴。不想折腾 Python 环境的直接下载 Releases 里的程序压缩包解压就能用文件默认存到_internal\Volume\Download配置在_internal\Volume\settings.json。两个系统坑提前说macOS 首次运行前要在终端执行xattr -cr 项目文件夹路径移除安全限制否则系统会拦着不让开Linux 上想用读取剪贴板功能得先装xclip或xsel。首次运行前我强烈推荐顺手把 Cookie 配上——解锁高清视频的关键一步就在这里。操作很简单浏览器无痕模式打开小红书 explore 页 → 按 F12 打开开发者工具 → 切到网络标签 → 勾选保留日志并筛选cookie-name:web_session→ 点开任意一个请求把 Cookie 字段整个复制粘进程序的 Cookie 设置即可。日常最省事的三种玩法从单篇到批量玩法一偶尔存一两篇直接贴链接。打开图形界面把作品链接粘贴进去点下载就完事。一次贴多个链接空格分隔也没问题程序会排队处理。玩法二批量下载靠用户脚本把链接先捞出来。这是拉开差距的核心场景——比如想把某个博主主页的作品全存下来一个个复制链接显然不现实。配合 Tampermonkey 等脚本管理器装好仓库里的用户脚本后在小红书网页端可以一键提取推荐页的作品链接、账号发布/收藏/点赞/专辑里的作品链接、搜索结果里的作品链接和用户链接。提取时脚本会自动滚动页面把内容全部加载完再抓取默认滚动 50 次次数可改抓完复制回程序里粘贴空格分隔一次批量下载。玩法三全程不用复制粘贴的联动。在配置里把script_server设为true程序就会在后台当服务器浏览器端点一下推送下载任务脚本直接把链接甩给程序处理。这是我用下来最省事的批量姿势网页端逛着逛着就点一下任务自己就下了 进阶命令行、API、MCP 三种精确控制命令行适合只要某篇笔记的第 3、5、7 张图这种精确需求。三个最常用的写法# 下载指定序号的图片仅对图文作品生效 python main.py -u 作品链接 --index 1 3 5 # 指定图文输出格式 python main.py -u 作品链接 --image_format webp # 一次下载多个作品链接空格分隔、整体加引号 python main.py -u 链接1 链接2 链接3完整参数列表在source/CLI/main.py里都有说明运行python -m source.CLI.main --help可以全部列出包括--folder_mode每篇作品单独建文件夹、--author_archive按作者分文件夹、--name_format自定义命名规则等。API 模式适合想把下载能力接进自己工作流的人。运行python main.py api访问http://127.0.0.1:5556/docs能看到自动生成的接口文档支持 POST 请求/xhs/detail传url、download、index等参数写脚本接入自己的自动化流程很顺手。MCP 模式适合想用自然语言驱动下载的人。运行python main.py mcp在支持 MCP 的客户端里配置 URLhttp://127.0.0.1:5556/mcp/然后直接说获取某作品的数据或下载某作品它就能干活二次开发门槛很低。实测数据与提前帮你避开的坑 ⚠️我拿 20 篇图文加 5 条视频做了一轮完整对比结果如下指标手动保存XHS-Downloader20 篇图文总耗时约 40 分钟4 分钟视频清晰度720p 上下带水印1080p 源文件文件命名随机乱码发布时间 作者昵称 作品标题重复内容容易存重自动跳过已下载下面是几个我已经踩过、帮你提前避开的坑每条附一句解决建议链接要用新鲜的。作品链接里带着日期信息放太久容易被风控批量下载前重新提取一遍最稳。重复下载被跳过是正常现象。程序默认开启下载记录同一作品第二次会被自动跳过想强制重下去Volume/ExploreID.db删掉对应 ID或者关闭download_record配置。全局代理可能拖后腿。开着全局代理时用户脚本下载文件可能失败遇到这种情况先关掉代理再试。别把请求频率拉太狠。程序内置了请求延时机制用来防风控硬要改快容易触发限制保持默认值就好。Linux 剪贴板要装依赖。没有xclip或xsel的话读取剪贴板功能不工作先sudo apt install xclip装上就行。最后说两句它适合谁以及一句提醒如果你和我一样经常需要保存小红书内容做学习笔记、攒素材库或者要跟某个博主的更新——尤其是有批量需求的场景XHS-Downloader 这套用户脚本捞链接 程序批量下载的组合是我目前用过最顺手的小红书无水印下载方案链接解析、原画质下载、格式转换、按作者归档全都有图形界面、命令行、API、MCP 四个入口也照顾到了不同人群。最后必须补一句提醒下载的内容请只用于个人学习与研究尊重原创作者的版权不要拿去商用或二次传播。工具给的是便利怎么用还得守住底线。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考