XHS-Downloader小红书作品批量下载工具【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-DownloaderXHS-Downloader 是一款开源的小红书作品下载工具粘贴作品链接即可批量保存图文、视频与动态图片提供图形界面、命令行、API 与 MCP 四种形态适合个人用户与开发者。 核心能力四类作品内容都能以原始文件形式保存到本地。它把图文作品的全部图片按 JPEG、WEBP、PNG、HEIC 等格式写入本地把视频作品按分辨率、码率或文件大小三种偏好下载并可选保存封面文件livePhoto 动图默认不下载打开设置中的 live_download 开关后即可保留动态效果。已下载过的作品会记录 ID 并自动跳过同一链接重复提交不会重复下载文件命名支持按作者、发布时间等字段自定义。⚡ 快速开始从 clone 到启动图形界面共 4 条命令。需要 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启动后进入图形界面作品文件默认保存在项目根目录的 Volume/Download 文件夹首次运行会自动生成 Volume/settings.json 配置文件。 功能详解4 个操作目标覆盖日常下载需求。界面批量下载一次粘贴多个链接主界面的输入框接受空格分隔的多个作品链接程序自动从分享文案中提取有效链接并逐个下载支持 explore、discovery/item 与 xhslink 分享短链三种格式读取剪贴板按钮省去手动粘贴日志区显示每个文件的下载进度重复链接由下载记录机制自动跳过。命令行下载按序号挑选图片不带序号参数时--url 支持引号包围、空格分隔的多个链接追加--index则只保存指定序号的图片且此时仅处理第一个链接。下面这条命令只保存图文作品中的第 2 张和第 4 张图片python main.py --url https://www.xiaohongshu.com/explore/作品ID --index 2 4其余参数--cookie、--proxy 等运行 -h 可查完整表格。配置 Cookie 获取高清视频未配置 Cookie 时平台对访客默认返回低清视频。处理分 3 步浏览器打开任意小红书页面按 F12 进入网络面板并刷新复制请求头中的 Cookie 值再填入设置界面的 cookie 参数全程不需要登录账号。监听剪贴板复制链接自动下载在剪贴板模式面板点击开启监听程序会持续检测剪贴板内容发现作品链接后自动创建下载任务队列面板显示每个任务的状态点击关闭监听即可随时停止。⚙️ 进阶用法接入脚本或 AI 客户端时项目提供 3 种服务化形态。API 模式默认监听 5556 端口python main.py api向 /xhs/detail 发 POST 请求传 url、download、index 参数即可取回作品数据或触发下载请求头需携带启动时输出的 Bearer 令牌交互式文档见 /docs 页面。MCP 模式先安装 fastmcp 依赖python main.py mcp在 AI 客户端把 Streamable HTTP 地址填为 http://127.0.0.1:5556/mcp 并附加鉴权令牌即可用对话指令触发下载。Tampermonkey 导入 static/XHS-Downloader.js 后可提取账号发布、收藏、点赞、专辑的作品链接自动滚动默认关闭配置 script_server 为 true 时脚本还能把下载任务推送给后台程序。二次开发参考 example.py核心逻辑在 source/application/ 目录。常见问题以下 4 个问题对应使用中最常见的异常。为什么未配置 Cookie 只能下载低清视频访客身份默认只能获得低分辨率资源。按配置 Cookie 一节的步骤复制网页 Cookie 填入程序设置无需登录账号即可获取高清版本。同一个作品重复提交会重新下载吗下载记录默认开启已下载的作品 ID 写入 Volume/ExploreID.db 数据库重复提交自动跳过。需要重新下载时先删除数据库中的对应记录再提交。作品链接报错或触发风控怎么办链接携带日期信息较早获取的链接容易被风控拦截。重新复制一份最新链接再提交通常即可恢复。Linux 下读取剪贴板没有反应剪贴板功能依赖 xclip 或 xsel 命令安装其中之一即可恢复Docker 模式则不支持剪贴板读取与监听粘贴链接下载不受影响。完整参数说明、配置项清单与用户脚本教程详见项目根目录的 README.md。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
