当前位置：首页 > news >正文

XHS-Downloader：小红书作品采集的终极解决方案，四合一模式满足所有使用场景

news 2026/8/3 16:28:23

XHS-Downloader：小红书作品采集的终极解决方案，四合一模式满足所有使用场景

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

XHS-Downloader 是一个功能强大的小红书作品采集工具，专为需要高效提取和下载小红书内容的用户设计。无论是个人收藏、内容分析还是批量采集，这个开源项目都能提供完整的解决方案。在前100字内，我们重点介绍项目的核心功能：支持TUI图形界面、命令行、API和MCP四种运行模式，能够智能提取账号发布、收藏、点赞、专辑作品链接，并下载无水印作品文件，为小红书内容采集提供一站式服务。

📊 项目定位与技术价值

XHS-Downloader 解决了小红书内容采集的多个痛点问题。传统的小红书内容采集往往面临反爬机制严格、链接格式多样、文件管理混乱等挑战。该项目通过智能解析算法和多层反爬策略，为开发者提供了一个稳定可靠的采集框架。

从技术架构上看，XHS-Downloader 基于 Python 3.12 开发，采用了现代化的异步编程模型。核心模块位于 source/application/ 目录中，包含了下载、请求、图片处理等关键组件。项目使用 FastAPI 提供 RESTful API 接口，Textual 框架构建终端图形界面，同时支持 MCP 协议与现代AI工具链集成。

🚀 四大运行模式详解

1. 图形界面模式：新手友好的一键操作

对于不熟悉命令行的用户，TUI 图形界面提供了最直观的操作体验。启动程序后，你只需粘贴小红书链接，点击下载按钮即可完成作品采集。界面设计简洁明了，支持批量链接处理、剪贴板监听等实用功能。

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

命令行模式适合需要批量处理或自动化脚本的用户。通过丰富的参数配置，你可以精确控制下载行为：

python main.py --url "作品链接" --image-format WEBP --folder-mode true

支持的关键参数包括：

--index：指定下载图文作品的图片序号
--proxy：设置网络代理
--name-format：自定义文件命名规则
--author-archive：按作者归档作品

3. API服务器模式：系统集成的桥梁

API 模式允许你将 XHS-Downloader 集成到其他系统中。启动 API 服务器后，你可以通过 HTTP 请求调用下载功能：

import requests response = requests.post( "http://127.0.0.1:5556/xhs/detail", json={ "url": "小红书作品链接", "download": True, "index": [1, 3, 5] } )

4. MCP模式：AI助手集成方案

MCP 模式让 XHS-Downloader 能够与支持 Model Context Protocol 的 AI 助手无缝集成。配置完成后，你可以通过自然语言指令控制作品下载，极大提升了操作效率。

⚙️ 核心特性与智能功能

智能链接解析引擎

XHS-Downloader 支持多种小红书链接格式：

标准作品链接：https://www.xiaohongshu.com/explore/作品ID
发现页链接：https://www.xiaohongshu.com/discovery/item/作品ID
用户作品链接：https://www.xiaohongshu.com/user/profile/作者ID/作品ID
短链接格式：https://xhslink.com/分享码

程序会自动识别并提取有效作品ID，支持批量处理多个链接，用空格分隔即可。

多格式文件支持

项目支持多种文件格式下载：

图文作品：AUTO、PNG、WEBP、JPEG、HEIC
视频作品：MP4格式，支持分辨率优先、码率优先、文件大小优先三种偏好设置
LivePhoto：动态图片文件下载

智能文件管理

XHS-Downloader 提供了完善的文件管理策略：

自动跳过已下载作品，避免重复下载
支持断点续传，网络中断后可从断点继续下载
可按作者归档作品，自动更新作者昵称
自定义文件命名格式，支持作品标题、作者昵称、发布时间等变量

🛠️ 快速部署指南

方式一：预编译程序直接运行

对于 Windows 和 macOS 用户，最简单的部署方式是下载预编译的可执行文件：

从项目仓库下载对应系统的压缩包
解压后直接运行main程序文件
首次运行会自动生成配置文件

方式二：源码运行（推荐开发者）

使用源码运行可以获得最大的灵活性：

# 克隆项目 git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader # 进入项目目录 cd XHS-Downloader # 使用 uv 安装依赖（推荐） uv sync --no-dev # 启动程序 uv run main.py

方式三：Docker容器化部署

对于服务器环境或需要隔离运行的用户，Docker 是最佳选择：

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

🔧 配置优化技巧

关键配置参数详解

配置文件位于./Volume/settings.json，首次运行自动生成。以下是一些关键配置项：

{ "user_agent": "Mozilla/5.0...", "cookie": "web_session=xxx; webId=xxx", "proxy": "http://127.0.0.1:10808", "image_format": "WEBP", "folder_mode": true, "author_archive": true, "script_server": true }

Cookie配置技巧

虽然 Cookie 不是强制配置项，但配置 Cookie 可以获得更好的体验：

获取更高画质的视频文件
减少请求频率限制
提高采集成功率

获取 Cookie 的方法很简单：访问小红书网页版，打开开发者工具，在网络请求中复制web_session和webId等关键 Cookie 值即可。

网络优化建议

代理设置：如果遇到网络问题，可以在配置文件中设置代理
请求延迟：项目内置了智能延迟机制，避免触发反爬
超时设置：根据网络状况调整timeout参数

🌐 浏览器用户脚本集成

XHS-Downloader 提供了强大的浏览器用户脚本，与主程序联动实现无缝采集体验：

Tampermonkey脚本安装

安装 Tampermonkey 浏览器扩展
添加用户脚本：从项目仓库获取脚本链接
启用脚本并配置服务器连接

脚本核心功能

用户脚本提供以下实用功能：

一键提取：在作品页面直接提取下载链接
批量采集：自动滚动页面采集多个作品
智能推送：将任务推送到本地运行的 XHS-Downloader
多类型采集：支持发布、收藏、点赞、专辑作品链接提取

🎯 高级应用场景

批量账号作品采集

使用用户脚本可以高效采集整个账号的所有作品：

访问目标用户主页
点击脚本菜单中的"提取账号发布作品链接"
脚本自动滚动页面加载所有作品
复制生成的链接列表
在 XHS-Downloader 中批量下载

搜索结果内容分析

对于特定关键词的内容分析：

在小红书搜索页面输入关键词
使用脚本"提取搜索结果作品链接"
设置滚动次数（默认50次）
获取搜索结果中的所有作品链接进行批量分析

自定义数据管道

通过 API 模式，你可以构建自定义的数据处理管道：

from source.module import XHS async def custom_pipeline(): async with XHS() as xhs: # 获取作品信息但不下载 info = await xhs.extract(link, download=False) # 自定义数据处理逻辑 processed_data = process_info(info) # 根据需要决定是否下载 if should_download(processed_data): await xhs.extract(link, download=True)