XHS-Downloader

概覽

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

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

主要功能

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

運作方式 (MCP 模式)

1. 執行 MCP 伺服器：
   Copy

   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 智能代理生態系統，同時保持輕量級架構並獲得持續維護更新。

注意事項：請務必遵守小紅書服務條款與版權規範，負責任地使用本工具。