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

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

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

XHS-Downloader是一款功能强大的小红书内容采集工具，专门用于提取和下载小红书平台上的图文、视频作品。无论你是内容创作者、数据分析师还是普通用户，这款工具都能帮助你快速获取小红书上的优质内容，支持多种使用模式，包括图形界面、命令行和API调用，满足不同用户的需求。本文将详细介绍如何使用XHS-Downloader进行小红书作品下载，并提供完整的配置指南和最佳实践建议。

📋 项目概述与核心功能

XHS-Downloader是一个开源的小红书内容采集工具，支持多种内容获取方式。它不仅能下载单个作品，还能批量处理多个链接，大大提高了内容采集的效率。

🎯 核心功能亮点

作品信息采集- 自动提取小红书作品的详细信息，包括标题、描述、作者信息、发布时间等元数据。

多格式文件下载- 支持下载图文作品的多种格式（WEBP、PNG、JPEG、HEIC）以及视频作品，满足不同使用场景的需求。

智能文件管理- 自动跳过已下载作品，支持断点续传，确保下载过程稳定可靠。

多模式运行- 提供图形界面（TUI）、命令行、API服务和MCP模式，适应不同技术水平的用户。

用户脚本支持- 配合浏览器扩展，实现一键推送下载任务，简化操作流程。

🚀 快速开始：3种安装方式

1. 程序运行（最简单的方式）

对于大多数用户来说，直接下载预编译的可执行文件是最简单的方式：

1. 访问项目发布页面，下载对应操作系统的程序压缩包
2. 解压文件到本地目录
3. 双击运行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.py

3. 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：

1. 打开浏览器（建议使用无痕模式）
2. 访问https://www.xiaohongshu.com/explore
3. 按F12打开开发者工具
4. 切换到"网络"选项卡，勾选"保留日志"
5. 在过滤框中输入cookie-name:web_session
6. 选择"Fetch/XHR"筛选器
7. 点击任意小红书作品
8. 在"网络"选项卡中选择数据包，复制Cookie值

💡 多种使用方式详解

图形界面模式（TUI）

这是最直观的使用方式，适合大多数用户。启动程序后，你会看到一个简洁的命令行界面：

在界面中，你可以：

• 直接粘贴小红书作品链接
• 使用"读取剪贴板"功能快速获取链接
• 设置下载参数和偏好
• 查看下载记录和进度

命令行模式

对于批量处理或自动化任务，命令行模式提供了更大的灵活性：

# 基本用法 python main.py --url "小红书链接" # 指定下载图片序号 python main.py --url "链接" --index 1 3 5 # 自定义保存路径 python main.py --url "链接" --work_path "D:/Downloads"

API服务模式

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提供了强大的浏览器用户脚本，可以与小书网页无缝集成：

1. 安装Tampermonkey浏览器扩展
2. 添加XHS-Downloader用户脚本
3. 在小红书网页上直接提取作品链接或推送下载任务

脚本功能包括：

• 提取账号发布、收藏、点赞、专辑作品链接
• 提取搜索结果中的作品和用户链接
• 一键推送下载任务到本地程序
• 自动滚动页面加载更多内容

📁 项目结构解析

了解项目结构有助于更好地使用和定制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参数，支持多种字段组合。

🚨 注意事项与最佳实践

使用建议

1. 定期更新Cookie：Cookie可能会过期，建议定期更新以获得最佳体验
2. 合理设置请求间隔：避免请求频率过高，程序内置了延时机制
3. 备份配置文件：修改重要配置前建议备份原文件
4. 使用合适的文件格式：根据需求选择图片格式，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, download=True) print(f"下载完成: {result.get('title', '未知作品')}")

🏁 总结

XHS-Downloader是一款功能全面、易于使用的小红书内容采集工具。无论你是普通用户想要保存喜欢的作品，还是开发者需要集成内容采集功能，这个工具都能满足你的需求。

立即开始使用XHS-Downloader，体验高效的小红书内容采集流程！记住，好的工具不仅能提高效率，还能让你的工作更加轻松愉快。

提示：更多详细信息和最新更新，请参考项目中的配置文件和示例代码。如果你遇到任何问题或有改进建议，欢迎在项目社区中提出。

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