XHS-Downloader 完整指南粘贴链接就能批量下载小红书作品与视频【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader刷到一篇不错的小红书笔记想存下来截图会掉画质视频保存下来却是带水印的低清版想一次保存好几篇更是纯手工活。XHS-Downloader 是一款开源的小红书作品下载工具给它一个作品链接它就能自动把图文、视频、动图整套文件存到你的硬盘里。如果你需要把小红书内容归档、备份或做成素材库从零基础到会二次开发它都能接住。它能替你做什么XHS-Downloader 干的是链接进、文件出这条流水线丢进一个或多个作品链接它会先取回每条作品的完整信息——标题、发布时间、点赞、评论、收藏数再按你的偏好把对应文件写到磁盘还顺手记着哪些作品下载过避免重复劳动。使用形态上它给了五档选择双击即用的图形界面、适合脚本化的命令行、在浏览器里边刷边收的用户脚本、供程序调用的API以及能接入 AI 助手的MCP服务五种形态跑的是同一套核心逻辑source/application/你可以随需求深浅随时切换。5 分钟跑通第一次下载不用装任何复杂环境最短路径如下拿源码git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader并进入目录嫌麻烦也可直接下载官方程序包解压后双击main运行装依赖执行uv sync --no-dev没有 uv 就装好 Python 3.12 后改用pip install -r requirements.txt启动程序uv run main.py不带参数时直接进入图形界面命令行启动逻辑见 main.py粘贴链接下载支持explore/作品ID、discovery/item/作品ID、xhslink.com短链等格式多个链接用空格分隔一次性粘进去即可收文件默认落在./Volume/Download/配置文件./Volume/settings.json首次运行自动生成后面所有个性化都从它开始。界面左侧的剪贴板模式值得顺手打开开启后你复制作品链接的瞬间程序就自动开工全程不用点任何按钮。想拿到高清原片配好 Cookie 这一步别省目标视频作品要清晰原片而不是模糊压缩版。怎么做不配置 Cookie 时视频只能拿到低分辨率配置后就能取到高清版本而且全程不需要登录账号。获取方式浏览器打开https://www.xiaohongshu.com/explore按F12进入开发者工具切到网络选项卡勾选保留日志过滤框输入cookie-name:web_session然后点页面上任意一个作品选中任意一个数据包把完整 Cookie 复制进settings.json的cookie字段。不想文件夹变乱葬岗自定义命名与按作者归档目标文件多到几百个时打开文件夹还能一眼认出谁是谁。默认命名是发布时间 作者昵称 作品标题嫌不够可以打开settings.json的name_format把点赞数、收藏数、作品类型、作者 ID 等十几个字段自由组合。整理量大的话更推荐开启author_archive每个作者的作品自动归入独立的作者ID_作者昵称文件夹作者日后改昵称程序还会回头把旧文件名同步改掉——相当于给文件上了保险。想给某位作者起个自己顺口的别名在mapping_data里写一条作者ID: 别名即可。边刷边存浏览器用户脚本免开程序目标刷小红书时看到好作品不用切窗口、复制链接、回程序粘贴。装好 Tampermonkey 扩展后把项目自带的用户脚本 static/XHS-Downloader.js 添加进去再把配置文件里的script_server设为true、让主程序在后台常驻。之后在作品页点一下脚本菜单里的推送下载任务当前作品就自动送给程序处理。脚本还能一键提取推荐页、作者主页、收藏、搜索结果里的作品链接配合程序的批量下载能力刷一次页面就能收一整批。下载过的自动跳过断网了自动续传目标链接攒了一堆重复的不想下两遍下了一半断了也不想从头来。程序会把下载成功的作品 ID 记进./Volume/ExploreID.db再次遇到直接跳过download_record控制该行为文件传输本身支持断点续传并做完整性校验网络抖一下、进程退了重跑接着传就行。配合timeout、max_retry、chunk三个参数基本可以放着不管。给效率玩家命令行、API 与 AI 接入习惯脚本化的话命令行模式几乎覆盖配置文件里的全部参数链接之间用空格分隔即可批量处理# 一次性下载多个作品链接 python main.py --url 链接1 链接2 链接3 # 只取图文第 1、5 张图并按作者归档 python main.py --url 作品链接 --index 1 5 --author_archive true加--update_settings还能把本次命令行参数直接写回配置文件。想要程序间调用或接进 AI 工作流两条命令就能起服务python main.py api # 启动后访问 127.0.0.1:5556/docs 查看交互式接口文档 python main.py mcp # 以 MCP 协议接入 AI 客户端需额外安装 fastmcp启动时终端会输出鉴权令牌也可用python main.py token单独生成请求时带上即可。服务器用户则可以直接docker pull joeanamier/xhs-downloader挂载-v卷映射/app/Volume后运行配置与文件都会持久保留。出问题时先自查这 4 件事视频下载下来很模糊原因是没配 Cookie。按上文步骤抓一份web_session填进settings.json即可无需登录。请求失败、返回空数据或被风控原因是作品链接自带日期信息旧链接容易失效。换最新复制的链接并控制请求节奏——程序内置请求延时别叠加多线程狂刷。想重下某作品程序却自动跳过原因是它的 ID 在下载记录库里。删掉./Volume/ExploreID.db中对应 ID或关闭download_record参数。用户脚本点推送下载任务没反应原因通常是script_server未开、主程序没在后台跑或全局代理干扰。按顺序把这三样检查掉代理先关掉再试。现在就动手XHS-Downloader 把找链接、采信息、存文件这一整串繁琐操作压缩成了粘贴、回车两个动作。第一步按上面的编号步骤把程序跑起来粘贴你的第一条链接第二步配上 Cookie、打开作者归档——之后你存下的每一个小红书作品都会安安静静躺在该在的文件夹里。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考