XHS-Downloader：小红书无水印下载的终极开源解决方案

XHS-Downloader小红书无水印下载的终极开源解决方案【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader你是否曾经在小红书上看到喜欢的图片或视频却因为平台限制无法保存高清无水印版本现在借助XHS-Downloader这款强大的开源工具你可以轻松解决这个痛点。XHS-Downloader是一个基于Python开发的小红书内容下载工具支持提取账号发布、收藏、点赞、专辑作品链接并能智能采集小红书作品信息下载无水印的高质量文件。 核心功能概览XHS-Downloader提供了全方位的小红书内容下载解决方案无论是普通用户还是技术开发者都能找到适合自己的使用方式 快速对比XHS-Downloader vs 传统方法功能对比XHS-Downloader传统方法截图/录屏画质保持100%无损原画质画质严重压缩水印处理完全无水印带有平台水印批量处理支持多链接批量下载只能逐个处理自动化程度支持剪贴板监听自动下载完全手动操作文件格式支持PNG、JPEG、WEBP、HEIC、MP4等格式单一技术门槛多种使用方式可选简单但功能有限️ 多种运行模式XHS-Downloader提供了五种不同的使用方式满足不同用户的需求图形界面模式TUI- 适合普通用户直观易用命令行模式- 适合技术用户和自动化场景Docker容器运行- 适合服务器环境和隔离部署API服务器模式- 适合与其他系统集成用户脚本模式- 浏览器端增强功能 快速开始指南环境准备与安装XHS-Downloader基于Python 3.12开发支持Windows、macOS和Linux系统。推荐使用uv进行依赖管理# 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader # 使用uv安装依赖推荐 uv sync --no-dev # 启动图形界面 uv run main.py如果你更喜欢使用pip# 创建虚拟环境 python -m venv venv # Windows激活 .\venv\Scripts\activate # Linux/macOS激活 source venv/bin/activate # 安装依赖 pip install -r requirements.txt # 启动程序 python main.pyDocker一键部署对于希望快速部署的用户Docker是最佳选择# TUI模式运行 docker run --name xhs-downloader -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader # API模式运行 docker run --name xhs-downloader -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader python main.py api # MCP模式运行 docker run --name xhs-downloader -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader python main.py mcp 图形界面体验XHS-Downloader的图形界面设计简洁直观即使是没有任何技术背景的用户也能轻松上手。主界面提供了以下核心功能链接输入区域直接粘贴小红书作品链接支持多个链接空格分隔剪贴板监听自动读取剪贴板中的链接内容批量下载一次性处理多个作品链接实时进度显示清晰展示下载状态和进度智能链接解析XHS-Downloader支持多种小红书链接格式包括https://www.xiaohongshu.com/explore/作品IDhttps://www.xiaohongshu.com/discovery/item/作品IDhttps://www.xiaohongshu.com/user/profile/作者ID/作品IDhttps://xhslink.com/分享码程序会自动识别和提取有效链接无需手动清理复杂的URL参数。⚙️ 高级配置选项XHS-Downloader提供了丰富的配置选项让你可以根据需求定制下载行为核心配置参数配置项类型说明默认值work_path字符串作品文件保存根路径项目根路径/Volumefolder_name字符串作品文件储存文件夹名称Downloadname_format字符串文件命名格式发布时间 作者昵称 作品标题image_format字符串图片下载格式AUTO/PNG/WEBP/JPEG/HEICJPEGvideo_preference字符串视频下载偏好resolution/bitrate/sizeresolutionfolder_mode布尔值是否为每个作品创建独立文件夹falseauthor_archive布尔值是否按作者分类保存作品falsedownload_record布尔值是否记录已下载作品IDtrueCookie配置指南虽然Cookie配置不是强制要求但配置Cookie可以获得更好的体验视频画质提升未设置Cookie时视频作品只能下载低分辨率文件功能稳定性如遇功能异常建议配置或更新Cookie无需登录账号配置Cookie不需要登录小红书账号获取Cookie步骤在小红书网页版打开开发者工具F12访问任意小红书页面在Network标签中找到请求复制Cookie值在程序设置中粘贴Cookie值 命令行模式详解对于技术用户和自动化场景命令行模式提供了更精细的控制基础使用示例# 下载单个作品 python main.py --url https://xhslink.com/xxx # 批量下载多个作品 python main.py --url 链接1 链接2 链接3 --image_format webp --folder_mode true # 指定下载图文作品中的特定图片 python main.py --url 链接 --index 2,5 --work_path /自定义下载路径常用参数说明--url (-u)小红书作品链接支持多个链接空格分隔--index (-i)指定下载图文作品中的图片序号--image_format图片下载格式选择--folder_mode是否将作品保存到独立文件夹--work_path (-wp)自定义下载路径--cookie (-ck)小红书Cookie配置--proxy (-p)代理服务器设置--timeout (-t)请求超时时间秒--max_retry (-mr)失败重试次数 剪贴板监听模式剪贴板监听模式让下载变得极其简单在主界面按M键或点击开启监听按钮复制小红书作品链接到剪贴板程序自动识别并开始下载如需停止在剪贴板输入close或点击退出按钮这个功能特别适合日常浏览时快速保存喜欢的内容无需频繁切换窗口。 用户脚本增强功能通过浏览器扩展如Tampermonkey安装用户脚本你可以在小红书网页端直接使用XHS-Downloader的功能脚本安装步骤安装Tampermonkey等用户脚本管理器添加XHS-Downloader用户脚本从GitHub Raw URL安装在小红书网页版使用提取功能将提取的链接复制到下载工具脚本功能特性批量提取链接支持发布、收藏、点赞、专辑作品链接提取搜索结果处理提取搜索结果中的作品和用户链接自动滚动加载自动滚动页面加载更多内容一键推送下载与主程序联动直接推送下载任务 API与MCP集成RESTful API接口启动API服务器后你可以通过HTTP请求调用下载功能# 启动API服务器 python main.py api启动后访问http://127.0.0.1:5556/docs查看交互式API文档。主要接口包括POST /xhs/detail获取作品详细信息POST /xhs/download下载作品文件MCP模式配置MCPModel Context Protocol模式为AI助手提供了调用接口# 启动MCP服务器 python main.py mcp配置示例名称XHS-Downloader类型可流式传输的HTTPURLhttp://127.0.0.1:5556/mcp/ 技术架构解析XHS-Downloader采用模块化设计核心代码位于source/目录下核心模块结构source/ ├── application/ # 应用层逻辑 │ ├── app.py # 主应用类 │ ├── download.py # 下载功能 │ ├── explore.py # 数据解析 │ ├── image.py # 图片处理 │ └── video.py # 视频处理 ├── module/ # 功能模块 │ ├── manager.py # 配置管理 │ ├── recorder.py # 记录管理 │ └── tools.py # 工具函数 └── expansion/ # 扩展功能 ├── converter.py # 数据转换 └── browser.py # 浏览器集成关键实现原理链接解析通过正则表达式提取作品ID支持多种URL格式数据获取使用HTTPX库进行异步请求支持代理和Cookie文件下载支持断点续传和分块下载确保大文件稳定性格式转换自动识别和转换图片格式保持最佳画质错误处理完善的异常处理和重试机制 使用场景与案例场景一内容创作者素材收集需求设计师、文案等创作者需要收集小红书上的创意素材解决方案使用用户脚本批量提取相关主题的作品链接通过剪贴板监听模式自动下载新发现的内容设置图片格式为WEBP节省存储空间启用作品归档模式按作者分类整理素材场景二个人收藏整理需求普通用户想要保存喜欢的作品供离线浏览解决方案在浏览小红书时复制感兴趣的作品链接程序自动下载并保存到指定文件夹设置文件夹模式每个作品独立文件夹启用作品数据记录便于后续查找场景三技术开发者集成需求开发者需要在其他应用中集成小红书下载功能解决方案使用API模式启动服务器通过HTTP请求调用下载功能自定义文件命名和保存规则集成到现有工作流中 故障排除与优化常见问题解答Q下载速度慢怎么办A可以尝试以下方法调整并发下载数默认为3可适当增加检查网络连接状态考虑使用代理服务器增大下载分块大小--chunk 1048576Q链接解析失败如何处理A请检查链接是否包含完整作品ID尝试在浏览器中打开链接确认有效性确保链接格式符合支持的类型更新Cookie配置Q文件保存失败怎么办A排查步骤检查磁盘空间是否充足确认文件路径权限查看日志文件中的具体错误信息尝试更换保存路径性能优化建议根据不同的使用场景可以调整以下参数以获得最佳性能场景推荐配置说明高速网络--chunk 1048576增大分块大小至1MB不稳定网络--max_retry 10增加重试次数至10次大文件下载--timeout 60延长超时时间至60秒节省存储空间--image_format webp使用WebP格式节省空间批量处理--folder_mode true每个作品独立文件夹 社区生态与发展项目活跃度XHS-Downloader作为一个活跃的开源项目拥有持续更新定期发布新版本修复问题并添加功能多语言支持支持中文和英文界面完善文档提供详细的使用说明和API文档活跃社区Discord、QQ群等多渠道技术支持贡献指南欢迎对本项目做出贡献为了保持代码库的整洁、高效和易于维护请遵循以下指南开发流程从develop分支拉取最新代码进行修改代码规范使用Ruff工具保持代码格式规范提交信息遵循类型: 简短描述格式测试验证确保修改不会破坏现有功能未来发展方向XHS-Downloader项目团队正在规划以下功能多平台支持增加抖音、快手等平台下载支持浏览器扩展开发独立的浏览器扩展插件云同步功能实现配置和记录的云端同步智能分类基于AI的内容分类和标签系统 总结XHS-Downloader作为一款功能全面、易于使用的小红书内容下载工具解决了用户在小红书内容保存过程中的核心痛点。无论是普通用户的无水印下载需求还是技术用户的批量处理和自动化需求都能找到合适的解决方案。通过本文的详细介绍你已经了解了XHS-Downloader的核心功能、多种使用方式、配置优化技巧以及高级应用场景。现在就开始体验这款强大的工具让小红书内容的保存变得简单而高效。无论你是内容创作者需要保存参考素材还是普通用户想要收藏喜欢的作品XHS-Downloader都能成为你的得力助手。开源项目的持续发展离不开社区的支持欢迎加入项目社区共同打造更好的小红书内容下载体验。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考