XHS-Downloader高效智能的小红书内容采集与下载完整方案【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader还在为保存小红书上的精彩内容而烦恼吗每次看到喜欢的图文教程、创意视频或精美图片想要收藏却总是遇到水印遮挡、画质压缩、批量下载困难等问题。XHS-Downloader 提供了一套完整的解决方案让小红书内容下载变得简单高效。无论你是普通用户想要保存喜欢的内容还是内容创作者需要收集素材或是开发者需要集成下载功能这个开源工具都能满足你的需求。核心理念让内容保存回归纯粹小红书作为一个内容创作和分享平台每天都有大量优质内容产生。然而平台本身并不提供便捷的内容导出功能用户经常面临保存困难。XHS-Downloader 的核心理念是打破这个限制让用户能够自由、高效地保存和整理自己喜欢的内容。XHS-Downloader不仅仅是一个下载工具更是一个完整的内容管理解决方案。它支持多种链接格式包括标准的小红书分享链接、个人主页链接、专辑链接等能够智能识别并提取作品信息。更重要的是它能够获取原始的无水印文件确保你保存的内容保持最佳质量。快速上手3分钟开启高效下载之旅环境准备与安装开始使用 XHS-Downloader 非常简单。首先你需要克隆项目到本地git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader接下来推荐使用 uv 工具安装依赖这是目前最便捷的方式uv sync --no-dev如果你习惯使用传统的 pip 安装方式也可以创建虚拟环境后安装python -m venv venv # 激活虚拟环境Linux/macOSsource venv/bin/activateWindowsvenv\Scripts\activate pip install -r requirements.txt安装完成后运行uv run main.py或python main.py即可启动程序。图形界面操作直观易用的主界面启动程序后你会看到一个简洁直观的图形界面这是最适合新手的操作方式。主界面设计考虑到了用户的操作习惯所有功能都一目了然。主界面包含三个核心功能区域链接输入框直接粘贴小红书作品链接支持多个链接用空格分隔功能按钮区包含下载作品文件、读取剪贴板、清空输入框三个主要按钮快捷键提示底部显示所有可用快捷键方便快速操作快捷键操作指南Q退出程序U检查更新S进入程序设置R查看下载记录M开启剪贴板监听模式基础配置个性化你的下载体验点击S键或通过菜单进入程序设置界面你可以根据个人需求调整各项参数关键配置项说明重试次数网络不稳定时建议设置为5-10次确保下载成功率图片下载格式支持 PNG、JPEG、WEBP、HEIC 等多种格式推荐使用 HEIC 格式平衡画质和文件大小视频下载偏好码率优先可以获得更好的画质体验文件夹模式开启后每个作品独立文件夹便于文件管理作者归档按作者分类保存适合长期收藏整理深度应用四种使用方式满足不同需求方式一图形界面模式 - 适合所有用户图形界面模式是最推荐给普通用户的使用方式。无需记忆任何命令所有操作都通过直观的界面完成。特别适合日常浏览小红书时看到喜欢的内容直接复制链接打开程序粘贴下载。使用场景个人用户日常使用无需技术背景操作简单直观。方式二命令行模式 - 适合技术用户对于需要批量处理或自动化场景的用户命令行模式提供了更精细的控制常用命令示例# 下载单个作品 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小红书作品链接支持多链接--index指定下载图文作品中的图片序号--image_format图片格式选择--folder_mode是否使用文件夹模式--work_path自定义下载路径方式三剪贴板监听模式 - 自动化下载体验剪贴板监听模式是提升效率的利器。开启后程序会在后台自动监控剪贴板一旦检测到小红书链接就自动下载完全不打断你的浏览体验。开启步骤在主界面按M键或点击开启监听按钮复制小红书作品链接到剪贴板程序自动识别并开始下载如需停止在剪贴板输入close或点击退出按钮使用技巧这个功能特别适合浏览小红书时使用。看到喜欢的内容直接复制链接程序就会在后台默默下载你可以继续浏览其他内容。方式四用户脚本模式 - 浏览器集成方案如果你经常使用浏览器访问小红书用户脚本模式将是你的最佳选择。通过浏览器扩展你可以在小红书网页版直接提取和下载内容。安装步骤安装 Tampermonkey 或类似浏览器扩展添加 XHS-Downloader 用户脚本在小红书网页版使用提取功能脚本功能亮点提取发布作品链接提取收藏作品链接提取点赞作品链接提取专辑作品链接提取搜索结果作品链接提取搜索结果用户链接场景应用解决实际问题的完整方案场景一个人收藏整理需求想要保存自己喜欢的博主的全部作品建立个人资料库。解决方案使用用户脚本提取博主的所有发布作品链接将链接保存到文本文件使用命令行批量处理python main.py --url $(cat links.txt) --folder_mode true --author_archive true最佳实践开启作者归档功能系统会自动为每个作者创建独立文件夹文件夹名称为作者ID_作者昵称便于后续查找和管理。场景二内容创作素材收集需求设计师、内容创作者需要收集灵感素材建立素材库。解决方案开启剪贴板监听模式浏览小红书时看到喜欢的素材直接复制链接程序自动下载到指定文件夹开启文件夹模式每个作品独立保存文件管理技巧建议按月份或项目分类创建不同的下载目录配合智能命名功能让素材管理更加有序。场景三团队协作与共享需求团队需要共享小红书内容作为参考或素材。解决方案使用 Docker 部署 API 服务器模式团队成员通过 API 接口提交下载任务文件统一保存到共享存储通过 Web 界面查看下载进度和结果API 调用示例from source.application.app import XHS async def download_content(): async with XHS( work_path团队共享路径, folder_name项目素材, name_format发布时间 作者昵称 作品标题, image_formatWEBP, folder_modeTrue ) as xhs: result await xhs.extract( https://www.xiaohongshu.com/explore/XXX, downloadTrue )场景四自动化内容备份需求定期备份特定博主的内容更新。解决方案编写脚本定期提取博主新作品链接使用 cron 定时任务自动下载设置邮件或消息通知了解下载状态自动化脚本示例#!/bin/bash # 每天凌晨2点自动下载 cd /path/to/XHS-Downloader python main.py --url 博主最新作品链接 /var/log/xhs_downloader.log 21进阶技巧提升下载体验的关键配置Cookie 配置获取更高画质内容虽然 Cookie 配置不是强制项但配置后可以获得更好的体验。特别是对于视频作品未设置 Cookie 时只能下载低分辨率文件配置 Cookie 后可获取更高画质。获取 Cookie 步骤在小红书网页版打开任意页面按 F12 打开开发者工具切换到 Network网络选项卡勾选保留日志在过滤框中输入cookie-name:web_session选择 Fetch/XHR 筛选器点击任意作品在网络请求中找到 Cookie 值配置方法将获取到的 Cookie 值复制到程序设置中或通过命令行参数--cookie传入。性能调优指南根据不同的使用场景可以调整以下参数以获得最佳性能高速网络环境增大分块大小至 1MB提升下载速度python main.py --chunk 1048576不稳定网络增加重试次数至 10 次提高成功率python main.py --max_retry 10大文件下载延长超时时间至 60 秒避免中断python main.py --timeout 60节省存储空间使用 WebP 格式画质损失小文件体积小python main.py --image_format webp文件管理最佳实践按作者归档开启author_archive参数程序会自动为每个作者创建独立文件夹结构清晰Download/ ├── 作者ID1_昵称1/ │ ├── 作品1.jpg │ ├── 作品2.mp4 │ └── metadata.json ├── 作者ID2_昵称2/ │ ├── 作品1.webp │ └── metadata.json └── ...按作品归档开启folder_mode参数每个作品单独文件夹包含所有相关文件Download/ ├── 作品1_20250101_作者A/ │ ├── image1.jpg │ ├── image2.jpg │ └── metadata.json ├── 作品2_20250102_作者B/ │ ├── video.mp4 │ └── metadata.json └── ...智能命名自定义文件名称格式支持多种字段组合发布时间 作者昵称 作品标题作品ID 发布时间 作者昵称作者昵称 作品标题 作品类型避坑指南常见问题解决方案Q1下载速度慢怎么办排查步骤检查网络连接状态尝试更换网络环境调整并发下载数配置文件中的chunk参数考虑使用代理服务器特别是访问境外内容时增大下载分块大小--chunk 1048576优化建议在网络状况良好的时段进行批量下载避免高峰时段。Q2链接解析失败如何处理排查步骤确认链接是否包含完整作品ID尝试在浏览器中打开链接确认有效性确保链接格式符合支持的类型更新 Cookie 配置后重试支持链接格式https://www.xiaohongshu.com/explore/作品ID?xsec_tokenXXXhttps://www.xiaohongshu.com/discovery/item/作品ID?xsec_tokenXXXhttps://www.xiaohongshu.com/user/profile/作者ID/作品ID?xsec_tokenXXXhttps://xhslink.com/分享码Q3文件保存失败怎么办按顺序检查磁盘空间是否充足文件路径权限是否正确查看日志文件中的具体错误信息尝试更换保存路径权限问题解决在 Linux/macOS 系统上确保对下载目录有写权限在 Windows 系统上避免使用系统保护目录。Q4如何获取更高画质的视频必须配置 Cookie按照前文步骤获取小红书网页版 Cookie在程序设置中配置 Cookie重新下载视频作品画质对比配置 Cookie 后视频分辨率可从 480p 提升至 1080p 或更高。Q5支持批量下载吗完全支持多种方式可选命令行模式--url 链接1 链接2 链接3图形界面多个链接用空格分隔用户脚本批量提取链接后统一处理批量处理技巧将多个链接保存到文本文件使用命令行批量处理。Q6Docker 运行有什么限制Docker 运行注意事项不支持命令行调用模式无法使用读取剪贴板与监听剪贴板功能可以正常粘贴内容其他功能如有异常请反馈生态拓展从工具到平台Docker 容器化部署对于需要在服务器环境或隔离环境中使用的场景Docker 是最佳选择TUI 模式运行docker run --name xhs-downloader -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloaderAPI 模式运行docker run --name xhs-downloader -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader python main.py apiMCP 模式运行docker run --name xhs-downloader -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader python main.py mcpAPI 服务器模式如果你需要将下载功能集成到其他系统中API 服务器模式提供了标准化的接口启动 API 服务器python main.py api启动后访问http://127.0.0.1:5556/docs查看交互式 API 文档。主要接口包括POST /xhs/detail获取作品详细信息POST /xhs/download下载作品文件API 调用示例import requests response requests.post( http://127.0.0.1:5556/xhs/download, json{ url: https://xhslink.com/xxx, download: True, cookie: your_cookie_here } )二次开发与集成XHS-Downloader 采用模块化设计便于二次开发和功能扩展核心模块结构source/application/核心应用逻辑source/module/功能模块source/expansion/扩展功能source/translation/国际化支持代码调用示例from source.application.app import XHS # 自定义配置初始化 xhs XHS( work_path自定义路径, folder_name项目文件夹, name_format发布时间 作者昵称 作品标题, image_formatWEBP, folder_modeTrue, author_archiveTrue ) # 执行下载任务 result await xhs.extract( https://www.xiaohongshu.com/explore/XXX, downloadTrue, index[1, 3, 5] # 只下载第1、3、5张图片 )最佳实践总结新手用户建议从图形界面开始先熟悉基本操作了解程序功能配置 Cookie获取更好的视频画质体验开启文件夹模式保持文件组织有序使用剪贴板监听提升日常使用效率进阶用户建议掌握命令行参数实现批量处理和自动化合理配置性能参数根据网络环境调整使用用户脚本浏览器集成提升效率定期更新程序获取最新功能和修复开发者建议阅读源码结构了解模块化设计利用 API 接口集成到现有系统参与社区贡献提交问题反馈或代码改进关注更新日志了解功能变化和技术演进立即开始使用XHS-Downloader 作为一款功能全面、易于使用的小红书内容下载工具真正解决了用户在小红书内容保存过程中的核心痛点。无论你是普通用户想要无水印保存喜欢的内容还是内容创作者需要批量收集素材或是开发者需要集成下载功能XHS-Downloader 都能提供完美的解决方案。立即开始使用克隆项目git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader安装依赖uv sync --no-dev启动程序uv run main.py开始下载粘贴链接点击下载记住开源项目的生命力在于社区。如果你在使用过程中有任何问题或建议欢迎到项目仓库提交 Issue或者加入社区与其他用户交流。让我们一起打造更好的小红书内容下载体验最后的小贴士定期更新项目代码可以获取最新功能和修复。关注项目的更新信息及时获取新版本让你的下载体验始终保持最佳状态。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
