# XHS-Downloader

XHS-Downloader 是一款功能強大的開源工具，專門用於從小紅書（小紅書 / REDnote / XHS）提取連結、收集資訊，以及下載無浮水印的圖片、影片和筆記。它包含內建的 MCP 伺服器支援，讓 AI 代理能夠自動化內容蒐集和下載。

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

Language: zh-TW

Category: MCP Servers

Updated: 2026-04-11

## 概覽

**XHS-Downloader** (由 JoeanAmier 開發) 是一款專注於小紅書 (又名 REDnote 或 XHS) 的熱門開源 Python 工具。它擅長連結擷取、筆記資訊收集，並能下載**無浮水印**的高品質媒體檔案 (圖片、影片、實況照片)。

該專案支援批次處理使用者的發文、收藏、點讚、專輯及搜尋結果。重要的是，它包含原生 **MCP (模型情境協定) 伺服器模式**，允許 AI 程式碼助理及助手 (如 Claude Desktop、Cursor 等) 直接控制下載、擷取及內容收集任務。

## 主要功能

: **連結擷取**: 擷取已發佈貼文、收藏夾、點讚、專輯連結、搜尋結果和使用者連結。
: **筆記資訊收集**: 收集小紅書筆記的詳細元資料。
: **無浮水印下載**: 下載高品質圖片、影片和實況照片。
: **批次處理與去重**: 使用本地資料庫自動跳過已下載過的筆記。
: **MCP 伺服器模式**: 作為 MCP 伺服器執行 (`python main.py mcp`) 以便整合 AI 代理。
: **斷點續傳與自訂命名**: 支援可恢復下載及自訂檔案名稱格式。
: **API 與使用者腳本支援**: 可搭配瀏覽器使用者腳本實現一鍵推送任務。
: **CLI + GUI 模式**: 簡易程式執行或原始碼運行。

## 運作方式 (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

- xhs
- 小紅書
- rednote
- 下載器
- mcp
- mcp-server
- python
- 爬蟲
- 影片下載器
- 圖片下載器
- 無浮水印

## Sources

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