xpzouying/xiaohongshu-mcp
MCP for xiaohongshu.com
xiaohongshu-mcp – 小红书（Xiaohongshu）へのAI駆動ブリッジ
概要 – 自己ホスト型サービスで、Model Context Protocol（MCP）を実装し、AIアシスタント（Claude Code、Cursor、VS Code、Open Clawなど）が中国のソーシャルプラットフォーム「小红书（Xiaohongshu）」の読み書きを可能にします。JSON-RPCツール（ログイン、投稿公開、検索、コメント、いいね、収集、ユーザープロフィール取得など）を公開し、MCP互換の任意のクライアントから呼び出すことができます。
主な機能
| ツール | 説明 |
|---|---|
check_login_status |
小红书アカウントがログインしているかどうかを返します。 |
get_login_qrcode |
インタラクティブログイン用のQRコード（Base64）を生成します。 |
publish_content |
テキスト＋画像の投稿を公開します（タイトル、本文、画像URLまたはローカルパス、任意のタグ、スケジュール、可視性、商品リンク）。 |
publish_with_video |
動画投稿を公開します（タイトル、本文、ローカル動画ファイル、任意のタグ、スケジュール、可視性）。 |
list_feeds |
ホームページのおすすめフィードを取得します。 |
search_feeds |
キーワードで小红书を検索し、並び順、タイプ、時間範囲フィルターなどに対応。 |
get_feed_detail |
投稿の詳細（著者情報、インタラクション数、コメントなど）を取得します。 |
post_comment_to_feed / reply_comment_in_feed |
コメントを追加、または特定のコメントに返信します。 |
like_feed / favorite_feed |
投稿にいいね/いいね解除、または収集/収集解除を行います。 |
user_profile |
ユーザーのプロフィールと公開ノートを取得します。 |
はじめに
1. 導入方法の選択
| 方法 | 対象 |
|---|---|
ビルド済みバイナリ – Releases ページから適切な xiaohongshu-mcp と xiaohongshu-login 実行ファイルをダウンロード（macOS Apple Silicon、Windows x64、Linux x64）。 |
|
Docker – 公式イメージ xpzouying/xiaohongshu-mcp をプルして実行（ポート18060を公開、./data をクッキー用、./images をアップロードメディア用にマウント）。 |
|
ソースからビルド – Go 1.22+ が必要。GOPROXY を中国のミラーに設定し、go build ./cmd/mcp と go build ./cmd/login を実行。 |
2. 一度だけログイン
# ログインヘルパーを実行（OSに合ったバイナリを選択）
./xiaohongshu-login-<platform>
ヘッドレスChromiumインスタンスが起動し、QRコードをスキャンするか資格情報を入力します。ツールはクッキーを data/ に保存するため、以降のMCP呼び出しは認証されます。
3. MCPサーバーを起動
# デフォルトのヘッドレスモード（UIなし）
./xiaohongshu-mcp-<platform>
# またはデバッグ用にブラウザを表示
./xiaohongshu-mcp-<platform> -headless=false
サービスは http://localhost:18060/mcp でリッスンします。
4. （任意）エンドポイントを保護
環境変数 AUTH_TOKEN=your-secret を設定するか、-token=your-secret でバイナリを起動します。クライアントは Authorization: Bearer <token> を送信する必要があります。
AIクライアントの接続（Claude Codeでの例）
claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp
claude mcp list # サーバーが接続済みと表示されるはず
これで、任意のClaudeプロンプトからツールを呼び出せます。例：
帮我检查小红书登录状态
アシスタントが check_login_status を呼び出し、結果を報告します。
Cursor（.cursor/mcp.json）、VS Code（.vscode/mcp.json）、Open Claw（MCPorter経由）、Google Gemini CLI、Clineなどでも同様の手順があります。
典型的なワークフロー例
- 画像投稿を公開
帮我写一篇关于春天的笔记，标题《春日漫步》，内容随意，配图 /Users/me/Pictures/flowers.jpg，使用 xiaohongshu-mcp 发布。 - 食べ物関連のノートを検索
在小红书上搜索“川菜”，只要图文笔记，按最新排序，使用 xiaohongshu-mcp。 - 自動コメント
给笔记 123456 的评论 987654 回复‘谢谢分享’，使用 xiaohongshu-mcp。
コミュニティとサポート
- Issue・トラブルシューティング – 一般的なDocker/Windows問題の厳選リストはissue #56を参照。
- Dockerイメージ – Docker Hubからプル。リポジトリにはワンクリック起動用の
docker-compose.ymlが含まれています。 - 貢献 –
CONTRIBUTING.mdを参照。プロジェクトはAll-Contributorsモデルに従っています（31人の貢献者）。 - 寄付 – 収益はすべて慈善団体に寄付されます（
DONATIONS.md参照）。
ライセンスと免責事項
READMEには、ソフトウェアは学習・自動化目的のみで使用し、悪用（スパム、違法コンテンツ）は禁止と記載されています。明示的なライセンスバッジは表示されていないため、正確な条件はリポジトリの LICENSE ファイルを確認してください。
TL;DR
xiaohongshu-mcp はGoベースのDocker対応MCPサーバーで、最新のAIアシスタントが小红书に対してログイン、画像・動画の投稿、検索、コメント、いいね、ユーザーデータ取得などの操作を、標準のJSON-RPCインターフェース経由で行えるようにします。バイナリ、Docker、またはソースからインストールし、一度ログインしてサーバーを起動し、MCP互換のAIツールを http://localhost:18060/mcp に指定します。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト