# XHS-Downloader

XHS-Downloader是一款强大的开源工具，专用于从小红书（Little Red Book / REDnote / XHS）提取链接、采集信息并下载无水印图片、视频和笔记。它内置MCP服务器支持，能让AI智能体自动化内容采集与下载任务。

Canonical URL: https://a2a-mcp.org/entry/xhs-downloader-zh

Language: zh

Category: MCP Servers

Updated: 2026-04-11

## 概述

**XHS-Downloader** (作者：JoeanAmier) 是一款专注于小红书（亦称REDnote或XHS）的热门开源Python工具。它擅长链接提取、笔记信息收集以及下载高质量的无水印媒体文件（图片、视频、Live Photos）。

该项目支持对用户帖子、收藏、点赞、专辑和搜索结果进行批量操作。重要的是，它内置了原生的**MCP（模型上下文协议）服务器模式**，允许AI编程代理和助手（如Claude Desktop、Cursor等）直接控制下载、提取和内容收集任务。

## 主要功能

- **链接提取**：提取已发布的帖子、收藏、点赞、专辑链接、搜索结果和用户链接。
- **笔记信息收集**：收集小红书笔记的详细元数据。
- **无水印下载**：高质量下载图片、视频和Live Photos。
- **批量处理与去重**：使用本地数据库自动跳过之前已下载的笔记。
- **MCP 服务器模式**：作为MCP服务器运行 (`python main.py mcp`)，实现与AI代理的集成。
- **断点续传与自定义命名**：支持可恢复的下载和自定义文件名格式。
.

## 工作原理 (MCP 模式)

1. 运行 MCP 服务器：
   ```bash
   python main.py mcp
   ```
2. 服务器将在 `http://127.0.0.1:5556/mcp/`（或配置的端口）进行监听。
3. 将 MCP 服务器添加到您的 AI 客户端配置中。
4. AI 代理可以调用工具来提取链接、收集笔记数据或直接触发下载。

这使得 XHS-Downloader 成为涉及小红书内容的智能代理工作流的强大后端。

## 使用场景

- **AI驱动的内容归档**：让AI代理自动收集和下载特定用户的笔记或主题。
, 策展或备份。
- **无水印媒体保存**：获取纯净的素材供个人、教育或创意使用。
- **数据收集流水线**：与其他MCP工具集成，用于研究或分析小红书趋势。
- **自动化脚本**：与浏览器用户脚本结合，实现无缝工作流。

## 快速开始

### 快速运行 (推荐)
- 从 [GitHub Releases](https://github.com/JoeanAmier/XHS-Downloader/releases) 下载最新版本。
- 解压并运行可执行文件（Windows/macOS上为 `main`）。

### 源代码 + MCP 模式
```bash
git clone https://github.com/JoeanAmier/XHS-Downloader.git
cd XHS-Downloader
pip install -r requirements.txt
python main.py mcp   # 启动 MCP 服务器
```

要了解包括用户脚本和API用法在内的全部功能，请参阅 [README](https://github.com/JoeanAmier/XHS-Downloader/blob/master/README_EN.md)。

## 优势

XHS-Downloader以其可靠性、去重能力、可恢复下载及对MCP的直接支持而脱颖而出——成为小红书内容处理领域最先进的开源工具之一。它既能满足手动用户需求，又能有效服务AI智能体生态系统，同时保持轻量级设计和活跃的维护状态。

**注意事项**：请负责任地使用，并遵守小红书平台的服务条款与版权规范。

## Tags

- 小红书
- 红书笔记
- 下载器
- MCP
- MCP服务器
- Python
- 爬虫
- 视频下载器
- 图片下载器
- 无水印

## Sources

- [Project website](https://github.com/JoeanAmier/XHS-Downloader)