JoeanAmier/XHS-Downloader

解決する課題

XHS-Downloaderは、ソーシャルメディアプラットフォームのXiaohongshu (RedNote) からコンテンツを抽出・ダウンロードするために設計されたツールです。ワーク情報を自動的に収集し、ファイルを一括でダウンロードする方法を提供することで、投稿、画像、動画を手動で保存する問題を解決します。

仕組み

このプロジェクトは、主に3つのインターフェースを通じて動作します：

1. スタンドアロンアプリケーション: 実行ファイルとして、またはPython/Docker経由で実行できるTUI (Terminal User Interface) プログラム。クリップボードのリンクを監視し、コンテンツを自動的にダウンロードできます。
2. ユーザースクリプト: ブラウザで動作するTampermonkeyスクリプト。レコメンドページ、ユーザープロフィール、コレクション、検索結果からリンクを抽出し、メインプログラムにプッシュしてダウンロードできます。
3. サーバーモード: APIサーバーまたはMCP (Model Context Protocol) サーバーとしてデプロイ可能。他のアプリケーションやAIエージェントが投稿の詳細をリクエストし、ダウンロードを開始できるようにします。

対象ユーザー

• コンテンツクリエイターおよび研究者: 分析やバックアップのためにXiaohongshuの投稿、画像、動画をアーカイブする必要がある方。
• 開発者: APIまたはMCPを介してXiaohongshuのデータ抽出を自身のワークフローに統合したい方。
• 一般ユーザー: 手動の作業なしに、プラットフォームから高品質なメディアを簡単にダウンロードしたい方。

ハイライト

• 包括的な抽出: 公開された作品、コレクション、いいね、アルバム、検索結果からリンクを抽出することをサポート。
• 柔軟なダウンロード: 画像、動画、LivePhotosをサポートし、ファイル名やフォーマット (PNG, WEBP, JPEG, HEIC) をカスタマイズ可能。
• 統合の容易さ: プログラムによるアクセスのために、APIモードとMCPモードを提供。
• 自動化: クリップボード監視とブラウザスクリプトの統合により、ワンクリックでのタスクプッシュが可能。
• スマートな管理: すでにダウンロード済みのファイルをスキップする仕組みや、ファイルを作者ごとに別々のフォルダに整理する機能を搭載。