XHS-Downloader

概要

XHS-Downloader (by JoeanAmier) は、小红书（REDnote または XHS とも呼ばれる）専用の人気オープンソース Python ツールです。リンク抽出、ノート情報収集、および透かしなしの高品質メディアファイル（画像、動画、ライブフォト）のダウンロードに優れています。

このプロジェクトは、ユーザーの投稿、コレクション、いいね、アルバム、および検索結果のバッチ操作をサポートしています。重要な点として、ネイティブの MCP (Model Context Protocol) サーバーモード を含んでおり、AI コーディングエージェントやアシスタント（Claude Desktop、Cursor など）がダウンロード、抽出、コンテンツ収集タスクを直接制御できます。

主な機能

• リンク抽出: 公開済み投稿、お気に入り、いいね、アルバムリンク、検索結果、およびユーザーリンクを抽出。
• ノート情報収集: 小红书ノートの詳細なメタデータを収集。
• 透かしなしダウンロード: 高品質の画像、動画、ライブフォトをダウンロード。
• バッチ処理 & 重複排除: ローカルデータベースを使用して以前にダウンロードしたノートを自動スキップ。
• MCP サーバーモード: MCP サーバーとして実行 (python main.py mcp) して AI エージェントと統合。
• 中断再開 & カスタム命名: ダウンロードの再開可能サポートおよびカスタマイズ可能なファイル名フォーマット。
• API & ユーザースクリプト対応: ブラウザユーザースクリプトと連携してワンクリックでタスクをプッシュ。
• CLI + GUI モード: プログラムの簡単な実行またはソースコード実行。

仕組み (MCP モード)

1. MCP サーバーを実行:
   python main.py mcp
   

2. サーバーは http://127.0.0.1:5556/mcp/（または設定されたポート ）でリッスンします。
3. AI クライアントの設定に MCP サーバーを追加します。
4. AI エージェントはツールを呼び出してリンクを抽出、ノートデータを収集、またはダウンロードを直接トリガーできます。

これにより、XHS-Downloader は小红书コンテンツに関連するエージェントワークフローにおいて強力なバックエンドとなります。

ユースケース

• AI パワードコンテンツアーカイブ: AI エージェントに特定のユーザーノートやトピックを自動的に収集・ダウンロードさせる。
• バッチメディアダウンロード: 小红书投稿の大規模な調査、キュレーション、またはバックアップ。
• 透かしなしメディア保存: 個人的、教育的、または創造的な用途のためのクリーンなアセットを取得。
• データ収集パイプライン: 他の MCP ツールと統合して XHS トレンドの調査や分析を行う。
• 自動化スクリプト: ブラウザユーザースクリプトと組み合わせてシームレスなワークフローを実現。

始め方

クイック実行 (推奨)

• GitHub リリース から最新リリースをダウンロード。
• 解凍して実行ファイルを実行（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サポートにより際立っています — これは、Xiaohongshuコンテンツ処理における最も先進的なオープンソースツールの一つとなっています。手動ユーザーとAIエージェントエコシステムの両方に効果的にサービスを提供しながら、軽量かつ活発にメンテナンスされています。

注意: 責任を持って使用し、Xiaohongshuの利用規約と著作権を尊重してください。