XHS-Downloader
XHS-Downloader 是一款功能強大的開源工具，專門用於從小紅書（小紅書 / REDnote / XHS）提取連結、收集資訊，以及下載無浮水印的圖片、影片和筆記。它包含內建的 MCP 伺服器支援，讓 AI 代理能夠自動化內容蒐集和下載。
概覽
XHS-Downloader (由 JoeanAmier 開發) 是一款專注於小紅書 (又名 REDnote 或 XHS) 的熱門開源 Python 工具。它擅長連結擷取、筆記資訊收集，並能下載無浮水印的高品質媒體檔案 (圖片、影片、實況照片)。
該專案支援批次處理使用者的發文、收藏、點讚、專輯及搜尋結果。重要的是，它包含原生 MCP (模型情境協定) 伺服器模式，允許 AI 程式碼助理及助手 (如 Claude Desktop、Cursor 等) 直接控制下載、擷取及內容收集任務。
主要功能
: 連結擷取: 擷取已發佈貼文、收藏夾、點讚、專輯連結、搜尋結果和使用者連結。
: 筆記資訊收集: 收集小紅書筆記的詳細元資料。
: 無浮水印下載: 下載高品質圖片、影片和實況照片。
: 批次處理與去重: 使用本地資料庫自動跳過已下載過的筆記。
: MCP 伺服器模式: 作為 MCP 伺服器執行 (python main.py mcp) 以便整合 AI 代理。
: 斷點續傳與自訂命名: 支援可恢復下載及自訂檔案名稱格式。
: API 與使用者腳本支援: 可搭配瀏覽器使用者腳本實現一鍵推送任務。
: CLI + GUI 模式: 簡易程式執行或原始碼運行。
運作方式 (MCP 模式)
- 執行 MCP 伺服器：
python main.py mcp - 伺服器將監聽
http://127.0.0.1:5556/mcp/(或設定的連接埠)。 - 將此 MCP 伺服器新增至您的 AI 用戶端配置中。
- 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 智能代理生態系統，同時保持輕量級架構並獲得持續維護更新。
注意事項：請務必遵守小紅書服務條款與版權規範，負責任地使用本工具。
Tags
Related Entries
Keep exploring similar tools and resources in this category.
Related Reads
Background, tutorials, and protocol context connected to this entry.
