企业官网建设流程全解析

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/作品ID
• https://www.xiaohongshu.com/discovery/item/作品ID
• https://www.xiaohongshu.com/user/profile/作者ID/作品ID
• https://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/detail，JSON 传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