企业官网建设流程全解析

10分钟上手 XHS-Downloader：小红书作品批量无水印下载指南

【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader

想把小红书上一组笔记图无水印存下来，你多半试过右键另存为、手机截图，结果不是带水印就是画质糊——这正是XHS-Downloader这款免费的小红书作品批量下载器要解决的。它把作品链接变成干净的图片、视频和作品数据，全程在你自己的电脑上完成，不上传任何文件。

先搞清楚：XHS-Downloader 能替你做什么

在往下走之前，先用一张卡判断它是不是你要找的东西：

它同时覆盖图文、视频、封面和动态图（livePhoto），还内置了"下载记录"，你重复丢同一批链接进去，它会自动跳过已经存过的，不会反复占空间。

快速上手：10分钟内跑通第一次下载

你只需要 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

最后一步会直接弹出图形界面，左侧是任务队列、剪贴板模式、下载记录等入口，你往输入框贴链接就能跑。如果你更习惯传统 pip，也可以建个虚拟环境后执行pip install -r requirements.txt，再用python main.py启动。

不想装 Python？项目也提供了 Docker 镜像和 Mac/Windows 的可执行压缩包，解压双击main就能用，文件默认存到.\Volume\Download。

命令行党可以直接用参数式调用，一次丢进多条链接、空格分隔：

python main.py -u "作品链接1 作品链接2 作品链接3" -fm true -aa true

这条命令的意思是：批量下载这些作品，每个作品单独建文件夹（-fm），再按作者归档到各自目录（-aa）。完整的参数表可以运行python main.py -h查看。

核心能力拆解：从单条到批量

批量下载：一次粘贴多条作品链接

使用场景：你收藏了一整列笔记，想一次收进本地，不想一个个点。怎么操作：在 GUI 输入框或命令行-u参数里粘贴多条链接（空格分隔），程序会自动识别出有效链接，支持explore、discovery/item、user/profile以及xhslink.com分享码这几种形式。注意点：设了--index（只下指定序号图片）时，就只处理第一条链接了；想批量就别带这个参数。

无水印高清：Cookie 决定画质

使用场景：你发现视频存下来总是糊的，图片也想拿原图。怎么操作：在配置里填入小红书网页版 Cookie（无需登录），程序就能拿到更高分辨率的视频源，并用--image_format指定图片保存为 PNG、WEBP、JPEG、HEIC 或 AUTO。注意点：Cookie 不是强制项，但未配置时视频只能下到低分辨率；图片格式里 HEIC 部分作品没有，会退回成 WEBP。

用户脚本：让浏览器帮你收集链接

使用场景：链接一条条复制太累，尤其面对一整页作品时。怎么操作：浏览器装好 Tampermonkey 后引入项目自带的用户脚本，它能在作品页弹出"选择要下载的图片"面板，也能提取推荐、发布、收藏、点赞、专辑和搜索结果里的链接；开启服务器模式后，点"推送下载任务"就能把活交给后台的主程序干。

注意点：脚本里那个"自动滚动页面"默认是关的，手动开启有被判定为自动化操作、触发风控的风险，非必要别动。

开发者向：API 与 MCP 接入

使用场景：你想把下载能力嵌进自己的脚本或 AI 助手里，而不是手动点。怎么操作：先用python main.py token生成一个鉴权令牌（长期有效，别外传），再启动对应服务：

python main.py api # REST 接口，访问 /docs 有交互式文档 python main.py mcp # MCP 服务，可接入支持 MCP 的 AI 工具

然后 POST/xhs/detail，请求体里带上作品链接和download: true，请求头加Authorization: Bearer 你的令牌：

data = {"url": "作品链接", "download": True} headers = {"Authorization": "Bearer 你的鉴权令牌"} response = post("http://127.0.0.1:5556/xhs/detail", json=data, headers=headers, timeout=10)

注意点：API 和 MCP 模式都要带令牌，缺失或无效会返回 403；Docker 下跑 API/MCP 时命令行调用和剪贴板功能是没的，属正常现象。

如果你是做二次开发，仓库根目录的 example.py 给了一段带注释的最小调用，改改参数就能跑，核心源码都在 source/。

方案对比：为什么选本地下载器

同样想"把小红书内容存下来"，路不止一条，差别在你平时最关心的几件事上：

手工"另存为"那档就更别提了——水印、画质、效率全输。所以当你既要批量又要干净文件、还不想把东西交给别人时，本地方案是少数几个选项里最稳的。

避坑指南：这些情况你大概率会撞上

⚠️ 下面几条是真实高频问题，对照着看能少绕很多弯路。

1. 你可能遇到视频存下来很糊，这时应该去补一份完整的 Cookie（里面要含web_session字段），只缺 Cookie 是画质上不去最常见的原因。

2. 你可能遇到请求被限流、速度忽快忽慢，这时应该保持默认的请求延时（程序内置约 6 秒间隔），别为了快把间隔压没，那样更容易触发风控。
3. 你可能遇到"明明没存过却被跳过下载"，这时应该知道下载记录是默认开启的，想重下就得先删掉数据库里对应的作品 ID。
4. 你可能遇到旧链接突然下不动，这时应该换最新获取的链接——作品链接里带日期信息，太老的链接容易被风控。
5. 你可能看到脚本里有"自动滚动页面"想打开，这时应该先停手：它有被判自动化、连累账号的风险，默认关闭是有原因的。

最后

XHS-Downloader 把"提取链接、去水印、批量下载、接接口"这几件事收进了一个免费开源的本地工具里，GUI 看着顺手、命令行跑得快、API 留给想折腾的人。装好、贴上链接、存下干净的文件，就是你今天能走通的最短路径。

• 项目说明与完整参数表：README.md
• 二次开发最小示例：example.py
• 核心源码：source/
• 依赖清单：requirements.txt
• 获取代码：git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader

【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader