3分钟上手XHS-Downloader：小白也能掌握的小红书无水印下载神器
【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结果作品、用户链接；采集小红书作品信息；提取小红书作品下载地址；下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader
还在为小红书上的精美图文和视频无法保存而烦恼吗？XHS-Downloader为你提供了一套完整的解决方案！无论你是内容创作者需要收集灵感素材，还是研究人员需要批量采集数据，这款开源工具都能帮你轻松获取小红书上的无水印原版内容。
🚀 快速启动：选择最适合你的使用方式
魔法开始：3步快速上手
第一步：获取工具
git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader第二步：安装依赖
# 使用pip安装 pip install -r requirements.txt # 或者使用更快的uv（推荐） uv sync --no-dev第三步：启动程序
python main.py就是这么简单！三行命令，你的小红书下载神器就已经准备就绪了。
图形界面：零门槛操作
如果你是第一次接触这类工具，图形界面是最友好的选择。启动程序后，你会看到一个简洁直观的界面：
界面主要分为三个区域：
- 链接输入区：直接粘贴小红书作品链接
- 功能按钮区：下载、读取剪贴板、清空等操作
- 状态显示区：实时显示下载进度和状态
⚙️ 配置备忘卡：关键参数速查
| 参数 | 类型 | 说明 | 推荐值 |
|---|---|---|---|
--cookie | 字符串 | 小红书Cookie（非必需） | 从浏览器获取 |
--work_path | 字符串 | 文件保存路径 | 自定义文件夹路径 |
--folder_mode | 布尔值 | 每个作品单独文件夹 | true（便于管理） |
--image_format | 选择项 | 图片下载格式 | WEBP（质量好） |
--max_retry | 整数 | 失败重试次数 | 3（平衡成功率与速度） |
📱 浏览器脚本：一键提取链接
对于经常浏览小红书网页版的用户，浏览器脚本是你的最佳助手。安装Tampermonkey插件后，添加XHS-Downloader脚本，你就能在浏览时快速提取链接：
脚本提供四大核心功能：
- 📋提取发布作品链接：获取作者所有公开内容
- ❤️提取点赞作品链接：保存你点赞过的内容
- ⭐提取收藏作品链接：整理收藏夹中的作品
- 🔍提取搜索结果链接：批量获取搜索内容
使用技巧：脚本支持自动滚动页面加载更多内容，只需在设置中开启此功能，就能一次性提取数百个链接。
💻 命令行模式：批量处理的利器
如果你需要处理大量链接或希望自动化操作，命令行模式提供了最灵活的控制：
基础命令示例
# 下载单个作品 python main.py --url "https://www.xiaohongshu.com/explore/作品ID" # 批量下载多个作品 python main.py --url "链接1 链接2 链接3" --folder_mode true # 指定保存路径和格式 python main.py --url "作品链接" --work_path "./我的素材库" --image_format "PNG"高级用法：按需下载
# 只下载图文作品中的特定图片（第1、3、5张） python main.py --url "作品链接" --index "1 3 5" # 按作者分类保存 python main.py --url "作者作品链接" --author_archive true --name_format "{作者昵称}_{作品标题}" # 使用代理服务器 python main.py --url "作品链接" --proxy "http://127.0.0.1:10808"🔧 故障修复卡：常见问题解决方案
问题1：Cookie无效或过期
症状：无法获取高清视频或部分内容解决：
- 浏览器打开小红书网页版并登录
- 按F12打开开发者工具
- 切换到"网络"标签，刷新页面
- 找到任意请求，复制完整的Cookie值
- 在程序设置中粘贴或使用
--cookie参数
问题2：下载速度慢
解决：
# 增大下载块大小 python main.py --chunk 4194304 # 4MB块大小 # 减少重试次数 python main.py --max_retry 2 # 设置超时时间 python main.py --timeout 15问题3：文件命名混乱
解决：使用自定义命名格式
python main.py --name_format "{发布时间}_{作者昵称}_{作品标题}"支持的格式变量包括：
{作者昵称}、{作者ID}{作品标题}、{作品描述}{发布时间}、{最后更新时间}{点赞数量}、{收藏数量}、{评论数量}
🌐 服务器模式：专业用户的自动化方案
对于需要集成到工作流或希望远程调用的用户，XHS-Downloader提供了API和MCP两种服务器模式。
API模式：RESTful接口调用
启动API服务器：
python main.py api访问http://127.0.0.1:5556/docs查看完整的API文档。支持JSON格式的POST请求，可以轻松集成到其他应用中。
MCP模式：统一管理平台
MCP模式提供了更专业的管理界面，适合需要监控多个下载任务的企业用户：
配置步骤：
- 启动MCP服务器：
python main.py mcp - 访问配置界面，设置服务参数
- 开启流式传输支持
- 保存配置并启动服务
核心优势：
- 🕒定时任务调度：设置自动执行时间
- 📊多任务监控：同时管理多个下载进程
- 🔄数据流转：下载后自动处理文件
- 📈性能统计：监控下载速度和成功率
📚 资源链接卡：深入学习指南
官方文档路径
- 配置文件说明：
./Volume/settings.json- 所有配置参数详解 - 示例代码：
example.py- 二次开发参考实现 - 源码结构：
source/- 核心模块实现
进阶功能探索
- 自定义模块开发：参考
source/module/中的代码结构 - 语言本地化：修改
locale/中的翻译文件 - 用户脚本定制：编辑
static/XHS-Downloader.js
🔍 最佳实践：工作流程优化
内容创作者的工作流：
浏览小红书 → 使用脚本提取链接 → 批量下载到本地 → 按作者分类整理 → 创建素材库研究人员的采集流程：
确定关键词 → 脚本批量搜索 → 导出链接列表 → 命令行批量下载 → 数据清洗分析开发者的集成方案：
启动API服务器 → 编写调用脚本 → 定时任务调度 → 结果自动处理 → 数据入库分析⚠️ 重要提醒：合规使用指南
使用原则
- 个人使用优先：下载内容仅用于个人学习研究
- 尊重版权：保留原作者信息，不用于商业用途
- 合理频率：避免短时间内大量请求
- 数据安全：所有操作在本地完成，不上传第三方
技术限制
- 未设置Cookie时，视频只能下载低分辨率版本
- 部分老旧链接可能因平台风控而失效
- 自动滚动功能可能触发平台反爬机制
更新维护
项目保持活跃更新，建议定期检查新版本：
# 查看当前版本 python main.py --version # 关注GitHub Releases获取更新XHS-Downloader不仅仅是一个下载工具，更是一套完整的小红书内容管理解决方案。无论你是技术小白还是开发专家，都能找到适合自己的使用方式。记住：工具虽强大，使用需负责，尊重平台规则，合理利用资源。
现在就开始你的小红书内容收集之旅吧！如果有任何问题，欢迎查阅项目文档或参与社区讨论。✨
【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结果作品、用户链接；采集小红书作品信息；提取小红书作品下载地址；下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
