XHS-Downloader：小红书作品一键下载神器，3步实现高效内容采集

XHS-Downloader小红书作品一键下载神器3步实现高效内容采集【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-DownloaderXHS-Downloader是一款功能强大的小红书内容采集工具专门用于提取和下载小红书平台上的图文、视频作品。无论你是内容创作者、数据分析师还是普通用户这款工具都能帮助你快速获取小红书上的优质内容支持多种使用模式包括图形界面、命令行和API调用满足不同用户的需求。本文将详细介绍如何使用XHS-Downloader进行小红书作品下载并提供完整的配置指南和最佳实践建议。 项目概述与核心功能XHS-Downloader是一个开源的小红书内容采集工具支持多种内容获取方式。它不仅能下载单个作品还能批量处理多个链接大大提高了内容采集的效率。 核心功能亮点作品信息采集- 自动提取小红书作品的详细信息包括标题、描述、作者信息、发布时间等元数据。多格式文件下载- 支持下载图文作品的多种格式WEBP、PNG、JPEG、HEIC以及视频作品满足不同使用场景的需求。智能文件管理- 自动跳过已下载作品支持断点续传确保下载过程稳定可靠。多模式运行- 提供图形界面TUI、命令行、API服务和MCP模式适应不同技术水平的用户。用户脚本支持- 配合浏览器扩展实现一键推送下载任务简化操作流程。 快速开始3种安装方式1. 程序运行最简单的方式对于大多数用户来说直接下载预编译的可执行文件是最简单的方式访问项目发布页面下载对应操作系统的程序压缩包解压文件到本地目录双击运行main程序文件即可注意Mac用户首次运行时可能需要执行以下命令解除安全限制xattr -cr 项目文件夹路径2. 源码运行适合开发者如果你需要自定义功能或进行二次开发可以选择源码运行# 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader # 进入项目目录 cd XHS-Downloader # 使用uv安装依赖推荐 uv sync --no-dev # 启动程序 uv run main.py3. Docker运行适合服务器部署对于需要在服务器环境运行的用户Docker提供了最便捷的部署方式# 拉取镜像 docker pull joeanamier/xhs-downloader # 创建并运行容器TUI模式 docker run -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader 详细配置指南基础配置设置首次运行XHS-Downloader时程序会自动生成配置文件./Volume/settings.json。这个文件包含了所有可自定义的参数你可以根据需要进行调整。关键配置项说明work_path作品文件和数据的保存根路径folder_name作品文件存储的文件夹名称name_format文件命名格式支持多种字段组合cookie小红书网页版Cookie非必需但建议配置以获得更好体验proxy网络代理设置如果需要的话Cookie配置教程为了获得更好的下载体验和更高的视频分辨率建议配置小红书Cookie打开浏览器建议使用无痕模式访问https://www.xiaohongshu.com/explore按F12打开开发者工具切换到网络选项卡勾选保留日志在过滤框中输入cookie-name:web_session选择Fetch/XHR筛选器点击任意小红书作品在网络选项卡中选择数据包复制Cookie值 多种使用方式详解图形界面模式TUI这是最直观的使用方式适合大多数用户。启动程序后你会看到一个简洁的命令行界面在界面中你可以直接粘贴小红书作品链接使用读取剪贴板功能快速获取链接设置下载参数和偏好查看下载记录和进度命令行模式对于批量处理或自动化任务命令行模式提供了更大的灵活性# 基本用法 python main.py --url 小红书链接 # 指定下载图片序号 python main.py --url 链接 --index 1 3 5 # 自定义保存路径 python main.py --url 链接 --work_path D:/DownloadsAPI服务模式XHS-Downloader提供了完整的API接口方便与其他系统集成# 启动API服务 python main.py api # API服务启动后可以通过HTTP请求调用 # 访问 http://127.0.0.1:5556/docs 查看API文档MCP模式对于需要与模型控制平台集成的用户MCP模式提供了标准化的接口# 启动MCP服务 python main.py mcp 高级功能与技巧批量处理与自动化XHS-Downloader支持批量处理多个链接只需在链接之间用空格分隔即可python main.py --url 链接1 链接2 链接3自定义文件命名通过配置文件中的name_format参数你可以自定义下载文件的命名格式{ name_format: 发布时间 作者昵称 作品标题 }支持的字段包括作品标题、作品描述、作者昵称、作品ID、发布时间、点赞数量、收藏数量等。智能文件管理自动跳过已下载程序会自动记录已下载的作品ID避免重复下载。断点续传下载过程中如果中断重新下载时会从断点处继续。文件完整性检查下载完成后会验证文件完整性确保文件完整可用。 浏览器用户脚本XHS-Downloader提供了强大的浏览器用户脚本可以与小书网页无缝集成安装Tampermonkey浏览器扩展添加XHS-Downloader用户脚本在小红书网页上直接提取作品链接或推送下载任务脚本功能包括提取账号发布、收藏、点赞、专辑作品链接提取搜索结果中的作品和用户链接一键推送下载任务到本地程序自动滚动页面加载更多内容 项目结构解析了解项目结构有助于更好地使用和定制XHS-Downloader核心模块目录source/ ├── application/ # 主要应用逻辑 │ ├── app.py # 核心XHS类 │ ├── download.py # 下载功能 │ ├── request.py # 网络请求处理 │ └── video.py # 视频处理 ├── module/ # 功能模块 │ ├── settings.py # 配置管理 │ ├── recorder.py # 下载记录 │ └── tools.py # 工具函数 ├── TUI/ # 图形界面 │ ├── app.py # 主应用 │ ├── index.py # 首页界面 │ └── setting.py # 设置界面 └── CLI/ # 命令行接口 └── main.py # 命令行入口配置文件说明配置文件位于./Volume/settings.json包含了所有可调整的参数。如果你在图形界面中修改配置遇到问题可以直接编辑这个文件。 常见问题与解决方案Q1: 下载速度慢怎么办A: 可以尝试调整chunk参数默认2MB适当增大可以提高下载速度。同时检查网络连接和代理设置。Q2: 如何下载高清视频A: 配置有效的Cookie可以获取更高分辨率的视频文件。未配置Cookie时只能下载低分辨率版本。Q3: 程序无法启动怎么办A: 确保Python版本≥3.12并正确安装了所有依赖。可以尝试使用uv sync --no-dev重新安装依赖。Q4: 如何批量下载用户的所有作品A: 使用浏览器用户脚本提取用户的所有作品链接然后使用命令行模式批量处理。Q5: 文件命名格式可以自定义吗A: 可以在配置文件中修改name_format参数支持多种字段组合。 注意事项与最佳实践使用建议定期更新CookieCookie可能会过期建议定期更新以获得最佳体验合理设置请求间隔避免请求频率过高程序内置了延时机制备份配置文件修改重要配置前建议备份原文件使用合适的文件格式根据需求选择图片格式WEBP格式通常更小法律合规请务必遵守小红书平台的使用条款和相关法律法规仅下载用于个人学习和研究的内容尊重原创作者的版权不将下载内容用于商业用途遵守平台的数据使用政策 性能优化技巧网络优化使用稳定的网络连接根据需要配置代理服务器调整timeout参数适应网络环境存储优化定期清理下载记录数据库使用合适的图片格式节省存储空间开启author_archive功能按作者分类存储自动化脚本结合Python脚本实现自动化下载from source import XHS import asyncio async def batch_download(urls): async with XHS() as xhs: for url in urls: result await xhs.extract(url, downloadTrue) print(f下载完成: {result.get(title, 未知作品)}) 总结XHS-Downloader是一款功能全面、易于使用的小红书内容采集工具。无论你是普通用户想要保存喜欢的作品还是开发者需要集成内容采集功能这个工具都能满足你的需求。立即开始使用XHS-Downloader体验高效的小红书内容采集流程记住好的工具不仅能提高效率还能让你的工作更加轻松愉快。提示更多详细信息和最新更新请参考项目中的配置文件和示例代码。如果你遇到任何问题或有改进建议欢迎在项目社区中提出。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考