5 分钟装好 XHS-Downloader小红书无水印下载与批量归档的 5 个实操场景【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-DownloaderXHS-Downloader 是一个小红书XiaoHongShu、RedNote链接提取与作品采集工具能按你提供的作品链接批量做无水印下载支持图文、视频和 livePhoto解决手动保存慢、画质被压缩、批量整理靠人肉复制的三个常见痛点。能力速览10 秒判断它适不适合你维度说明采集对象图文笔记、视频笔记、livePhoto 动图、视频封面能做什么多链接一次性无水印下载、按序号挑图如只要第 1、3、5 张、指定图片格式PNG / WEBP / JPEG / HEIC、按作者或按作品分文件夹归档、断点续传、自动跳过已下载作品做不到什么不能输入关键词搜索全站、不自动登录账号抓取、不提供任何破解功能作品链接必须来自你自己复制或来自配套用户脚本的批量提取前置条件Python ≥ 3.12Cookie 非必需但视频作品不配 Cookie 只能拿到低分辨率文件批量场景建议配合 Tampermonkey 用户脚本提取链接结论很简单如果你手里有明确的作品链接、需要原画质文件且量级在几十条以上它值得装如果只是偶尔存一张图系统自带保存就够了。最快上手装环境、跑起来、看到第一个文件git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev以上两条命令完成克隆和依赖安装uv sync --no-dev会读取pyproject.toml并创建独立虚拟环境。uv run main.py不带参数启动时程序默认进入 TUI 文字界面粘贴一条作品链接、按「下载作品文件」即可Mac / Windows 10 以上用户也可以直接下载 Release 里的编译包解压后运行main下载文件默认落在Volume\Download文件夹。若不想装 Pythondocker pull joeanamier/xhs-downloader拉取官方镜像同样能跑API、MCP 模式都有对应的docker run命令。首条作品下载成功后去Volume/Download目录核对文件名与图片内容就算完成了最小可运行路径。场景一单条作品保存——3 步拿到无水印原文件目标把一条图文或视频笔记存到本地且不带平台水印。操作步骤在小红书 App 或网页端复制作品链接explore/、discovery/item/、user/profile/路径以及xhslink.com短链都能识别粘贴进输入框多个链接用空格或换行分隔后点击处理程序会自动提取有效部分无需手动清理 URL 参数到Volume/Download目录查看结果默认按「发布时间 作者昵称 作品标题」命名。结果验证打开文件属性对比分辨率应与网页展示的原图一致且文件内不含水印区域视频文件即为服务器端原始 mp4。这一场景没有任何额外配置是整个工具的使用下限。场景二整账号批量归档——用户脚本替你复制几百个链接目标把某位博主「发布 / 收藏 / 点赞 / 专辑」里的作品一次性搬进本地文件夹不再逐条复制。操作步骤在浏览器安装 Tampermonkey通过「从 URL 安装」方式装入仓库static/XHS-Downloader.js对应的用户脚本脚本安装方式见 README 用户脚本章节打开目标账号主页点击页面右下角脚本书签选择「提取发布作品链接」等菜单项勾选作品后点击「提取链接」结果自动写入剪贴板把链接粘贴进 XHS-Downloader 输入框批量处理或在脚本设置面板里直接调整图片下载格式、文件命名规则、自动滚动次数默认 50 次。结果验证下载目录中每个文件以「发布时间_作者昵称_作品标题」形式排列重复作品会自动跳过不产生冗余副本。归档建议开启author_archive每个作者独立文件夹或folder_mode每篇作品独立文件夹之一如果连「复制-粘贴」这一步也想省掉把配置里的script_server设为true并填入鉴权令牌浏览器里点「推送下载任务」脚本会把任务直接发给后台程序。场景三解锁高清视频——Cookie 获取的 5 个步骤目标让视频作品从低分辨率版本切换到更高清晰度。原因未配置 Cookie 时视频只能拿到低分辨率文件Cookie 是网页版请求凭据不需要登录账号浏览器访问过小红书就会带。操作步骤无痕模式打开xiaohongshu.com/explore页面按F12打开开发者工具切到「网络」标签勾选「保留日志」过滤框输入cookie-name:web_session再点选Fetch/XHR筛选器点击页面上任意一个作品在下方面板选中任意一条请求在「标头」里找到Cookie字段全选复制粘贴进程序的 Cookie 设置GUI 的「程序设置」页或Volume/settings.json的cookie字段保存后重新提交下载。结果验证对同一条视频重新提交任务对比新文件的分辨率与文件大小应明显高于之前未配 Cookie 的版本。命令行用户可以用python main.py -u 链接 -ck Cookie内容 -us直接运行-us会把本次参数顺带写回配置文件一次设置长期生效。场景四只下第 3、5、7 张图——按序号精确挑图目标一篇 20 张图的图集里只要 3 张而不是整篇全下。操作步骤命令行执行python main.py -u 作品链接 --index 1 3 5仅对图文/图集作品生效注意约束设置了--index时只能传一个作品链接传多个只处理第一个想改输出格式时追加--image_format webp可选值PNG、WEBP、JPEG、HEIC、AUTOAUTO表示跟随服务器响应。结果验证Volume/Download目录里应恰好出现 3 个图片文件其余序号不产生任何文件。这个参数在 GUI 的「图片序号」输入框同样可用MCP 调用时也能用index字段实现同样效果三种入口行为一致。开发者接入CLI、API 与 MCP 的最短示例命令行全量参数执行python main.py -h可看到完整参数表--cookie、--proxy、--video_preferenceresolution/bitrate/size、--folder_mode、--author_archive、--name_format均支持直接覆盖配置适合写进自动化脚本。API 模式python main.py token生成鉴权令牌python main.py api启动服务访问http://127.0.0.1:5556/docs打开自动生成的接口文档所有请求需在请求头携带Authorization: Bearer 令牌缺失或令牌无效时返回 403。{url: https://www.xiaohongshu.com/explore/作品ID?xsec_tokenXXX, download: true, index: [3, 6, 9]}上面是POST /xhs/detail的最小请求体url必填download控制是否落盘文件index指定图片序号只传url则可纯粹用于抓取作品结构化数据。MCP 模式源码运行需先装扩展依赖uv sync --no-dev --extra mcp然后执行python main.py mcp启动服务客户端按 Streamable HTTP 方式接入{mcpServers: {XHS-Downloader: {url: http://127.0.0.1:5556/mcp, headers: {Authorization: Bearer 鉴权令牌}}}}配置完成后可直接对助手说「获取这个作品的信息」或「下载第 2 张图片」工具会自动调用。常见问题与排错现象下载失败或返回异常提示链接无效。 原因作品链接携带日期信息保存过久的链接可能已被平台风控。 解法批量下载前用用户脚本重新提取一遍最新链接README「其他说明」里也建议始终使用最新获取的链接。现象同一作品第二次提交时被直接跳过即使本地文件已删除。 原因download_record默认开启程序会把下载成功的作品 ID 写入Volume/ExploreID.db存在记录即跳过。 解法在 GUI 的「下载记录」页面删除对应记录或把download_record设为false后程序改为检查文件是否存在来决定是否跳过。现象用户脚本触发的下载任务失败主程序下载却正常。 原因全局代理工具可能干扰脚本的网络请求。 解法先关闭系统级代理重试程序本身的代理需求写在settings.json的proxy参数两者互不影响。现象Linux 下「读取剪贴板」按钮无反应。 原因剪贴板功能依赖xclip或xsel命令行工具。 解法执行sudo apt-get install xclip安装后重启程序。现象批量任务跑得太快后被限流。 原因程序内置请求延时机制avg_delay默认 6.0 秒硬调小容易触发平台风控。 解法保持默认值大批量任务让它自己排队。适用人群与合规底线适合引入这套方案的人经常保存小红书图文与视频素材做学习笔记、剪辑素材库的创作者需要按作者/作品结构化归档的收藏者以及想把采集流程接进自有工作流API 或 MCP的开发者。不必引入的情况每月只存几张图——系统自带保存即可期望「输入关键词自动全站抓取」——它不做搜索引擎链接必须来自你或脚本只需要作品文字信息、不要文件——直接调 API 的downloadfalse更轻量。最后是合规底线本项目遵循 GPL v3.0 协议二次分发需遵守相应条款下载的内容请仅用于个人学习与研究尊重原作者版权不要商用或二次传播。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
