XHS-Downloader 小红书无水印下载完整指南3条命令批量采集图文视频【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader晚上刷到一组无水印素材想存下来做参考却只能对着屏幕截图。XHS-Downloader 把小红书作品链接直接变成无水印原图和视频文件支持批量下载、下载记录去重、API 服务器和 MCP 服务器四种入口还配了一个浏览器用户脚本复制、粘贴、开跑10 分钟之内你就能拿到第一个文件。 3条命令跑通XHS-Downloader 小红书无水印下载git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev uv run main.py最后一步会打开图形界面。把作品链接贴进输入框回车文件开始下载。支持这几种链接直接复制就行https://www.xiaohongshu.com/explore/作品IDhttps://www.xiaohongshu.com/discovery/item/作品IDhttps://www.xiaohongshu.com/user/profile/作者ID/作品IDhttps://xhslink.com/分享码链接一次贴多条用空格隔开程序自己挑出有效的。XHS-Downloader 能批量采集什么内容做什么贴一个作品链接。得到什么原图加视频文件落进本地文件夹。做什么命令行加--index 1 3 5。得到什么图集里只下第 1、3、5 张图。做什么界面里按M开启剪贴板监听。得到什么往剪贴板里一粘链接后台自动下不用开窗口。做什么用 API 模式请求/xhs/detail。得到什么文件下载外加点赞、收藏、评论数、作者和标签一次拿全。做什么装 Tampermonkey 用户脚本。得到什么在小红书页面一键提取整页作品链接再喂给程序批量下。三类用户的最小上手路径普通用户不装环境双击运行Windows 和 macOS 用户去仓库 Releases 页面下载压缩包解压双击main。文件默认存在_internal\Volume\Download配置在_internal\Volume\settings.json。批量用户命令行一次下多个uv run main.py --url 链接1 链接2 链接3注意--index和--url同时出现时只处理第一条链接。想批量挑图就分多次跑。开发者API 服务器接进你的系统uv run main.py api然后 POSThttp://127.0.0.1:5556/xhs/detailJSON 传url、download、index三个参数响应就是作品数据。文档页在http://127.0.0.1:5556/docs参数说明直接看。跑起来之后必做的 2 个配置Cookie 不配会踩什么坑把浏览器开发者工具里带web_session、a1的 Cookie 写进settings.json的cookie字段。这步别跳不配 Cookie视频只给低清档配了能拿到更高画质也不需要登录账号。工作目录不定会踩什么坑settings.json里设work_path下载的文件和ExploreID.db记录都放在它下面。不定的话文件全堆在项目根目录的Volume里覆盖升级时容易把旧文件冲掉。 XHS-Downloader 高频故障排查手册症状视频下下来是低清。根因Cookie 没配或过期了。解法重新抓一次 Cookie 写回配置文件。症状同一个作品再下载直接跳过。根因下载记录开关默认开着作品 ID 已经记进Volume/ExploreID.db。解法删掉数据库里对应记录或设download_record为 false。症状链接能打开程序却报获取失败。根因xsec_token带日期旧链接会被风控拦下。解法重新复制一份最新链接再下。症状macOS 双击main被拦截。根因可执行文件没有代码签名。解法终端跑一次xattr -cr 项目文件夹路径。原理速览XHS-Downloader 工作原理与目录结构链接里藏着作品 ID程序先提取 ID再用 httpx 带 Cookie 请求页面数据从返回里拆出原图、视频的真实地址然后分块下载支持断点续传。图片格式不是改出来的是用 token 拼 CDN 地址、带上格式参数实现的所以能直接拿到 WEBP、JPEG、HEIC。下载记录存在 SQLite 里重复的作品 ID 直接跳过。main.py source/application/app.py # 工作流编排extract() 是主入口 source/application/explore.py # 页面数据解析 source/application/download.py # 分块下载与断点续传 Volume/settings.json # 配置文件首次运行自动生成 static/XHS-Downloader.js # Tampermonkey 用户脚本适合谁用XHS-Downloader 仓库地址与合规提醒适合要批量采集小红书素材的个人用户也适合把内容采集接进自己系统的开发者。仓库地址https://gitcode.com/gh_mirrors/xh/XHS-Downloader请遵守法律法规和平台规定尊重原创版权仅供个人学习与研究勿用于商业爬取。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考