XHS-Downloader

概述

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 服务器：

   python main.py mcp
   

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

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

使用场景

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

快速开始

快速运行 (推荐)

• 从 GitHub Releases 下载最新版本。
• 解压并运行可执行文件（Windows/macOS上为 main）。

源代码 + MCP 模式

git clone https://github.com/JoeanAmier/XHS-Downloader.git
cd XHS-Downloader
pip install -r requirements.txt
python main.py mcp   # 启动 MCP 服务器

要了解包括用户脚本和API用法在内的全部功能，请参阅 README 。

优势

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

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