JoeanAmier/XHS-Downloader

解決する問題

小红书（RedNoteとも呼ばれる）は、ユーザーが写真、動画、テキスト投稿を共有するソーシャルプラットフォームです。これらの投稿を直接ダウンロードする公式な方法はありません。このツールは、ユーザーが投稿リンクを貼り付け、画像、動画、カバー、ライブ写真など、ダウンロード可能なすべてのコンテンツを自動的に抽出してローカルに保存できるようにすることで、この問題を解決します。また、複数のリンクを同時に処理し、既にダウンロード済みのファイルをスキップすることもできます。

仕組み

このプログラムは、小红书の投稿URL（xhslink.comなどの短縮リンクを含む）を解析し、プラットフォームのウェブデータを使用して投稿の情報とダウンロードリンクを取得します。使用する方法はいくつかあります：

• 対話型使用のためのグラフィカルユーザーインターフェース（GUI）とターミナルユーザーインターフェース（TUI）。
• スクリプト化または一括ダウンロード用のコマンドラインモード。
• ローカルサーバー（ポート5556）を実行し、他のプログラムがHTTP経由で投稿データを要求したりダウンロードをトリガーしたりできるAPIモード。
• AIアシスタントや類似ツールがダウンローダーを呼び出せるようにするMCP（モデルコンテキストプロトコル）モード。
• 発見ページ、ユーザープロフィール、検索などのページから投稿リンクを抽出し、実行中のプログラムにダウンロードタスクをプッシュできるブラウザユーザースクリプト（Tampermonkey用）。

設定は settings.json ファイルに保存され、プログラムはCookie（オプションですが、動画品質を向上させます）を読み取り、必要に応じてプロキシを使用できます。また、プラットフォームに過負荷をかけないようにするための遅延メカニズムもあります。

対象ユーザー

個人のアーカイブ、研究、その他の正当な目的のために小红书からコンテンツをダウンロードしたいすべての人を対象としています。APIとMCPインターフェースを提供し、ソースコードをライブラリとして使用できるため、小红书のコンテンツ取得を独自のアプリケーションに統合したい開発者にも役立ちます。

主な特長

• 複数の実行方法：GUI、TUI、CLI、Docker、APIサーバー、MCPサーバー。
• 画像、動画（Cookieを提供すると高品質）、動画カバー、ライブ写真をダウンロード可能。
• バッチ処理：複数のリンクを一度に提供できます。
• 既にダウンロード済みのファイルを自動的にスキップし、ダウンロード済みの投稿IDを記録します。
• ファイル名とフォルダ構造をカスタマイズ可能。各著者の投稿を別々のフォルダに保存できます。
• インデックスリストを使用して、複数画像の投稿から特定の画像のみをダウンロードすることをサポート。
• ブラウザユーザースクリプトは、サイトの多くの部分から投稿リンクを抽出し、メインプログラムにプッシュできます。
• 不正使用を防ぐために、APIおよびMCPアクセス用の認証が含まれています。