XHS-Downloader 小红书无水印下载完整指南从单篇保存到批量归档与 API/MCP 接入【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-DownloaderXHS-Downloader 是一款开源的小红书RedNote作品采集工具输入作品链接后它解析页面接口、提取服务器端的原始媒体直链把图文与视频以无水印、原画质状态批量保存到本地。本文按基础使用 → 批量归档 → 进阶接入的阶梯组织内容覆盖安装部署、Cookie 高清解锁、用户脚本捞链接、命令行精细控制、API 与 MCP 服务接入以及常见问题的处理方法可作为一份完整的使用手册。一、能力总览XHS-Downloader 能做什么程序侧提供的核心能力包括作品信息采集获取作品详情并提取媒体文件的下载地址文件下载图文、视频、视频封面、livePhoto 动图支持断点续传与文件完整性校验格式控制图文文件可指定输出格式视频可按清晰度偏好挑选归档组织每作品独立文件夹、按作者归档、自定义命名规则、文件修改时间同步为发布时间去重机制自动跳过已下载过的作品多入口图形界面GUI、终端界面TUI、命令行CLI、API 服务、MCP 服务浏览器联动配合 Tampermonkey 用户脚本一键推送下载任务链接的批量来源则由配套的用户脚本覆盖可从以下位置提取作品链接来源位置说明账号发布某作者的全部已发布作品账号收藏收藏夹内的作品账号点赞点赞列表中的作品账号专辑合集/专辑内的作品推荐页首页信息流中加载到的作品搜索结果关键词搜索出的作品与用户无水印的底层逻辑网页端展示的图片与视频是经过平台二次加工的版本分辨率被压缩、部分素材叠加了水印。XHS-Downloader 的做法是直接向小红书网页接口发起请求拿到作品对应的服务器原始文件地址下载动作针对的是未经加工的源文件因此画质可以完整保留文件上也不带水印。一个需要提前知道的前提条件⚠️未配置 Cookie 时视频作品只能拿到低分辨率版本。在设置中填入一个网页版 Cookie 即可解锁高清视频文件且该 Cookie无需登录账号即可获得获取步骤见下文。二、安装部署三种方式跑起 XHS-Downloader方式一源码 uv推荐Python 3.12 及以上环境要求只有一个Python 版本不低于 3.12。依次执行git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev安装完成后启动uv run main.py方式二Releases 打包版免环境macOS 与 Windows 10 及以上用户可直接从项目 Releases 页下载压缩包解压后运行main即可。该方式下文件默认保存到Volume/Download配置文件为Volume/settings.json首次运行自动生成改完参数重启程序生效macOS 用户必读macOS 平台的main可执行文件未经代码签名首次启动前需在终端解除系统安全标记否则会被拦截xattr -cr 项目文件夹路径执行一次后即可正常运行。三、基础使用保存单篇作品与高清解锁启动程序后将作品链接粘贴进输入框并触发下载即完成单篇保存。程序支持一次输入多个链接链接之间用空格分隔、整体加引号会自动识别其中的有效链接。以下链接格式均被支持https://www.xiaohongshu.com/explore/作品ID?xsec_tokenXXXhttps://www.xiaohongshu.com/discovery/item/作品ID?xsec_tokenXXXhttps://www.xiaohongshu.com/user/profile/作者ID/作品ID?xsec_tokenXXXhttps://xhslink.com/分享码高清视频解锁Cookie 配置步骤Cookie 配置是非强制项但对视频画质影响很大。整个流程约一分钟用浏览器可开无痕窗口访问小红书explore页面登录账号可跳过按F12打开开发者工具切到网络选项卡勾选保留日志在过滤框输入cookie-name:web_session并选择 Fetch/XHR 筛选器点击页面上任意作品在网络面板选中一个数据包全选复制该请求的 Cookie 字段粘贴进程序的 Cookie 设置或settings.json的cookie参数四、批量归档用用户脚本整体保存作品集把一位作者的全部作品存到本地手动逐条复制链接不现实此时使用配套的 Tampermonkey 用户脚本源码文件位于 static/XHS-Downloader.js。安装脚本并提取链接在浏览器安装 Tampermonkey 扩展后添加脚本安装流程如下图所示脚本菜单中可提取的链接来源覆盖前文表格所列全部位置账号发布、收藏、点赞、专辑、推荐页以及搜索结果中的作品链接与用户链接。脚本支持自动滚动页面以加载更多作品默认滚动 50 次次数可修改。注意该功能默认处于关闭状态需要手动开启自动滚动行为可能被平台识别为自动化操作建议按需启用。提取完成后将链接列表复制粘贴进程序即可排队下载。免复制粘贴脚本直推下载任务配置文件中把script_server设为true后程序在后台充当任务服务器TUI、MCP、API 模式下均生效。浏览器访问任意作品页时点击脚本菜单的推送下载任务任务直接发给主程序处理全程无需复制粘贴。首次配置或更换令牌时需在脚本设置中填写鉴权令牌通过python main.py token生成。五、命令行模式精确指定图片序号与格式图形界面适合日常操作命令行则擅长精细控制例如只要这篇图文里的第 1、3、5 张。# 下载单篇作品 python main.py -u 作品链接 # 只下载指定序号的图片仅对图文作品生效 python main.py -u 作品链接 --index 1 3 5 # 指定图文输出格式 python main.py -u 作品链接 --image_format webp # 多个链接一次提交空格分隔整体加引号 python main.py -u 链接1 链接2 链接3注意设置--index时程序只处理第一个链接未设置时支持多链接批量。完整参数列表随时可以查看python main.py --help常用参数速查命令行 / settings.json 对照参数含义-u/--url作品链接多个链接用空格分隔--index指定要下载的图片序号仅图文作品有效--image_format图文格式AUTO/PNG/WEBP/JPEG/HEIC--video_preference视频偏好resolution分辨率优先 /bitrate码率优先 /size体积优先--live_download是否下载 livePhoto 动图文件--folder_mode每个作品的文件单独存放一个文件夹--author_archive按作者分文件夹归档作者ID_作者昵称--name_format自定义文件命名规则--work_path自定义保存根路径--cookie以命令行方式传入 Cookie配置文件中另有download_record下载记录开关默认开启、note_format作品信息另存为 txt/md等选项参数详情见 README 配置文件章节。六、进阶接入API 模式与 MCP 模式需要把下载能力嵌入自有流程时项目提供两种服务化入口均默认监听127.0.0.1:5556。API 模式python main.py api启动后访问http://127.0.0.1:5556/docs可见自动生成的交互式接口文档。核心接口为路径POST /xhs/detail参数url作品链接必需、download是否下载文件、index图片序号列表鉴权请求头携带Authorization: Bearer 令牌令牌在模式启动时输出/docs页面右上角 Authorize 处填入即可调试调用示例见 example.py。MCP 模式python main.py mcp在支持 MCP 的客户端中配置服务地址http://127.0.0.1:5556/mcpStreamable HTTP 方式请求头需携带 Bearer 令牌之后即可用自然语言下达指令例如获取某作品的数据或下载某作品的第 1、3 张图。七、常见问题排查Q1视频下载出来是低清晰度未配置 Cookie 的必然结果。按上文步骤填入一个网页版 Cookie无需登录账号即可获取高清视频文件。Q2第二次下载同一作品没有任何反应这是设计行为而非故障。程序默认开启下载记录已下载的作品会被自动跳过以避免重复存储。想强制重下删除Volume/ExploreID.db中对应的作品 ID或在配置中关闭download_record关闭后程序改为检查文件是否已存在来决定跳过。Q3用户脚本下载文件总是失败先检查是否开启了全局代理工具。代理经常干扰脚本发出的下载请求关闭代理后重试通常即可恢复。Q4Linux 下读取剪贴板功能不生效剪贴板功能依赖xclip或xsel需要先安装其中之一例如sudo apt-get install xclip。Q5把请求间隔调小一点会不会更快不建议。程序内置请求延时机制avg_delay默认 6 秒刻意加快请求频率容易触发平台风控默认值是最稳妥的档位。另一个容易踩的坑作品链接要新鲜。链接中带有日期信息存放时间过久的链接可能被风控拦截。批量下载前重新提取一遍链接是最稳妥的做法。八、写在最后XHS-Downloader 覆盖了单篇保存、批量归档、脚本化调用三档需求图形界面、命令行、API、MCP 四种入口加浏览器脚本联动可适配从偶尔存图到工作流自动化的不同使用强度。最后需要说明本文及所下载的内容仅适用于个人学习与研究场景。请尊重原创作者的版权避免将下载内容用于商业用途或二次传播工具提供便利使用边界需要使用者自行把握。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
