XHS-Downloader:3分钟掌握小红书无水印批量下载神器
XHS-Downloader:3分钟掌握小红书无水印批量下载神器
【免费下载链接】XHS-Downloader小红书(XiaoHongShu、RedNote)链接提取/作品采集工具:提取账号发布、收藏、点赞、专辑作品链接;提取搜索结果作品、用户链接;采集小红书作品信息;提取小红书作品下载地址;下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader
还在为无法批量保存小红书上的精彩内容而烦恼?XHS-Downloader是一款功能强大的小红书内容采集工具,支持图文和视频作品的无水印下载、批量采集和链接提取功能。这款基于Python开发的开源工具,让内容收藏变得前所未有的简单高效。无论你是普通用户还是开发者,都能在3分钟内快速上手,成为小红书内容管理的高手。
🚀 快速开始:零门槛上手指南
三种安装方式,总有一种适合你
XHS-Downloader提供了多种安装方式,满足不同用户的需求:
一键安装:对于普通用户,直接前往项目仓库下载对应系统的压缩包,解压后双击运行即可。无需配置环境,开箱即用。
Docker部署:对于喜欢容器化的用户,一条命令就能启动服务:
docker run -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader源码运行:开发者可以克隆仓库后直接运行:
git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader.git cd XHS-Downloader uv run main.py程序默认下载路径为./Volume/Download,所有配置都存储在settings.json文件中,首次运行会自动生成。
🎯 核心特性:让下载变得智能高效
智能识别与批量处理
XHS-Downloader支持多种链接格式,无论是官方链接还是短链接都能智能识别。最方便的是,你可以一次性输入多个链接,程序会自动提取有效链接并进行批量处理。
支持的链接格式包括:
https://www.xiaohongshu.com/explore/作品IDhttps://www.xiaohongshu.com/discovery/item/作品IDhttps://xhslink.com/分享码
无水印下载与智能管理
程序支持图文、视频、LivePhoto等多种格式的无水印下载。智能跳过已下载文件功能避免了重复下载,断点续传机制确保大文件也能稳定下载。
文件命名支持自定义格式,你可以按照"发布时间 作者昵称 作品标题"的方式命名,也可以添加点赞数、评论数等元数据。每个作者的作品可以自动归档到独立文件夹,便于分类管理。
多模式操作,满足不同场景
TUI终端界面:提供直观的图形化操作界面,适合普通用户使用。
命令行模式:支持丰富的参数配置,适合批量处理和自动化脚本。
API模式:提供RESTful接口,方便集成到其他系统中。
MCP模式:支持模型上下文协议,可以与其他AI工具无缝集成。
📱 浏览器脚本:网页端无缝集成
一键安装,功能全开
XHS-Downloader提供了浏览器用户脚本,可以直接在小红书网页端使用。安装Tampermonkey扩展后,导入脚本即可获得以下功能:
- 单作品下载:在作品页面直接显示"下载无水印"按钮
- 批量提取:一键提取账号所有发布、收藏、点赞作品链接
- 自动滚动:无限滚动加载并提取更多内容
脚本与程序联动
启用脚本服务器功能后,用户脚本可以与主程序联动。在浏览器中点击"推送下载任务",脚本会自动将任务发送给后台运行的程序,实现一键下载。
⚙️ 高级配置:定制你的下载体验
配置文件详解
XHS-Downloader的配置文件settings.json提供了丰富的自定义选项:
{ "name_format": "发布时间 作者昵称 作品标题", "folder_mode": true, "author_archive": true, "download_record": true }关键配置项说明:
name_format:支持多种变量组合的文件命名格式folder_mode:每个作品单独文件夹存储author_archive:按作者分类存储image_format:支持PNG、WEBP、JPEG、HEIC等多种格式
Cookie配置优化
虽然Cookie不是必需项,但配置后可以获得更好的体验:
- 视频作品可下载更高分辨率版本
- 减少请求限制,提高成功率
- 无需登录账号,只需获取网页版Cookie
🔧 进阶技巧:提升使用效率
命令行批量处理
对于需要批量下载的用户,命令行模式是最佳选择:
# 批量下载多个作品 python main.py "https://xhslink.com/abc123" "https://xhslink.com/def456" # 指定下载图文作品的部分图片 python main.py --index 1,3,5 "https://xhslink.com/ghi789"API集成开发
开发者可以通过API模式将XHS-Downloader集成到自己的应用中:
import requests server = "http://127.0.0.1:5556/xhs/detail" data = { "url": "作品链接", "download": True, "index": [1, 3, 5], "proxy": "http://127.0.0.1:10808" } response = requests.post(server, json=data, timeout=10)MCP服务器配置
MCP模式支持与其他AI工具集成,配置简单直观:
- 类型:可流式传输的HTTP
- URL:
http://127.0.0.1:5556/mcp/ - 支持实时数据获取和文件下载
🎨 应用场景:解决实际问题
内容创作者素材收集
对于内容创作者来说,XHS-Downloader是绝佳的素材收集工具。你可以:
- 批量下载灵感来源作品
- 按作者分类整理素材库
- 自定义命名便于后期查找
- 保持无水印的高质量素材
数据分析与研究
研究人员可以使用XHS-Downloader进行:
- 批量采集特定主题的内容
- 提取作品元数据进行分析
- 建立本地化的内容数据库
- 自动化数据收集流程
个人内容管理
普通用户可以:
- 收藏喜欢的图文和视频
- 建立个人化的内容库
- 离线保存重要内容
- 按时间线整理收藏
🛠️ 故障排除与优化
常见问题解决方案
下载失败怎么办?
- 检查网络连接,必要时配置代理
- 更新Cookie配置
- 清除下载记录文件
ExploreID.db - 检查文件写入权限
Cookie获取指南
- 浏览器访问小红书网页版
- 按F12打开开发者工具
- 切换到"网络"标签,勾选"保留日志"
- 筛选
cookie-name:web_session请求 - 复制完整Cookie值到程序配置
性能优化建议
- 合理设置
chunk参数调整下载块大小 - 根据网络情况调整
timeout和max_retry - 启用
download_record避免重复下载 - 使用
folder_mode保持文件组织有序
最佳实践
- 定期更新:关注项目更新,获取最新功能和修复
- 备份配置:定期备份
settings.json文件 - 分类存储:利用
author_archive功能按作者分类 - 批量处理:使用命令行模式处理大量链接
- 脚本辅助:结合用户脚本提高采集效率
🌟 项目架构与扩展
源码结构概览
XHS-Downloader采用模块化设计,主要目录结构:
source/application/:核心应用逻辑source/TUI/:终端用户界面组件source/module/:功能模块实现source/expansion/:扩展功能source/translation/:多语言支持
二次开发指南
项目提供了完善的API接口和示例代码,开发者可以轻松进行二次开发。example.py文件包含了完整的调用示例,展示了如何通过代码设置各种参数。
对于想要定制功能的开发者,项目采用清晰的代码结构和详细的注释,便于理解和修改。所有配置项都有明确的类型说明和默认值,降低了开发门槛。
📚 学习资源与社区
官方文档与示例
项目提供了丰富的学习资源:
README.md:详细的中文使用说明example.py:完整的代码调用示例locale/:多语言翻译文件static/:包含用户脚本和配置文件
社区支持
项目拥有活跃的社区支持,包括Discord社区、QQ群聊等交流渠道。用户可以在这些平台上:
- 获取使用帮助
- 报告问题和建议
- 分享使用技巧
- 参与项目贡献
🚀 未来展望
XHS-Downloader持续更新迭代,未来计划包括:
- 更多平台支持扩展
- 智能内容识别功能
- 云端同步支持
- 移动端适配
无论你是普通用户、内容创作者还是开发者,XHS-Downloader都能为你提供强大而灵活的小红书内容管理解决方案。从简单的单作品下载到复杂的批量处理,从本地使用到服务器部署,这款工具都能满足你的需求。
开始使用XHS-Downloader,让小红书内容管理变得简单高效!
【免费下载链接】XHS-Downloader小红书(XiaoHongShu、RedNote)链接提取/作品采集工具:提取账号发布、收藏、点赞、专辑作品链接;提取搜索结果作品、用户链接;采集小红书作品信息;提取小红书作品下载地址;下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
