# XHS-Downloader

XHS-Downloaderは、小红书（リトルレッドブック / REDnote / XHS）から透かしなしの画像、動画、ノートのリンクを抽出し、情報を収集してダウンロードできる強力なオープンソースツールです。組み込みのMCPサーバーサポートにより、AIエージェントがコンテンツ収集とダウンロードを自動化できます。

Canonical URL: https://a2a-mcp.org/entry/xhs-downloader-ja

Language: ja

Category: MCP Servers

Updated: 2026-04-11

## 概要

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

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

## ユースケース

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

## 始め方

### クイック実行 (推奨)
- [GitHub リリース](https://github.com/JoeanAmier/XHS-Downloader/releases) から最新リリースをダウンロード。
- 解凍して実行ファイルを実行（Windows/macOS では `main`）。

### ソースコード + MCP モード
```bash
git clone https://github.com/JoeanAmier/XHS-Downloader.git
cd XHS-Downloader
pip install -r requirements.txt
python main.py mcp   # MCP サーバーを起動
```

ユーザースクリプトや API 使用を含む全機能については、[README](https://github.com/JoeanAmier/XHS-Downloader/blob/master/README_EN.md) を参照してください。

## メリット

XHS-Downloaderは、信頼性、重複排除、レジューム可能なダウンロード、そして直接的なMCPサポートにより際立っています — これは、Xiaohongshuコンテンツ処理における最も先進的なオープンソースツールの一つとなっています。手動ユーザーとAIエージェントエコシステムの両方に効果的にサービスを提供しながら、軽量かつ活発にメンテナンスされています。

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

## Tags

- xhs
- xiaohongshu
- rednote
- ダウンローダー
- mcp
- mcp-server
- python
- スクレイパー
- 動画ダウンローダー
- 画像ダウンローダー
- 透かしなし

## Sources

- [Project website](https://github.com/JoeanAmier/XHS-Downloader)