小红书无水印下载神器：XHS-Downloader 完整指南
【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结果作品、用户链接；采集小红书作品信息；提取小红书作品下载地址；下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader
还在为小红书上的精彩内容无法保存而烦恼吗？XHS-Downloader 是一款功能强大的小红书内容采集工具，能够轻松提取和下载小红书上的图文、视频作品，支持无水印保存，满足内容创作者、研究者和普通用户的各种需求。这款基于 Python 开发的开源工具提供图形界面、命令行和浏览器脚本三种操作方式，让小红书内容采集变得简单高效。
🎯 为什么选择 XHS-Downloader？
核心优势一览
小红书下载工具XHS-Downloader 凭借其出色的功能和易用性，成为众多用户的首选：
| 功能特点 | 优势说明 |
|---|---|
| 无水印下载 | 直接获取原始文件，无需二次处理 |
| 多种使用模式 | 图形界面、命令行、浏览器脚本任选 |
| 批量处理 | 支持同时处理多个作品链接 |
| 智能去重 | 自动跳过已下载内容，避免重复工作 |
| 跨平台支持 | Windows、macOS、Linux 全平台兼容 |
| 开源免费 | 完全开源，功能完全开放 |
快速上手：5分钟开始下载
想要立即体验小红书内容采集的便利吗？只需几个简单步骤：
- 克隆仓库：
git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader - 进入目录：
cd XHS-Downloader - 安装依赖：
pip install -r requirements.txt - 启动程序：
python main.py
如果你想要更快的依赖安装速度，推荐使用 uv 工具：
uv sync --no-dev uv run main.py启动后，你会看到一个简洁明了的图形界面，所有功能一目了然：
XHS-Downloader 图形界面，支持批量链接输入和多种操作模式
📱 三种使用方式详解
1. 图形界面：新手友好的直观操作
对于大多数用户来说，图形界面是最直观的选择。界面设计简洁明了，分为三个主要区域：
- 链接输入区：支持批量粘贴多个作品链接，用空格分隔即可
- 功能按钮区：下载、读取剪贴板、清空输入等核心操作一应俱全
- 状态显示区：实时反馈下载进度和结果状态
2. 命令行模式：批量处理的得力助手
如果你需要处理大量作品或集成到自动化流程中，命令行模式提供了更精细的控制：
python main.py --url "链接1 链接2 链接3" \ --work_path "./downloads" \ --name_format "{作者}_{标题}_{日期}" \ --folder_mode TrueXHS-Downloader 命令行模式提供丰富的参数配置选项
常用参数快速参考表：
| 参数 | 简写 | 功能说明 | 默认值 |
|---|---|---|---|
--url | -u | 小红书作品链接（必需） | 无 |
--work_path | -wp | 文件保存路径 | ./downloads |
--name_format | -nf | 自定义文件名格式 | {create}_{title} |
--folder_mode | -fm | 按作品创建独立文件夹 | False |
--image_format | -if | 图片格式（PNG/WEBP/JPEG） | JPEG |
--max_retry | -mr | 失败重试次数 | 5 |
3. 浏览器脚本：网页无缝集成体验
安装 Tampermonkey 扩展后，你可以直接在浏览器中使用 XHS-Downloader 脚本：
浏览器脚本提供一键提取发布、点赞、收藏作品链接功能
脚本核心功能亮点：
- ✅ 提取当前账号所有发布作品链接
- ✅ 收集点赞和收藏的作品
- ✅ 批量复制链接到剪贴板
- ✅ 自动滚动页面加载更多内容
🔧 配置优化与高级技巧
提升体验：配置 Cookie 获取完整功能
虽然 XHS-Downloader 无需登录就能使用，但配置 Cookie 后可以获得更好的使用体验，特别是视频作品的高清下载功能：
- 在小红书网页版按 F12 打开开发者工具
- 切换到"网络"标签并勾选"保留日志"
- 刷新页面，找到请求中的 Cookie 字段并复制
通过浏览器开发者工具获取小红书 Cookie 的详细流程
配置 Cookie 后，你将获得以下优势：
- 高清视频下载权限
- 更稳定的数据采集体验
- 避免频繁请求限制
文件管理策略优化
| 配置项 | 推荐值 | 说明 |
|---|---|---|
folder_mode | True | 为每个作品创建独立文件夹 |
name_format | {create}_{author}_{title} | 包含时间、作者、标题信息 |
image_format | WEBP | 高质量压缩格式 |
author_archive | True | 按作者分类存储 |
性能优化配置示例
# 优化下载性能配置 python main.py --url "作品链接" \ --chunk 4194304 \ # 设置4MB分块下载 --max_retry 3 \ # 减少重试次数 --timeout 30 \ # 设置超时时间 --folder_mode True \ # 按作品分类 --author_archive True # 按作者归档🎪 多种应用场景
内容创作者的归档管理
作为一名内容创作者，定期整理自己的作品是必要的。使用 XHS-Downloader，工作流程如下：
- 批量提取链接：使用浏览器脚本一键提取所有发布作品链接
- 智能分类存储：设置
--author_archive True参数，按作者自动分类 - 自定义命名：使用
--name_format "{发布时间}_{作品标题}"保持文件有序 - 定期更新：每月运行一次，自动跳过已下载内容
市场研究的高效采集
市场分析师需要收集竞品内容进行分析：
# 批量处理多个账号 python main.py --url "链接列表.txt" \ --record_data True \ --image_format WEBP \ --proxy "http://代理地址:端口"关键配置要点：
record_data=True：保存作品元数据到 SQLite 数据库- 使用代理避免 IP 限制
- 设置合理的时间间隔，尊重平台规则
个人收藏整理
普通用户想要整理收藏的优质内容：
- 在小红书网页版打开"我的收藏"页面
- 使用用户脚本提取所有收藏作品链接
- 将链接粘贴到图形界面中批量下载
- 设置
--folder_mode True为每个作品创建独立文件夹
🚀 高级功能探索
API 模式：开发者集成利器
XHS-Downloader 提供完整的 API 接口，方便开发者集成到自己的应用中：
import requests server = "http://127.0.0.1:5556/xhs/detail" data = { "url": "https://www.xiaohongshu.com/explore/XXX", "download": True, "index": [1, 2, 3], "proxy": "http://127.0.0.1:10808", } response = requests.post(server, json=data, timeout=10) print(response.json())启动 API 服务器：
python main.py api访问http://127.0.0.1:5556/docs查看完整的 API 文档。
MCP 模式：智能助手集成
MCP 模式配置界面
MCP（Model Context Protocol）模式允许你将 XHS-Downloader 集成到 Claude Desktop、Cursor 等 AI 工具中，实现智能化的内容采集。
启动 MCP 服务器：
python main.py mcpDocker 部署：跨平台一致性
使用 Docker 可以确保在不同系统上获得一致的运行环境：
# 拉取镜像 docker pull joeanamier/xhs-downloader # 运行容器（TUI模式） docker run -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader # 运行容器（API模式） docker run -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader python main.py api❓ 常见问题解答
必须登录账号才能使用吗？
答案：完全不需要！XHS-Downloader 无需登录小红书账号也能正常工作。Cookie 配置主要是为了获得更好的视频画质和避免请求限制，即使不配置 Cookie 也能使用大部分功能。
下载速度慢怎么办？
解决方案：
- 检查网络连接稳定性
- 调整
chunk参数（默认 2MB），根据网络状况适当增大 - 避免同时运行过多下载任务
- 使用代理服务器解决地域限制
支持哪些链接格式？
支持的链接格式：
https://www.xiaohongshu.com/explore/作品IDhttps://www.xiaohongshu.com/discovery/item/作品IDhttps://xhslink.com/分享码https://www.xiaohongshu.com/user/profile/作者ID/作品ID
不支持的链接：
- 小红书 App 内的分享链接（需转换为网页版链接）
- 已删除或私密作品
- 需要特殊权限的内容
🏗️ 项目架构与二次开发
模块化设计
XHS-Downloader 采用模块化设计，便于理解和二次开发：
source/ ├── application/ # 应用层：下载、请求、图片视频处理 ├── module/ # 核心模块：模型、管理器、脚本处理 ├── expansion/ # 扩展功能：浏览器集成、错误处理 ├── CLI/ # 命令行接口 ├── TUI/ # 图形界面 └── translation/ # 多语言支持核心模块功能
| 模块 | 主要功能 | 关键文件 |
|---|---|---|
application/ | 下载逻辑、请求处理、媒体处理 | download.py, request.py, video.py |
module/ | 数据模型、配置管理、脚本处理 | model.py, settings.py, script.py |
expansion/ | 浏览器集成、文件清理、格式转换 | browser.py, cleaner.py, converter.py |
二次开发示例
查看 example.py 文件，了解如何在自己的项目中集成 XHS-Downloader：
from source import XHS async def download_xhs_content(): async with XHS( work_path="./downloads", folder_name="XHS_Content", name_format="{create}_{author}_{title}", cookie="your_cookie_here", folder_mode=True, author_archive=True ) as xhs: result = await xhs.extract( "https://www.xiaohongshu.com/explore/XXX", download=True ) print(result)📊 配置文件详解
配置文件位于./Volume/settings.json，首次运行自动生成。主要配置项包括：
| 配置项 | 类型 | 说明 | 默认值 |
|---|---|---|---|
cookie | string | 小红书网页版 Cookie | 无 |
work_path | string | 作品数据/文件保存根路径 | 项目根路径/Volume |
folder_name | string | 作品文件储存文件夹名称 | Download |
name_format | string | 作品文件名称格式 | 发布时间 作者昵称 作品标题 |
image_format | string | 图文作品文件下载格式 | JPEG |
folder_mode | bool | 是否将每个作品的文件储存至单独的文件夹 | false |
author_archive | bool | 是否将每个作者的作品储存至单独的文件夹 | false |
自定义文件名格式
name_format参数支持多种字段组合：
{收藏数量}、{评论数量}、{分享数量}、{点赞数量}{作品标签}、{作品ID}、{作品标题}、{作品描述}{作品类型}、{发布时间}、{最后更新时间}{作者昵称}、{作者ID}
🛠️ 实用技巧与最佳实践
1. 批量处理脚本示例
#!/usr/bin/env python3 import subprocess import time def batch_process(links_file): with open(links_file, 'r', encoding='utf-8') as f: links = f.readlines() for link in links: link = link.strip() if link: print(f"正在处理: {link}") subprocess.run([ "python", "main.py", "--url", link, "--work_path", "./downloads", "--name_format", "{create}_{author}_{title}", "--folder_mode", "True" ]) time.sleep(2) # 避免请求过于频繁 if __name__ == "__main__": batch_process("links.txt")2. 自动化监控脚本
#!/bin/bash # 监控剪贴板并自动下载新内容 while true; do python main.py --clipboard True sleep 10 done3. 服务器模式部署
对于需要 24 小时运行的服务，可以使用系统服务或进程管理器：
# 使用 systemd（Linux） sudo nano /etc/systemd/system/xhs-downloader.service # 服务文件内容 [Unit] Description=XHS-Downloader API Server After=network.target [Service] Type=simple User=your_user WorkingDirectory=/path/to/XHS-Downloader ExecStart=/usr/bin/python3 main.py api Restart=always RestartSec=10 [Install] WantedBy=multi-user.target📈 性能与优势分析
技术优势
小红书下载工具XHS-Downloader 在技术上具有明显优势：
- 智能去重机制：基于数据库记录，避免重复下载
- 断点续传支持：大文件下载中断后可继续下载
- 多格式支持：支持 PNG、WEBP、JPEG、HEIC 等多种图片格式
- 智能识别：自动识别作品类型（图文/视频/动图）
- 多线程下载：充分利用网络带宽，提升下载速度
性能表现
- 单作品下载时间：图文作品 3-5 秒，视频作品 10-20 秒
- 内存占用：图形界面约 50MB，命令行模式约 30MB
- 并发处理：支持同时处理多个链接，充分利用网络带宽
- 稳定性：内置重试机制和超时处理，确保下载成功率
🎯 总结与展望
XHS-Downloader 不仅仅是一个下载工具，它是一个完整的小红书内容管理解决方案。无论你是：
- 内容创作者：需要整理自己的作品集
- 市场研究员：需要分析竞品内容
- 普通用户：想要保存喜欢的笔记
- 开发者：需要集成内容采集功能
都能在这个开源项目中找到合适的解决方案。项目的活跃社区和持续更新保证了工具的稳定性和功能性，而完全开源的特性让你可以完全掌控自己的数据安全。
立即开始：克隆仓库、安装依赖、运行程序，体验高效的小红书内容采集吧！如果在使用过程中遇到任何问题，欢迎在项目仓库中提交 Issue 或加入社区讨论。
记住：合理使用工具，尊重原创内容，遵守平台规则，让技术为创作赋能，而不是替代创作。
核心关键词：小红书下载工具，无水印下载，内容采集工具，批量处理，开源工具
长尾关键词：小红书作品下载，小红书视频保存，小红书图片采集，批量下载小红书，小红书内容管理工具
【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结果作品、用户链接；采集小红书作品信息；提取小红书作品下载地址；下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
