XHS-Downloader 完整教程：快速上手小红书无水印作品下载

XHS-Downloader 完整教程快速上手小红书无水印作品下载【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader你一定遇到过这个卡点想保存小红书上的作品存下来的图片带着一层水印视频只能拿到低清版作品一多更得手动一个个复制链接。XHS-Downloader 就是为了解决这个问题而生的——它是一个小红书作品采集工具粘贴作品链接后直接下载无水印的图片和视频原文件已下载过的作品还会自动跳过。它到底能帮你做什么一句话定位把小红书作品链接变成落在你硬盘上的无水印文件顺带把作品数据也存下来。如果你是做内容的创作者它会帮你把作品链接变成无水印高清图/视频图文作品还能按图片序号挑着下载如果你是素材库管理者它会把每个作品存进单独文件夹、按作者归类、文件名按模板生成找素材不靠翻如果你在做数据采集它能把点赞、收藏、评论、作品标签这些信息存进本地 SQLite 或文本文件如果你在搭自己的工作流它提供 API 和 MCP 两种服务接口浏览器端还有配套用户脚本可以直接推送下载任务。看完定位下一步去三条路径里选一条先把程序跑起来。三条路径选一条进门路径一 · 读得懂直接运行可执行程序适合只想下载作品、不想碰代码的用户。 从 Releases 下载对应系统macOS、Windows 10 及以上的压缩包解压后双击运行main即可。文件默认保存在Volume\Download配置文件是Volume\settings.json。 macOS 首次运行被系统拦截时在终端执行一次xattr -cr 项目文件夹路径路径二 · 改得动源码运行适合要自定义参数、做二次开发或参与开发的开发者。需要先装 Python 3.12 及以上版本git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev uv run main.py不带参数启动的是图形界面带参数如-u进入命令行模式。路径三 · 跑得起Docker 容器适合服务器环境或要常驻 API / MCP 服务的人。docker pull joeanamier/xhs-downloader docker run --name xhs -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader在命令末尾追加python main.py api或python main.py mcp可以分别以 API、MCP 模式启动。注意Docker 下不支持命令行参数模式和剪贴板功能只能直接粘贴内容。三条路径里Cookie 都不是必填项但下载异常时它往往是第一嫌疑后面排查一节会讲怎么拿到。跑起来之后按需取用下面的能力。核心能力按需取用无水印下载一条命令拿到原文件解决什么水印和低清视频。它拿的是平台原始文件视频还能在分辨率、码率、文件大小三种偏好里选优先级--video_preference默认resolution。最直接的一招uv run main.py --url https://www.xiaohongshu.com/explore/作品ID?xsec_tokenXXX图文作品想换格式就加--image_format WEBP支持 PNG、WEBP、JPEG、HEIC、AUTO。适合谁所有人这是使用频率最高的功能。批量链接一串链接粘进去按顺序处理解决什么作品多时一个个复制链接的麻烦。支持一次输入多个作品链接用空格分隔xhslink.com短链接也认程序会自动从中提取有效作品链接无需预处理。最直接的一招uv run main.py --url 链接1 链接2 链接3适合谁一次要处理一批作品的人。整理下载文件夹、文件名、去重一次配齐解决什么文件散乱、命名混乱、重复下载三件事。最直接的一招uv run main.py --url 链接1 链接2 --folder_mode true --author_archive true--folder_mode true让每个作品独占一个文件夹--author_archive true按作者ID_作者昵称归组--name_format控制文件名字段用空格分隔如发布时间 作者昵称 作品标题。另外download_record默认开启已下载过的作品会自动跳过重复跑命令不会产生重复文件。适合谁准备长期沉淀素材库的人。留存数据只采集信息不下载文件解决什么你想要的是点赞、收藏、评论数、作品标签这些数据而不是文件本身。最直接的一招加--record_data true作品数据会写入本地 SQLite默认Volume/Download/ExploreData.db再加--note_format md每个作品的信息额外存一份 Markdown。适合谁做竞品分析、内容研究的人。浏览器用户脚本页面上直接提取链接解决什么在小红书网页上刷到一批好内容时手动复制链接太慢。最直接的一招安装 Tampermonkey 扩展导入仓库里的 static/XHS-Downloader.js 脚本之后在页面脚本菜单里就能提取推荐流、发布、收藏、点赞、搜索结果的作品链接把配置文件里script_server设为true并保持程序在后台运行还能把推送下载任务直接发给本地程序。适合谁大量时间泡在小红书网页版的人。提醒一句脚本的自动滚动页面功能默认关闭开启后可能被平台判定为自动化操作有账号风控风险别轻易开。API / MCP把它变成能被调用的服务解决什么你写的程序或 AI 助手想直接触发下载、获取作品数据。最直接的一招uv run main.py api # 启动 API 服务默认端口 5556 uv run main.py mcp # 启动 MCP 服务需先安装 fastmcp4.1.0API 文档自动生成在http://127.0.0.1:5556/docs接口调用要在请求头带Authorization: Bearer 令牌令牌用uv run main.py token生成与Volume/auth_secret.key绑定别公开。适合谁需要把下载能力接进自己系统的开发者。跟着走一个真实任务任务批量下载 3 个作品每个作品单独建文件夹、按作者归类并保存作品信息。第 1 步拿到链接。在浏览器里或用用户脚本把 3 个作品链接复制到一段文字里中间用空格隔开。第 2 步运行下载命令。在项目根目录执行uv run main.py --url 链接1 链接2 链接3 --folder_mode true --author_archive true --note_format md--folder_mode true让每个作品独占文件夹--author_archive true按作者归类--note_format md把每个作品的标题、描述、互动数据存成 Markdown。第 3 步确认落盘位置。默认在Volume/Download下按作者ID_作者昵称分文件夹存放想换位置就加--work_path D:\素材Windows或--work_path ./downloads。第 4 步可选只挑部分图片。某个图文作品只想要第 1、3 张时uv run main.py --url 该作品链接 --index 1 3注意设置--index后只处理第一个链接。命令行支持的全部参数用uv run main.py --help查看效果如下跑完这一遍文件应该在指定文件夹里了。如果只有个别作品没下载下来别慌对照下一节排查。把参数调得更顺手所有参数都在Volume/settings.json首次运行自动生成里命令行参数也能用--update_settings直接写回配置文件。大多数人只会动下面这几个参数作用建议值cookie小红书网页版 Cookie没配时视频只能拿到低分辨率按下面步骤获取一份填进去work_path作品保存根路径指定一个固定磁盘的绝对路径image_format图文下载格式WEBP体积小或默认的JPEGfolder_mode每个作品单独文件夹批量下载时设trueauthor_archive按作者分文件夹建素材库时设truename_format文件名模板字段空格分隔默认发布时间 作者昵称 作品标题够用video_preference视频偏好resolution/bitrate/size默认resolutionmax_retry/timeout失败重试次数 / 请求超时秒默认 5 次 / 10 秒网络差时调大download_record跳过已下载作品保持默认的trueCookie 的获取方式打开小红书网页版登录与否都行→ 按F12打开开发者工具 → 切到网络选项卡 → 过滤框输入cookie-name:web_session→ 点击任意作品 → 选中一个数据包全选复制 Cookie 后填入程序或配置文件其余参数avg_delay、proxy、chunk、impersonate等完整说明见 README.md 的配置文件章节不常用的不用碰。参数调顺之后如果哪里不对劲直接进排查环节。卡住了对照排查现象大概率原因一招解决视频只有低分辨率或个别作品下载失败没配 Cookie或 Cookie 过期按上文重新复制一份 Cookie 填进配置批量下载时部分作品被跳过download_record开启作品已在下载记录里这是防重复的正常行为确要重下时删除Volume/ExploreID.db中对应作品 ID或临时把download_record设为false老链接请求被拒作品链接自带日期信息时间过久的链接会被风控重新复制一份最新的作品链接再下载启动即报错、依赖安装失败Python 版本低于 3.12或依赖没装全确认python --version≥ 3.12重新执行uv sync --no-dev四个都排过了还不行带上你的系统和报错信息去仓库提 Issue比瞎试快。用得安心也守得住分寸几条提醒都是帮你少惹麻烦用途边界下载的内容用于个人学习、研究和备份自己的作品即可未经作者许可不要二次传播或商用。请求频率程序内置了请求延时avg_delay默认 6 秒不要刻意把它压到 0 去提速用户脚本的自动滚动功能默认关闭也是同样的原因——自动化操作会带来账号风控风险。凭证保管Cookie 约等于你的账号凭证API/MCP 令牌默认永久有效都不要分享给别人不用了就去掉。灰色地带别碰批量抓取、账号相关灰色业务风险自负项目作者不为这些行为背书。用得稳妥了如果你顺手还可以让这个项目变得更好一点。让这个项目更好一点发现问题、有需求直接在仓库提 Issue把现象、环境、日志写清楚即可。想改代码Fork 后基于develop分支开发提交 PR 时保持提交信息格式类型: 简短描述不确定的方向先提 Issue 和作者对齐避免重复劳动。想帮文档、翻译同样直接提 PR项目本身就欢迎这类贡献。想基于它做二次开发先看仓库里的 example.py参数和调用方式都有注释。下次再看到想存下来的作品不用再对着水印截图发愁——复制链接敲下那条命令无水印原文件就会安静地躺在你的素材文件夹里。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考