小红书内容下载神器XHS-Downloader：3种方式轻松保存精美图文视频

小红书内容下载神器XHS-Downloader：3种方式轻松保存精美图文视频

【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结果作品、用户链接；采集小红书作品信息；提取小红书作品下载地址；下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader

你是否经常在小红书上看到精彩内容想要保存下来？无论是精美的旅行照片、实用的生活技巧，还是有趣的短视频，XHS-Downloader都能帮你轻松下载保存。这款开源的小红书内容采集工具支持多种使用方式，从简单的图形界面到高级的命令行控制，满足不同用户的需求。

📦 项目核心功能一览

XHS-Downloader是一个功能全面的小红书内容下载工具，它能够：

• 提取多种链接类型：支持小红书作品链接、用户主页链接、搜索结果链接
• 智能内容识别：自动识别图文、视频、livePhoto等不同类型作品
• 批量处理能力：支持多个链接同时下载，提高工作效率
• 智能文件管理：自动去重、按作者分类、自定义命名规则
• 跨平台支持：提供图形界面、命令行、浏览器脚本三种使用方式

如图所示，XHS-Downloader的图形界面简洁直观，只需粘贴链接点击下载即可完成操作。界面顶部显示项目名称和版本信息，中间是链接输入区域，底部提供多种功能按钮，包括下载、读取剪贴板、清空输入等。

🖥️ 图形界面：新手友好的操作方式

对于大多数用户来说，图形界面是最简单直接的下载方式。安装完成后，双击运行程序即可开始使用。

快速上手步骤

1. 获取程序：从GitCode克隆项目或下载预编译版本
2. 启动程序：运行python main.py或直接双击可执行文件
3. 粘贴链接：复制小红书作品链接到输入框
4. 开始下载：点击"下载作品文件"按钮

界面功能详解

XHS-Downloader的图形界面设计注重用户体验，主要功能区域包括：

• 链接输入区：支持批量粘贴多个链接，用空格分隔即可
• 功能按钮区：提供下载、读取剪贴板、清空等常用操作
• 状态显示区：实时显示下载进度和结果
• 快捷操作栏：通过快捷键快速访问设置、更新、记录等功能

核心源码参考：source/application/app.py - 包含主要的应用程序逻辑和界面处理

⌨️ 命令行模式：高效批量的专业选择

对于需要批量处理或集成到自动化流程的用户，命令行模式提供了更强大的控制能力。

常用命令示例

# 基本下载命令 python main.py --url "小红书作品链接" # 指定下载部分图片 python main.py --url "链接" --index "1 3 5" # 自定义保存路径 python main.py --url "链接" --work_path "./我的收藏" # 按作者分类保存 python main.py --url "链接" --author_archive true

命令行界面展示了所有可用参数，包括URL、索引、工作路径等，适合需要精确控制的用户使用。

核心参数详解

• --url / -u：必需参数，指定要下载的小红书链接
• --index / -i：可选参数，指定要下载的图片序号（仅对图文作品有效）
• --work_path / -wp：设置文件保存的根目录路径
• --name_format：自定义文件名格式，支持多种变量组合
• --author_archive：是否按作者分类保存作品

🌐 浏览器脚本：网页端无缝集成

结合Tampermonkey浏览器扩展，你可以在浏览小红书网页时直接使用下载功能。

脚本安装指南

1. 安装Tampermonkey浏览器扩展
2. 打开脚本管理页面
3. 从URL安装：https://gitcode.com/gh_mirrors/xh/XHS-Downloader/raw/master/static/XHS-Downloader.js
4. 启用脚本即可在小红书网页上使用

脚本在小红书网页上添加了功能菜单，可以提取当前页面的作品链接、批量下载内容，实现真正的"所见即所得"体验。

脚本核心功能

• 一键提取：快速提取发布、收藏、点赞、专辑中的作品链接
• 批量下载：支持多作品同时下载
• 自动滚动：自动加载更多内容（可配置滚动次数）
• 任务推送：将下载任务推送到本地运行的XHS-Downloader程序

🔧 高级配置与优化技巧

Cookie配置获取方法

虽然不配置Cookie也能使用基本功能，但配置Cookie可以获得更好的体验，特别是高清视频下载。

获取Cookie的步骤：

1. 打开小红书网页版并登录账号
2. 按F12打开开发者工具
3. 切换到"网络"标签页
4. 勾选"保留日志"选项
5. 刷新页面或点击任意作品
6. 找到包含web_session的Cookie字段并复制

配置文件自定义

XHS-Downloader的配置文件位于./Volume/settings.json，支持丰富的自定义选项：

{ "image_format": "JPEG", "folder_mode": false, "author_archive": false, "download_record": true, "name_format": "发布时间 作者昵称 作品标题" }

重要配置项说明：

• image_format：图片下载格式，支持AUTO、PNG、WEBP、JPEG、HEIC
• folder_mode：是否为每个作品创建独立文件夹
• author_archive：是否按作者分类保存作品
• name_format：文件名格式，支持多种变量组合

🚀 三种运行方式详解

程序运行（推荐新手）

直接从Releases页面下载预编译版本，解压后直接运行即可。这种方式无需安装Python环境，适合大多数用户。

源码运行（推荐开发者）

# 使用pip安装 pip install -r requirements.txt python main.py # 使用uv安装（推荐） uv sync --no-dev uv run main.py

Docker运行（推荐服务器）

# 拉取镜像 docker pull joeanamier/xhs-downloader # 运行容器 docker run -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader

🔌 API与MCP服务模式

API模式

启动API服务：python main.py api访问文档：http://127.0.0.1:5556/docs

API模式提供了标准的RESTful接口，方便其他程序调用。你可以通过HTTP请求来获取作品信息或触发下载任务。

MCP模式

启动MCP服务：python main.py mcp配置地址：http://127.0.0.1:5556/mcp/

MCP模式适合与模型上下文协议集成，为AI助手提供小红书内容下载能力。

📊 实用场景与应用案例

场景一：内容创作者备份作品

作为内容创作者，你可能需要定期备份自己发布的作品。使用XHS-Downloader可以：

1. 使用浏览器脚本提取所有发布作品链接
2. 批量下载并设置合适的文件名格式
3. 启用作者分类功能，便于后续管理
4. 配置修改时间同步，保持文件时间戳与发布时间一致

场景二：市场研究数据收集

对于市场研究人员，XHS-Downloader可以帮助：

1. 配置代理避免IP限制
2. 设置合适的请求间隔，避免频繁访问
3. 批量下载竞品内容进行分析
4. 保存作品信息至数据库，便于后续分析

场景三：个人收藏整理

普通用户可以：

1. 开启剪贴板监听模式
2. 浏览时直接复制链接自动下载
3. 按主题分类保存到不同文件夹
4. 使用自定义命名规则，便于查找

❓ 常见问题解答

Q：下载速度慢怎么办？

A：可以调整chunk参数增加数据块大小，或检查网络连接。配置文件中的timeout和max_retry参数也会影响下载体验。

Q：为什么有些视频画质不高？

A：未配置Cookie时只能下载低分辨率视频。建议按照教程获取Cookie以解锁高清视频下载权限。

Q：链接失效如何处理？

A：小红书链接有时效性，建议使用最新获取的链接。如果链接失效，可以重新访问作品页面获取新链接。

Q：如何避免重复下载？

A：XHS-Downloader默认开启下载记录功能，会自动记录已下载的作品ID。你也可以在配置文件中设置download_record为true来启用此功能。

Q：支持哪些类型的链接？

A：支持多种小红书链接格式：

• https://www.xiaohongshu.com/explore/作品ID
• https://www.xiaohongshu.com/discovery/item/作品ID
• https://www.xiaohongshu.com/user/profile/作者ID/作品ID
• https://xhslink.com/分享码

💡 最佳实践与建议

文件管理策略

1. 按作者分类：启用author_archive功能，每个作者的作品会保存在独立文件夹
2. 智能命名：使用name_format自定义文件名，如{发布时间}_{作者昵称}_{作品标题}
3. 避免重复：保持download_record开启，避免重复下载相同内容

性能优化建议

1. 合理配置参数：根据网络状况调整chunk大小和timeout时间
2. 使用Cookie：配置Cookie以获得更好的下载体验
3. 批量处理：一次性处理多个链接，减少程序启动开销

使用注意事项

1. 遵守平台规则：合理使用工具，避免频繁请求
2. 尊重原创内容：仅用于个人收藏和学习目的
3. 定期更新：关注项目更新以获取最新功能和修复

🎯 总结与展望

XHS-Downloader作为一款功能全面的小红书内容下载工具，提供了从简单到高级的多种使用方式。无论你是普通用户想要保存喜欢的内容，还是开发者需要集成下载功能，都能找到合适的解决方案。

核心源码位置：source/application/download.py - 包含核心的下载逻辑实现

项目的持续发展离不开社区的支持。如果你在使用过程中遇到问题或有改进建议，欢迎参与项目讨论。记住，合理使用工具、尊重原创内容是最重要的原则。

现在就开始使用XHS-Downloader，建立你自己的小红书内容库吧！

【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结果作品、用户链接；采集小红书作品信息；提取小红书作品下载地址；下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader