Xiaohongshu (Little Red Book) MCP Server

xiaohongshu-mcp-server

Xiaohongshu（小紅書） — 中国を代表するライフスタイル系ソーシャルメディアプラットフォーム向けのModel Context Protocol（MCP）サーバーです。

画像付きノートの投稿、コンテンツの検索、ノートの詳細表示、アカウントの管理を、AI アシスタントが直接利用できる MCP ツールを通じて行えます。

仕組み

Playwright を使用して、ヘッドレスの Chromium ブラウザーを起動します。

1. XHS のセッション Cookie を読み込みます。
2. XHS ウェブアプリに組み込まれた署名関数を使って、本物の API 署名を生成します。
3. ブラウザーのネットワークコンテキストを通じて API を呼び出します（ボット対策を回避します）。
4. 画像を XHS CDN に直接アップロードします。

UI 要素のブラウザー自動操作は行いません。すべてのやり取りは XHS の内部 API を通じて行われます。

ツール

ツール	説明
check_login_status	ログインしているか確認します
get_login_qrcode	ログイン用 QR コードを生成します
check_qrcode_status	QR コードのスキャン状況を確認して、セッションを保存します
reload_cookies	ディスクから Cookie を再読み込みします
publish_content	タイトル、テキスト、画像、タグを指定して画像付きノートを投稿します
search_feeds	キーワードで XHS のノートを検索します
get_feed_detail	ノートの詳細を取得します
user_profile	ユーザープロフィール情報を取得します

インストール

pip install xiaohongshu-mcp-server
playwright install chromium

QR コード画像の生成（任意）：

pip install "xiaohongshu-mcp[qrcode]"

クイックスタート

1. サーバーを起動する

HTTP モード（Claude Code、Cursor など向け）：

xhs-mcp --transport http --port 18060

stdio モード（Claude Desktop 向け）：

xhs-mcp --transport stdio

2. ログインする

get_login_qrcode ツールを呼び出し、Xiaohongshu アプリで QR コードをスキャンします。次に、返された qr_id と code を使って check_qrcode_status を呼び出します。Cookie は ~/.xhs-mcp/cookies.json に保存され、再起動後も保持されます。

3. 使用する

AI アシスタントに、ノートの投稿やコンテンツの検索などを依頼します。

設定

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "xhs-mcp": {
      "command": "xhs-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}

Claude Code

claude mcp add xhs-mcp --transport http http://localhost:18060/mcp

その後、サーバーを起動します：xhs-mcp

LaunchAgent として設定する（macOS の自動起動）

~/Library/LaunchAgents/com.xhs-mcp.plist を作成します。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.xhs-mcp</string>
    <key>ProgramArguments</key>
    <array>
        <string>/path/to/your/venv/bin/xhs-mcp</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
    <key>StandardOutPath</key>
    <string>/tmp/xhs-mcp.log</string>
    <key>StandardErrorPath</key>
    <string>/tmp/xhs-mcp.err</string>
</dict>
</plist>

launchctl load ~/Library/LaunchAgents/com.xhs-mcp.plist

例：ノートを投稿する

# Via MCP tool call
publish_content(
    title="Hello XHS!",
    content="My first post published via MCP.",
    images=["/path/to/photo.jpg"],
    tags=["MCP", "AI"]
)

必要条件

• Python 3.12+
• Chromium（playwright install chromium でインストール）
• Xiaohongshu アカウント

ライセンス

MIT