小红书内容采集神器：XHS-Downloader 三分钟上手指南-程序员充电站

小红书内容采集神器：XHS-Downloader 三分钟上手指南

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

还在为无法保存小红书精彩内容而烦恼吗？XHS-Downloader 是一款强大的开源工具，专门用于提取和下载小红书上的图文、视频作品。无论你是内容创作者需要整理作品集，还是普通用户想要保存喜欢的笔记，这个工具都能帮你轻松实现无水印下载。

为什么选择 XHS-Downloader？

在众多小红书下载工具中，XHS-Downloader 脱颖而出，因为它提供了最全面的解决方案：

🎯 四大使用模式：图形界面、命令行工具、浏览器脚本、API服务，满足不同用户需求🔧 全功能覆盖：支持发布、收藏、点赞、专辑等所有类型内容采集📁 智能管理：自动分类、断点续传、文件去重，让下载管理变得简单🌐 多平台支持：Windows、macOS、Linux 全平台兼容

快速开始：三分钟安装体验

第一步：获取项目源码

git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader

第二步：安装依赖

使用 pip 安装（推荐使用国内镜像加速）：

pip install -r requirements.txt

或者使用更快的 uv 工具：

uv sync --no-dev

第三步：启动程序

python main.py

启动后，你会看到简洁直观的图形界面：

界面分为三个主要区域：链接输入区、功能按钮区和状态显示区。只需将小红书作品链接粘贴到输入框中，点击"下载作品文件"即可开始下载。

核心功能深度解析

1. 图形界面模式：新手友好

对于大多数用户来说，图形界面是最直观的选择。XHS-Downloader 的图形界面设计简洁，功能一目了然：

批量处理：支持一次性输入多个链接，用空格分隔
剪贴板监听：自动读取剪贴板中的链接，无需手动粘贴
实时进度：显示下载进度和结果反馈
配置管理：可自定义下载路径、文件格式等参数

设置界面让你可以调整各种参数，包括重试次数、文件格式、语言设置等，确保工具按照你的需求工作。

2. 命令行模式：批量处理利器

如果你需要处理大量作品或集成到自动化流程中，命令行模式提供了精细控制：

python main.py --url "链接1 链接2 链接3" \ --work_path "./downloads" \ --name_format "{作者}_{标题}_{日期}" \ --folder_mode True

命令行参数丰富，支持高度定制化：

参数	简写	功能说明
`--url`	`-u`	小红书作品链接（必需）
`--work_path`	`-wp`	文件保存路径
`--name_format`	`-nf`	自定义文件名格式
`--folder_mode`	`-fm`	按作品创建独立文件夹
`--image_format`	`-if`	图片格式（PNG/WEBP/JPEG/HEIC）
`--max_retry`	`-mr`	失败重试次数

3. 浏览器脚本：无缝集成体验

安装 Tampermonkey 扩展后，你可以直接在浏览器中使用 XHS-Downloader 脚本：

脚本核心功能：

✅ 提取当前账号所有发布作品链接
✅ 收集点赞和收藏的作品
✅ 批量复制链接到剪贴板
✅ 自动滚动页面加载更多内容

4. 高级配置：Cookie 设置

虽然 XHS-Downloader 无需登录也能使用，但配置 Cookie 后可以获得更好的功能体验，特别是视频作品的高清下载：

获取 Cookie 的步骤很简单：

在小红书网页版按 F12 打开开发者工具
切换到"网络"标签并勾选"保留日志"
刷新页面，找到任意请求中的 Cookie 字段并复制
将 Cookie 添加到程序配置中

配置 Cookie 后，你将解锁：

高清视频下载权限
更稳定的数据采集
避免频繁请求限制

实用技巧与最佳实践

高效批量下载

场景一：整理个人作品集

# 使用浏览器脚本提取所有发布作品链接 # 将链接保存到文本文件 # 使用命令行批量下载 python main.py --url "$(cat links.txt)" \ --author_archive True \ --name_format "{发布时间}_{作品标题}"

场景二：收集竞品内容

# 使用代理避免IP限制 python main.py --url "竞品链接列表.txt" \ --record_data True \ --image_format WEBP \ --proxy "http://代理地址:端口"

文件管理策略

XHS-Downloader 提供了多种文件管理选项：

按作者归档：设置--author_archive True，自动按作者分类存储
文件夹模式：设置--folder_mode True，为每个作品创建独立文件夹
自定义命名：使用--name_format参数定义文件名格式，支持变量：
- {作者}：作者昵称
- {标题}：作品标题
- {日期}：发布时间
- {作品ID}：小红书作品ID

自动化工作流

利用剪贴板监听功能，你可以创建自动化工作流：

启动剪贴板监听模式
在小红书 App 或网页中复制作品链接
工具自动检测并开始下载
下载完成后自动归档到指定文件夹

技术架构与扩展开发

项目结构

XHS-Downloader 采用模块化设计，便于二次开发：

source/ ├── application/ # 应用层：下载、请求、图片视频处理 ├── module/ # 核心模块：模型、管理器、脚本处理 ├── expansion/ # 扩展功能：浏览器集成、错误处理 ├── CLI/ # 命令行接口 ├── TUI/ # 图形界面 └── translation/ # 多语言支持

API 集成示例

开发者可以将 XHS-Downloader 集成到自己的项目中：

from source.application.app import XHS async def custom_download(): async with XHS( work_path="./my_downloads", name_format="{作者昵称}_{作品标题}", image_format="WEBP", author_archive=True ) as xhs: result = await xhs.extract( "https://www.xiaohongshu.com/explore/xxx", download=True ) print(result)

MCP 服务模式

对于需要集成到其他系统的开发者，XHS-Downloader 提供了 MCP 服务模式：

# MCP模式启动 python main.py mcp # 配置地址：http://127.0.0.1:5556/mcp/

常见问题解答

Q：必须登录账号才能使用吗？

A：不需要！Cookie 配置主要是为了获取更好的视频画质和避免请求限制，即使不配置 Cookie 也能正常使用大部分功能。

Q：支持哪些链接格式？

A：支持多种链接格式：

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

Q：下载速度慢怎么办？

A：可以尝试以下优化：

检查网络连接稳定性
调整chunk参数（默认 2MB），根据网络状况适当增大
避免同时运行过多下载任务
使用代理服务器解决地域限制

开始你的小红书内容管理之旅

XHS-Downloader 不仅仅是一个下载工具，它是一个完整的小红书内容管理解决方案。无论你是：

内容创作者：需要整理自己的作品集
市场研究员：需要分析竞品内容
普通用户：想要保存喜欢的笔记
开发者：需要集成内容采集功能

都能在这个开源项目中找到合适的解决方案。项目的活跃社区和持续更新保证了工具的稳定性和功能性，而完全开源的特性让你可以完全掌控自己的数据安全。

立即开始：克隆仓库、安装依赖、运行程序，体验高效的小红书内容采集吧！如果在使用过程中遇到任何问题，欢迎在项目仓库中提交 Issue 或加入社区讨论。

记住：合理使用工具，尊重原创内容，遵守平台规则，让技术为创作赋能，而不是替代创作。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

小红书内容采集神器：XHS-Downloader 三分钟上手指南