3分钟掌握XHS-Downloader：小红书内容采集工具完全指南-平芜编程栈

3分钟掌握XHS-Downloader：小红书内容采集工具完全指南

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

还在为无法保存小红书上的精美图片和视频而烦恼吗？想要批量下载喜欢的内容却找不到合适的工具？XHS-Downloader是你需要的完美解决方案！这款开源Python工具专为小红书内容采集而设计，支持多种运行模式，从简单易用的图形界面到强大的命令行操作，再到与AI助手深度集成的MCP模式，满足不同用户的需求。无论是内容创作者需要备份作品，数据分析师收集研究资料，还是普通用户保存喜欢的笔记，XHS-Downloader都能成为你的得力助手！

快速开始：一键安装与配置

环境准备与安装

XHS-Downloader支持多种安装方式，无论你是技术新手还是资深开发者，都能快速上手。

方法一：源码安装（推荐开发者）

首先克隆项目到本地：

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

使用uv工具安装依赖（速度更快）：

uv sync --no-dev

或者使用传统的pip安装：

pip install -r requirements.txt

方法二：直接运行可执行文件

对于Windows和Mac用户，可以直接下载预编译的可执行文件，无需安装Python环境。前往项目Release页面下载对应系统的压缩包，解压后双击运行即可。

获取Cookie解锁高清下载

虽然不配置Cookie也能使用基本功能，但为了获得最佳体验（特别是高清视频下载），建议配置Cookie。Cookie的获取非常简单：

打开浏览器（推荐使用无痕模式），访问小红书网页版
按F12打开开发者工具，切换到"网络"选项卡
勾选"保留日志"，在筛选器中输入cookie-name:web_session
选择"Fetch/XHR"筛选器，点击任意小红书作品
在"网络"选项卡中选择任意数据包，全选复制Cookie值

实用提示：Cookie配置后可以下载更高画质的视频内容，无需登录账号也能使用。

图形界面操作：新手友好的使用方式

主界面功能介绍

启动程序后，你将看到一个简洁直观的操作界面：

python main.py

界面主要分为三个区域：

输入区：粘贴小红书作品链接，支持多个链接用空格分隔
操作区：下载作品文件、读取剪贴板、清空输入框三个主要功能按钮
功能区：通过快捷键快速访问各项功能（Q退出、S设置、R记录等）

操作步骤清单：

复制小红书作品链接
粘贴到输入框中
点击"下载作品文件"按钮
等待下载完成，文件保存在./Volume/Download目录

个性化设置调整

点击S键或选择程序设置，进入配置界面：

在这里你可以调整：

重试次数：网络不稳定时增加重试次数
下载格式：支持PNG、WEBP、JPEG、HEIC等多种图片格式
文件命名：自定义文件名格式，包含发布时间、作者昵称、作品标题等信息
存储模式：是否按作者或作品分类存储
语言选择：支持中文和英文界面

验证方法：修改设置后点击"保存配置"，重启程序查看设置是否生效。

剪贴板监听模式

开启剪贴板监听模式后，你只需在小红书APP或网页上复制链接，工具就会自动检测并开始下载：

实用技巧：这个功能特别适合批量下载，你可以连续复制多个链接，工具会按顺序处理。下载完成后，还能看到详细的处理记录，包括每个文件的状态和保存路径。

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

脚本安装一步到位

如果你更喜欢在浏览器中操作，XHS-Downloader提供了用户脚本，可以在小红书网页版上直接使用！

安装步骤：

安装Tampermonkey浏览器扩展
在Tampermonkey中点击"添加新脚本"
复制脚本地址：https://raw.githubusercontent.com/JoeanAmier/XHS-Downloader/refs/heads/master/static/XHS-Downloader.js
点击"从URL安装"，粘贴地址后确认

脚本功能详解

安装完成后，访问小红书网页版，你会在页面上看到新增的下载按钮：

脚本支持的功能包括：

一键提取：自动获取当前页面的所有作品链接
智能滚动：自动加载更多内容，无需手动翻页
批量推送：将选中的作品推送到本地服务器下载
自定义筛选：按需选择要下载的图片和视频

操作示例：

打开小红书用户主页
点击用户脚本菜单中的"提取发布作品链接"
脚本会自动滚动页面收集所有链接
复制链接到XHS-Downloader进行批量下载

命令行模式：批量处理与自动化

基础命令使用

对于需要批量处理或自动化需求的用户，命令行模式更加高效：

# 下载单个作品 python main.py --url "https://www.xiaohongshu.com/explore/作品ID" # 批量下载多个作品 python main.py --url "链接1 链接2 链接3" --download true # 指定保存路径和格式 python main.py --url "链接" --work_path "./downloads" --image_format "WEBP" # 使用代理下载 python main.py --url "链接" --proxy "http://127.0.0.1:10808"

高级参数配置

命令行模式支持所有图形界面中的功能，而且可以轻松集成到脚本中：

常用参数说明：

--url：小红书作品链接（必需参数）
--download：是否下载作品文件
--index：下载指定序号的图片文件（仅对图文作品生效）
--cookie：请求数据时使用的Cookie
--proxy：网络代理设置
--skip：是否跳过已下载的作品

批量处理示例：

# 从文件读取链接批量下载 python main.py --url "$(cat links.txt)" --download true # 下载图文作品的部分图片 python main.py --url "链接" --index 1 3 5 --download true

高级功能：API与MCP集成

API服务器模式

XHS-Downloader提供了完整的API接口，便于集成到其他系统中：

启动API服务器：

python main.py api

访问http://127.0.0.1:5556/docs查看交互式API文档。API支持POST请求，参数包括作品链接、下载选项、图片序号选择等。

API调用示例：

import requests def download_via_api(note_url): api_url = "http://127.0.0.1:5556/xhs/detail" payload = { "url": note_url, "download": True, "index": [1, 3, 5], "proxy": "http://127.0.0.1:10808" } response = requests.post(api_url, json=payload) return response.json()

MCP模式与AI助手集成

通过MCP（Model Context Protocol）模式，可以将XHS-Downloader集成到AI助手工作流中：

启动MCP服务器：

python main.py mcp

配置MCP客户端，添加新的MCP服务器：

类型：可流式传输的HTTP
URL：http://127.0.0.1:5556/mcp/

配置完成后，AI助手可以直接调用XHS-Downloader功能，实现智能化的内容采集和处理。

实用技巧与最佳实践

文件管理优化

命名规范建议：

使用"发布时间作者昵称作品标题"格式，便于搜索和整理
避免使用特殊字符，确保文件系统兼容性
考虑添加作品ID，便于去重和索引

分类存储策略：

启用author_archive：按作者分类存储
启用folder_mode：每个作品独立文件夹
定期清理重复文件，节省存储空间

批量处理工作流

高效收集技巧：

使用用户脚本提取某个作者的所有作品链接
将链接保存到文本文件中

使用命令行批量下载：

python main.py --url "$(cat author_links.txt)" --download true

定时自动化：

创建批处理脚本，设置定时任务
每天自动下载关注的作者新作品
适合内容监控和数据分析场景

常见问题解决

问题：下载速度慢怎么办？

检查网络连接，尝试使用代理
调整同时下载的任务数量
设置合理的超时时间和重试次数

问题：某些链接无法下载？

确保链接格式正确
检查Cookie是否有效
尝试更新工具到最新版本

问题：内存占用过高？

减少同时下载的文件数量
关闭不必要的后台程序
使用流式下载模式

项目结构与扩展开发

源码目录解析

XHS-Downloader采用模块化设计，核心代码位于source/目录：

source/application/：核心应用逻辑，包括作品解析、下载、请求处理
source/expansion/：扩展功能模块，如浏览器Cookie读取、文件清理、格式转换
source/module/：基础模块，包括数据模型、设置管理、工具函数
source/TUI/：终端用户界面实现
source/CLI/：命令行接口实现

二次开发指南

查看 example.py 文件获取完整的API调用示例，包括异步调用、参数配置和错误处理的最佳实践。

自定义功能开发：

了解项目架构和模块依赖
参考现有模块实现新功能
测试确保兼容性和稳定性
提交Pull Request贡献代码

Docker部署方案

对于企业级部署，推荐使用Docker容器化方案：

# 拉取镜像 docker pull joeanamier/xhs-downloader # 运行容器（TUI模式） docker run -p 5556:5556 -v xhs_data:/app/Volume -it joeanamier/xhs-downloader # 运行容器（API模式） docker run -p 5556:5556 -v xhs_data:/app/Volume -it joeanamier/xhs-downloader python main.py api

合规使用与注意事项

在使用XHS-Downloader时，请务必注意以下事项：

合规使用原则：

仅下载用于个人学习、研究或备份的内容
避免高频请求，设置合理的采集间隔
不收集、存储或传播用户隐私信息
不要用于商业侵权或恶意爬取

技术注意事项：

作品链接携带日期信息，使用过期链接可能被风控
建议使用最新获取的作品链接进行下载
Windows系统需要管理员权限读取浏览器Cookie
开启保存作品数据功能时，数据默认存储在./Volume/Download/ExploreData.db

总结与进阶资源

XHS-Downloader作为一款功能全面的小红书内容采集工具，在开源社区中获得了广泛认可。其多模式支持、灵活配置和强大的扩展性，使其不仅适合普通用户快速下载内容，也适合开发者进行二次开发和集成。

核心功能回顾：

✅ 支持多种链接格式和批量处理
✅ 无水印高清内容下载
✅ 智能去重和文件管理
✅ 多种运行模式（图形界面、命令行、API、MCP）
✅ 浏览器脚本集成
✅ Docker容器化部署

最佳实践建议：

首次使用时先配置Cookie以获得最佳体验
根据需求选择合适的运行模式
合理设置文件命名规则和存储结构
结合用户脚本实现浏览器内便捷操作
定期更新到最新版本以获得新功能和修复

进阶学习资源：

查看 source/application/ 了解核心实现
参考 source/expansion/ 学习扩展功能
阅读 source/module/ 掌握基础模块
探索 source/translation/ 了解国际化支持

无论是个人用户的内容收藏，还是专业团队的内容分析需求，XHS-Downloader都能提供稳定可靠的解决方案。其开源特性确保了透明度和可定制性，活跃的社区支持也为问题解决和功能改进提供了保障。现在就开始你的小红书内容管理之旅吧！

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

3分钟掌握XHS-Downloader：小红书内容采集工具完全指南