Rednote MCP

🚀 RedNote MCP - 小红书コンテンツ検索ツール

RedNote MCPは、小红书（Red Book）プラットフォームからコンテンツを検索および取得するためのモデルコンテキストプロトコル（MCP）サーバーです。自動ログイン管理と並列処理機能を備え、インテリジェントなコンテンツ抽出を提供します。

🚀 クイックスタート

このツールを使用するには、まずインストールと設定が必要です。詳細な手順は以下の「📦 インストール」セクションを参照してください。設定が完了したら、MCPクライアントで検索ツールを使用できます。

✨ 主な機能

• スマート検索：小红书上でキーワードに基づくコンテンツ検索
• 自動ログイン：自動的なクッキー管理とログイン処理
• 並列処理：効率的な同時コンテンツ取得
• 豊富なデータ抽出：
  • ノートのタイトルと内容
  • 作者情報と説明
  • インタラクション指標（いいね、お気に入り、コメント）
  • 画像とハッシュタグ
  • ノートの直接リンク

🔧 技術詳細

技術スタック

データ構造

interface RedBookNote {
  title: string;        // ノートのタイトル
  content: string;      // ノートの内容
  author: string;       // 作者名
  authorDesc?: string;  // 作者の説明
  link: string;         // ノートのURL
  likes?: number;       // いいね数
  collects?: number;    // お気に入り数
  comments?: number;    // コメント数
  tags?: string[];      // ハッシュタグのリスト
  images?: string[];    // 画像のURL（WebP形式）
}

📦 インストール

前提条件

• Node.js 18+
• pnpmパッケージマネージャ

セットアップ

1. リポジトリをクローンします：

git clone <repository-url>
cd rednote-mcp

2. 依存関係をインストールします：

pnpm install

3. Playwrightのブラウザをインストールします：

pnpm exec playwright install

4. プロジェクトをビルドします：

pnpm build

💻 使用例

基本的な使用法

MCPサーバーの起動

pnpm start

開発モード

pnpm dev

テスト

pnpm test

高度な使用法

Claude Desktopの設定

Claude Desktopの設定ファイルに以下の設定を追加します。 Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "rednote-mcp": {
      "command": "node",
      "args": [
        "C:\\ABSOLUTE\\PATH\\TO\\rednote-mcp\\build\\index.js"
      ]
    }
  }
}

macOS/Linuxユーザー向け:

{
  "mcpServers": {
    "rednote-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/rednote-mcp/build/index.js"
      ]
    }
  }
}

パスを実際のプロジェクトディレクトリに置き換えてください。

その他のMCPクライアント

他のMCP互換クライアントの場合は、ビルドされたサーバーファイルを使用します。

node build/index.js

設定が完了したら、MCPクライアントで以下のように検索ツールを使用できます。

Search for "food recommendation" on Xiaohongshu

このツールは、タイトル、内容、作者情報、画像を含む構造化データを返します。

📚 ドキュメント

開発

プロジェクト構造

rednote-mcp/
├── src/
│   ├── index.ts          # MCPサーバーのエントリポイント
│   └── xiaohongshu.ts    # コアのスクレイピングロジック
├── cookies/              # 自動生成されるクッキーの保存先
├── results/              # オプション: 保存された検索結果
├── build/                # コンパイルされたJavaScriptの出力先
├── package.json
├── tsconfig.json
└── README.md

利用可能なスクリプト

• pnpm build - TypeScriptをJavaScriptにビルドする
• pnpm start - ビルドされたMCPサーバーを実行する
• pnpm dev - 自動リロード機能付きの開発モード
• pnpm test - テストを実行する（利用可能な場合）
• pnpm clean - ビルドディレクトリをクリーンアップする

トラブルシューティング

一般的な問題

1. ログインが必要：ログインプロンプトが表示された場合は、cookies/ディレクトリを削除して再起動してください。
2. タイムアウトエラー：MCPクライアントのタイムアウト設定を増やしてください。
3. ブラウザが見つからない：pnpm exec playwright installを実行してブラウザをインストールしてください。
4. パーミッションエラー：プロジェクトディレクトリに適切な読み書き権限があることを確認してください。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。

⚠️ 重要提示

このツールは教育および研究目的で提供されています。このツールを使用する際は、小红书の利用規約とレート制限を尊重してください。

💡 使用建议

• 初回実行時には、小红书への手動ログインが必要です。
• 初期の検索には、ブラウザの起動とコンテンツの読み込みにより、30 - 60秒かかる場合があります。
• 同時リクエストは3つに制限されており、プラットフォームの制限を回避するためです。
• 画像はWebP形式で提供されます。
• ログイン状態は自動的に保存され、再利用されます。