免费开源的 XHS-Downloader3 分钟把小红书作品存成原图和本地视频【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader收藏夹里存了几十条小红书笔记过一阵子再打开发现图片糊了、链接也失效了——这种存了等于没存的事很多人遇到过。开源项目 XHS-Downloader 做的事很直接你贴一个作品链接它负责解析、下载、归档把原图和本地视频存进你的硬盘全程不用登录账号。项目卡片它是什么XHS-Downloader 是一个基于 Python 的小红书作品采集工具一条命令走完链接 → 解析 → 下载 → 归档四步同时提供图形界面、命令行、API、MCP 四种入口外加一个浏览器用户脚本帮你批量搬链接。项目信息内容核心技术栈Python 3.12AIOHTTP / FastAPI / Textual许可证GPL-3.0功能点 1采集作品信息并下载原图、视频、封面图片格式可选 PNG、WEBP、JPEG、HEIC 或 AUTO功能点 2批量粘贴链接自动识别有效链接支持断点续传功能点 3下载记录写入数据库source/module/recorder.py管理重复作品自动跳过功能点 4支持 API 与 MCP 两种服务模式可接入程序和 AI 对话工具首次上手从克隆到出第一个文件整个过程四步装好 Python 3.12 就能开始。拉取源码git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader安装依赖两种方式任选其一pip install -r requirements.txt # 或 uv sync --no-dev启动程序python main.py默认打开图形界面。把作品链接粘进输入框点下载即可。验证产出文件默认落在项目根目录的./Volume/Download里配置写在./Volume/settings.json首次运行自动生成。功能进阶指南按你愿意花的时间分三层从打开就能用一路到接入自己的工作流。立刻能用图形界面里粘贴链接就能下在输入框贴多个链接时用空格隔开程序会自动挑出有效的再下载explore作品页和xhslink.com短链都认。想更省事的话在界面开启剪贴板监听之后在任何网页复制作品链接程序都会自己接住任务。下载记录默认开启同一作品第二次贴进来会直接跳过不会重复占空间。用得巧命令行只下载指定的三张图长图文有几十张图时命令行能精确挑图--index后面跟图片序号# 只下载第 3、7 张图 python main.py --url 作品链接 --index 3 7想换保存位置加--work_path其余参数的说明运行python main.py --help即可查到不用逐个背。用到极致API 与 MCP 把能力交给程序和 AIAPI 模式一行命令启动python main.py api启动后访问http://127.0.0.1:5556/docs就是交互式文档POST 请求/xhs/detail传入作品链接即可采集信息并触发下载。项目根目录的example.py写了一份完整调用示例照着改就能接进自己的程序。MCP 模式把上面的命令换成python main.py mcp然后按 README 里的示例把http://127.0.0.1:5556/mcp配进支持 MCP 的对话工具令牌填启动时输出的鉴权令牌——之后对 AI 说一句帮我下载这个链接就能跑起来。组合玩法两个真实场景核心都是分工浏览器或 AI 负责找链接程序负责下载。用户脚本 主程序收藏夹里有几百条笔记时手点不现实。在 Tampermonkey 里导入仓库自带的static/XHS-Downloader.js小红书网页右上角会多出一个菜单可以一键提取收藏、点赞、发布作品的链接并复制。再把配置里的script_server设为true让主程序后台挂着当服务器在浏览器点推送下载任务脚本就把任务交给程序执行浏览器只管提取。最后把author_archive设为true几百条笔记会按作者自动分好文件夹。MCP AI 对话工具浏览器里看到想存的作品直接把链接丢给接了 XHS-Downloader 的 AI 助手作品信息、下载动作都由它代为执行省去打开终端的步骤。避坑与常用配置先对照这张表排查问题再决定要不要动配置现象原因解法下载卡住或失败全局代理干扰了请求关闭系统代理后重试视频只有低清晰度未配置 Cookie按下面步骤补上 Cookie 并重启程序链接提示失效、被风控作品链接自带日期信息旧链接易被拦用最新抓取的链接不要短时间高频请求重复下载同一作品数据库里已有下载记录设计如此想重新下就删掉ExploreID.db中对应记录Cookie 就是请求随身携带的身份证。获取步骤浏览器打开小红书网页版按F12进开发者工具切到网络标签在过滤框输入cookie-name:web_session点任意作品选中一个请求把请求头里的 Cookie 整段复制粘贴到设置或配置文件的cookie项重启生效。升级方面源码用户执行git pull origin main再更新一次依赖即可用打包程序的用户把旧版根目录里的Volume文件夹整体复制到新版里配置和下载记录就都带过去了。开头那个收藏失效的尴尬到这一步基本可以杜绝。XHS-Downloader 把每条链接变成硬盘里带原图和视频的文件剩下的交给自动跳过和归档就行。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考