10分钟上手 XHS-Downloader小红书作品批量无水印下载指南【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader想把小红书上一组笔记图无水印存下来你多半试过右键另存为、手机截图结果不是带水印就是画质糊——这正是XHS-Downloader这款免费的小红书作品批量下载器要解决的。它把作品链接变成干净的图片、视频和作品数据全程在你自己的电脑上完成不上传任何文件。先搞清楚XHS-Downloader 能替你做什么在往下走之前先用一张卡判断它是不是你要找的东西项目说明适合谁想批量保存小红书作品的创作者、做资料整理的人、需要接接口的开发者解决什么问题把作品链接一键转成无水印图片、视频并附带作品数据与替代方案差异全在本地处理、数据不外传、可二次开发而插件/云服务往往受权限或收费限制是否免费完全免费开源GPL v3.0作者不提供付费版上手难度低——有图形界面、命令行、Docker 三种入口装好即用它同时覆盖图文、视频、封面和动态图livePhoto还内置了下载记录你重复丢同一批链接进去它会自动跳过已经存过的不会反复占空间。快速上手10分钟内跑通第一次下载你只需要 Python 3.12 以上。最省事的方式是用 uv 管理依赖git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev uv run main.py最后一步会直接弹出图形界面左侧是任务队列、剪贴板模式、下载记录等入口你往输入框贴链接就能跑。如果你更习惯传统 pip也可以建个虚拟环境后执行pip install -r requirements.txt再用python main.py启动。不想装 Python项目也提供了 Docker 镜像和 Mac/Windows 的可执行压缩包解压双击main就能用文件默认存到.\Volume\Download。命令行党可以直接用参数式调用一次丢进多条链接、空格分隔python main.py -u 作品链接1 作品链接2 作品链接3 -fm true -aa true这条命令的意思是批量下载这些作品每个作品单独建文件夹-fm再按作者归档到各自目录-aa。完整的参数表可以运行python main.py -h查看。核心能力拆解从单条到批量批量下载一次粘贴多条作品链接使用场景你收藏了一整列笔记想一次收进本地不想一个个点。怎么操作在 GUI 输入框或命令行-u参数里粘贴多条链接空格分隔程序会自动识别出有效链接支持explore、discovery/item、user/profile以及xhslink.com分享码这几种形式。注意点设了--index只下指定序号图片时就只处理第一条链接了想批量就别带这个参数。无水印高清Cookie 决定画质使用场景你发现视频存下来总是糊的图片也想拿原图。怎么操作在配置里填入小红书网页版 Cookie无需登录程序就能拿到更高分辨率的视频源并用--image_format指定图片保存为 PNG、WEBP、JPEG、HEIC 或 AUTO。注意点Cookie 不是强制项但未配置时视频只能下到低分辨率图片格式里 HEIC 部分作品没有会退回成 WEBP。用户脚本让浏览器帮你收集链接使用场景链接一条条复制太累尤其面对一整页作品时。怎么操作浏览器装好 Tampermonkey 后引入项目自带的用户脚本它能在作品页弹出选择要下载的图片面板也能提取推荐、发布、收藏、点赞、专辑和搜索结果里的链接开启服务器模式后点推送下载任务就能把活交给后台的主程序干。注意点脚本里那个自动滚动页面默认是关的手动开启有被判定为自动化操作、触发风控的风险非必要别动。开发者向API 与 MCP 接入使用场景你想把下载能力嵌进自己的脚本或 AI 助手里而不是手动点。怎么操作先用python main.py token生成一个鉴权令牌长期有效别外传再启动对应服务python main.py api # REST 接口访问 /docs 有交互式文档 python main.py mcp # MCP 服务可接入支持 MCP 的 AI 工具然后 POST/xhs/detail请求体里带上作品链接和download: true请求头加Authorization: Bearer 你的令牌data {url: 作品链接, download: True} headers {Authorization: Bearer 你的鉴权令牌} response post(http://127.0.0.1:5556/xhs/detail, jsondata, headersheaders, timeout10)注意点API 和 MCP 模式都要带令牌缺失或无效会返回 403Docker 下跑 API/MCP 时命令行调用和剪贴板功能是没的属正常现象。如果你是做二次开发仓库根目录的 example.py 给了一段带注释的最小调用改改参数就能跑核心源码都在 source/。方案对比为什么选本地下载器同样想把小红书内容存下来路不止一条差别在你平时最关心的几件事上你关心的XHS-Downloader浏览器插件付费云服务钱免费部分功能收费按量/订阅收费上手中低GUI/命令行/Docker 都有低装脚本即用低网页点几下数据归谁全在你本机以本地为主先传到第三方服务器无水印原生支持看具体插件常带水印可定制性高能改代码/接接口低基本没有隐私不上传文件依赖浏览器权限数据离开电脑手工另存为那档就更别提了——水印、画质、效率全输。所以当你既要批量又要干净文件、还不想把东西交给别人时本地方案是少数几个选项里最稳的。避坑指南这些情况你大概率会撞上⚠️ 下面几条是真实高频问题对照着看能少绕很多弯路。你可能遇到视频存下来很糊这时应该去补一份完整的 Cookie里面要含web_session字段只缺 Cookie 是画质上不去最常见的原因。你可能遇到请求被限流、速度忽快忽慢这时应该保持默认的请求延时程序内置约 6 秒间隔别为了快把间隔压没那样更容易触发风控。你可能遇到明明没存过却被跳过下载这时应该知道下载记录是默认开启的想重下就得先删掉数据库里对应的作品 ID。你可能遇到旧链接突然下不动这时应该换最新获取的链接——作品链接里带日期信息太老的链接容易被风控。你可能看到脚本里有自动滚动页面想打开这时应该先停手它有被判自动化、连累账号的风险默认关闭是有原因的。最后XHS-Downloader 把提取链接、去水印、批量下载、接接口这几件事收进了一个免费开源的本地工具里GUI 看着顺手、命令行跑得快、API 留给想折腾的人。装好、贴上链接、存下干净的文件就是你今天能走通的最短路径。项目说明与完整参数表README.md二次开发最小示例example.py核心源码source/依赖清单requirements.txt获取代码git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考