JoeanAmier/XHS-Downloader

解決的問題

XHS-Downloader 是一款旨在從社群媒體平台小紅書 (RedNote) 提取並下載內容的工具。它透過提供自動收集工作資訊與批次下載檔案的方法，解決了手動儲存貼文、圖片和影片的問題。

工作原理

本專案透過三種主要介面運作：

1. 獨立應用程式： 一個 TUI（終端使用者介面）程式，可以作為執行檔或透過 Python/Docker 執行。它可以監控剪貼簿中的連結並自動下載內容。
2. 使用者腳本： 在瀏覽器中運行的 Tampermonkey 腳本，用於從推薦頁面、使用者個人資料、收藏夾和搜尋結果中提取連結，然後將其推送到主程式進行下載。
3. 伺服器模式： 可以部署為 API 伺服器或 MCP（模型上下文協定）伺服器，允許其他應用程式或 AI 代理請求貼文詳情並觸發下載。

適用對象

• 內容創作者與研究人員： 需要為分析或備份而封存小紅書貼文、圖片和影片的人員。
• 開發者： 希望透過 API 或 MCP 將小紅書數據提取整合到自身工作流程中的使用者。
• 一般使用者： 希望無需手動操作即可從該平台下載高品質媒體的使用者。

亮點

• 全面的提取功能： 支援從已發佈的作品、收藏、點讚、相簿和搜尋結果中提取連結。
• 靈活的下載功能： 支援圖片、影片和 LivePhotos，並具有可自訂的檔案命名與格式（PNG, WEBP, JPEG, HEIC）。
• 整合就緒： 提供 API 模式與 MCP 模式用於程式化存取。
• 自動化： 具備剪貼簿監控與瀏覽器腳本整合功能，實現一鍵推送任務。
• 智慧管理： 包含跳過已下載檔案的機制，以及將檔案按作者分類至不同資料夾的能力。