SocialDataX 小红书 Xiaohongshu XHS RedNote MCP

小红书 MCP | Xiaohongshu MCP | XHS MCP | RedNote MCP

LobeHub ユーザーは、専用の公式サイトへの入口、認証、ソースの設定を含む LobeHub setup / 接続手順 をご利用ください。

この公開リポジトリでは、ホスト型の小红书 MCP / Xiaohongshu MCP / XHS MCP / RedNote MCP サービスの公開接続ドキュメントと MCP メタデータを提供しています。

ソーシャルメディアのリサーチワークフローで使う小红书 MCP、Xiaohongshu MCP、XHS MCP、または RedNote MCP をお探しの場合、このリポジトリには以下が含まれています。

• 公開 MCP メタデータとクライアント設定例
• リモート MCP に対応するクライアント向けのホスト型 streamable-http エンドポイント
• npm ブリッジと mcp-remote の直接利用向けのコマンド／stdio 設定

ビジネス向けの実装は非公開でホストされています。このリポジトリでは、ソーシャルメディアコンテンツのインテリジェンスワークフロー向けの公開接続情報のみを公開しています。

検索エイリアス

この MCP サービスでよく使われる検索語句：

• 小红书 MCP
• 小红书 数据 MCP
• 小红书 搜索 MCP
• 小红书 XHS MCP
• Xiaohongshu MCP
• Xiaohongshu data MCP
• XHS MCP
• XHS data MCP
• RedNote MCP
• RedNote data MCP
• Xiaohongshu note search MCP

サービス

• ホスト型 MCP エンドポイント：https://mcp.socialdatax.com/xhs/mcp
• ホスト型トランスポート：streamable-http
• 認証：Authorization: Bearer <SOCIALDATAX_API_KEY>
• 製品：SocialDataX / 社媒数据助手
• ウェブサイトと API Key の利用：https://socialdatax.com/ai?from=github
• レジストリ名：com.52choujiang/xhs-insights
• 将来のレジストリ名：com.socialdatax/xhs-insights
• 現在の公開機能バージョン：0.1.15（35 ツール）
• ホスト型本番環境：35 ツールを備えた 0.1.15。2026-10-14 にデプロイと認証済みツールの検出を検証済みです。動画ノートは引き続き xhs_search_notes(note_type="video") から利用できます。
• 公式 MCP Registry：0.1.15（active、isLatest=true）。2026-10-14 に公開および検証済みです。
• 公開 GitHub サーバーカード：35 ツールを備えた 0.1.15。2026-10-14 に同期および検証済みです。
• 公開ツールカタログは server-card.json で管理されています。npm ブリッジのバージョンはホスト型ツールカタログとは独立しています。
• npm stdio ブリッジ：[email protected]。ブリッジパッケージのバージョンはホスト型の機能バージョンとは独立しています。

現在の機能には、暗号化ユーザー ID の解決、PGY クリエイタープロフィール、ノートのパフォーマンス、ファンのプロフィールと概要、商品レビューへの返信に対する返信の検索、URL による商品詳細の検索、商品詳細フィールドの名称変更（images から main_images へ。detail_images は変更なし）が含まれています。

プラットフォーム MCP

認証済みリモート MCP に対応するクライアントからは、ホスト型 streamable-http エンドポイントを直接ご利用ください。コマンド／stdio クライアントでは、mcp.json の npm ブリッジを利用するか、mcp-remote を直接設定できます。

npm stdio ブリッジ

Node.js 20.18.1 以降が必要です。

コマンド／stdio のみに対応する MCP クライアントは、npm からブリッジを直接インストールして起動できます。

{
  "mcpServers": {
    "socialdatax-xhs": {
      "command": "npx",
      "args": ["-y", "xiaohongshu-xhs-rednote-mcp"],
      "env": {
        "SOCIALDATAX_API_KEY": "<SOCIALDATAX_API_KEY>"
      }
    }
  }
}

このパッケージは、ローカルの stdio MCP メッセージをホスト型 SocialDataX XHS エンドポイントに転送するだけです。非公開のサービス実装は含まれておらず、API Key も保存しません。

公開ツールカタログは API Key なしで検出できます。ビジネス向けツールの呼び出しには SOCIALDATAX_API_KEY を設定してください。API Key がなくても検出目的でブリッジを起動できますが、ホスト型サービスでビジネスデータを利用するには認証が必要です。

ワークフローの対象範囲

この MCP サービスは、ソーシャルメディアコンテンツのインテリジェンスに関するワークフロー向けに設計されています。アカウントへのログイン、投稿、編集、「いいね」、コメントなどのアカウント操作には対応していません。

対応しているワークフローは次のとおりです。

• 現在の API Key アカウントの SocialDataX ポイント残高を照会します。
• 並べ替え、ノートの種類、公開時刻のフィルターを任意で指定して、キーワードで関連する小紅書のノートを検索します。
• page_token による続きの取得に対応し、キーワードで小紅書の商品を検索します。
• ユーザーから提供された、または商品検索結果からコピーした完全な sku_id を使って、商品詳細を取得します。
• ユーザーから提供された完全な note_id、またはノートリンク、短縮リンク、共有テキストから、PGY／蒲公英の拡張ノート詳細を1件取得します。成功した呼び出しには20ポイントかかり、失敗した場合は課金されません。
• PGY は、登録済みクリエイターのノートにのみ適用されます。商業データが必要な場合に使用し、通常のノートのリクエストには通常の詳細ツールを使用してください。商業データが利用できないことが明示された場合は、未登録（pgy_commercial_data_unavailable）として扱い、別の ID／URL ルートでの再試行は行わないでください。タイムアウト、認証エラー、残高不足は、それぞれ固有のエラーとして扱われます。
• ユーザーから提供された、または商品検索結果からコピーした完全な sku_id を使って、商品レビューを取得します。
• ユーザーから提供された review_id、または xhs_get_product_review_replies からコピーした review_id を使って、商品レビューへの返信に対する入れ子の返信を取得します。不透明な page_token による続きの取得に対応しています。root_review_id は受け付けません。
• タイトルと人気度を含む小紅書の検索ホットリストを読み取ります。
• キーワードまたは語句の一部を指定して、小紅書の検索候補を読み取ります。
• 共有ノートリンク、短縮リンク、共有テキストを構造化されたノート詳細に変換します。
• 呼び出し元がすでにノート ID を持っている場合に、ノート詳細を読み取ります。
• コメント分析用に、ページ分割された第1階層コメントを取得します。
• 第1階層コメントへの返信をページ分割して取得します。
• プロフィールリンク、短縮リンク、共有テキスト、ユーザー ID からクリエイターのプロフィールデータを読み取ります。
• コンテンツスタイルやアカウントの調査用に、ユーザー ID、プロフィールリンク、短縮リンク、共有テキストから、ページ分割されたクリエイターのノート一覧を取得します。
• トピック URL、短縮リンク、共有テキスト、ページ ID から、ページ分割されたタグページのノート一覧を取得します。
• 動画ノートの音声テキスト変換タスクを送信します。送信呼び出しは最大240秒待機する場合があります。未完了のジョブは、終端状態になるまで同じ job_id をポーリングし続けてください。

ツール

ツール	公開されている目的
socialdatax_get_points_balance	現在の API Key アカウントの SocialDataX ポイント残高／积分余额、剩余积分或点数を照会します。
xhs_search_users	page_token によるページネーションに対応し、キーワードで小紅書／小红书のユーザー、アカウント、クリエイターを検索します。ユーザー ID またはプロフィール URL がすでにある場合は、対応するユーザープロフィールツールを使用してください。
xhs_search_notes	小紅書／小红书の投稿を検索します。note_type="video" で動画投稿、note_type="image" で画像投稿を検索でき、並べ替え、公開日時フィルター、page_token による続きの取得に対応します。呼び出し元がすでに投稿リンクまたは note_id を持っており、投稿の詳細が必要な場合は対応する詳細ツールを使用してください。コメント、返信、音声文字起こしには、対応する URL／ID ツールを使用してください。検索のページネーションを続けるには、返された next_page_token 全体を変更せず page_token として渡してください。最初のリクエストでは page_token を省略します。返された note_url を最終回答での表示、参照、保存、出力、転送などに使用する際は、xsec_token を含む URL 全体をそのまま保持してください。note_id からリンクを再構築しないでください。
xhs_search_images	キーワードで小紅書の画像を検索します。各検索結果は関連する投稿の画像 1 枚であり、1 つの投稿から複数の画像が検索される場合があります。ページネーションで結果がそれ以上返されない場合があります。画像投稿を検索するには、note_type="image" を指定して xhs_search_notes を使用してください。
xhs_search_products	page_token による続きの取得に対応し、商品名、ブランド、カテゴリ、または商品関連のクエリで小紅書の商品を検索します。検索語にはこのツールを使用してください。完全な sku_id がすでにある場合（ユーザーから提供されたものを含む）は、代わりに xhs_get_product_detail_by_sku_id または xhs_get_product_reviews を使用してください。商品リンク、sku_id、spu_id、page_token をキーワードとして使用しないでください。商品検索のページネーションを続けるには、返された next_page_token 全体を変更せず page_token として渡してください。途中を省略記号に置き換えたり、切り詰めたり、要約したり、マスクしたりしないでください。
xhs_get_product_detail_by_sku_id	ユーザーから提供された、または xhs_search_products の結果からコピーした完全な sku_id を使って、小紅書の商品詳細を取得します。商品リンクまたは共有テキストから取得する場合は、xhs_get_product_detail_by_url を使用してください。この ID ツールは spu_id、商品リンク、検索キーワードを受け付けません。
xhs_get_product_detail_by_url	商品 URL、短縮リンク、または商品リンクを含む共有テキストから、小紅書の商品詳細を検索なしで取得します。xhs_get_product_detail_by_sku_id と同じフィールドを返します。返された sku_id は商品レビューの取得に使用できます。投稿リンク、プロフィールリンク、単独の共有コードには対応していません。
xhs_pgy_get_note_detail_by_note_id	呼び出し元が完全な note_id をすでに持っている場合、小紅書 PGY／蒲公英の拡張投稿詳細を 1 件取得します。コンテンツ、画像または動画の概要、投稿者、インプレッション、閲覧数、いいね数、保存数、コメント数、シェア数、クリエイターによる画像／動画コラボレーションの中国人民元建て見積もりが含まれます。見積もりは投稿の取引価格ではありません。対象となるのは PGY に登録したクリエイターの投稿のみです。これは通常の公開投稿詳細ではなく、PGY の商業データです。呼び出しが成功すると 20 ポイントが課金され、失敗時には課金されません。
xhs_pgy_get_note_detail_by_note_url	完全な投稿リンク、短縮リンク、または共有テキストから、小紅書 PGY／蒲公英の拡張投稿詳細を 1 件取得します。PGY 商業データとクリエイターによる画像／動画コラボレーションの中国人民元建て見積もりが返されます。見積もりは投稿の取引価格ではありません。対象となるのは PGY に登録したクリエイターの投稿のみです。呼び出しが成功すると 20 ポイントが課金され、失敗時には課金されません。
xhs_pgy_get_creator_profile	完全な user_id を使って、小紅書 PGY／蒲公英のクリエイタープロフィールを取得します。クリエイターおよび商業投稿の規模、協業業種、投稿の中央値、コンテンツタグ、クリエイターによる画像／動画コラボレーションの中国人民元建て見積もりが含まれます。PGY 対象外のアカウントデータには、通常のユーザープロフィールツールを使用してください。呼び出しが成功すると 20 ポイントが課金され、失敗時には課金されません。
xhs_pgy_get_creator_notes_performance	完全な user_id を使って、小紅書 PGY／蒲公英のクリエイター投稿のパフォーマンスを取得します。投稿数、インプレッション／閲覧／エンゲージメントの中央値、エンゲージメント率、動画完視聴率、画像の 3 秒閲読率、コンテンツタグ、投稿データが含まれます。任意の note_scope で daily（デフォルト）または cooperation を選択できます。レスポンスには指定したスコープが返されます。投稿データは最新 15 件までです。notes[] の比較率のみ、プラットフォーム中央値との差を示す符号付きの値であり、負の値や 1 を超える値になる場合があります。同名の概要比較フィールドは 0～1 の不透明なプラットフォーム値であり、混同しないでください。呼び出しが成功すると 20 ポイントが課金され、失敗時には課金されません。
xhs_pgy_get_creator_fans_profile	完全な user_id を使って、PGY のフォロワー分布とデータの日付を取得します。比率は 0～1 の小数で示され、分布が不完全な場合があります。呼び出しが成功すると 20 ポイントが課金され、失敗時には課金されません。
xhs_pgy_get_creator_fans_summary	完全な user_id を使って、PGY のフォロワー数、成長、アクティビティ、閲読、エンゲージメント指標を取得します。期間の終了日と成長期間は指定されていません。呼び出しが成功すると 20 ポイントが課金され、失敗時には課金されません。
xhs_pgy_get_creator_metrics_trend	日付別の中央値と推定コストを取得します。user_id が必要です。note_scope はデフォルトで daily ですが、cooperation には外部店舗の指標が含まれます。中央値は画像＋動画固定、過去 30 日間、全トラフィックが対象です。コストはフィールドごとに対象範囲が異なります。欠損期間はそのまま保持され、日付をまたいで値を合計することはできません。呼び出しが成功すると 20 ポイントが課金され、失敗時には課金されません。
xhs_pgy_get_creator_commercial_overview	PGY の商業指標と推定コストを取得します。user_id が必要です。note_scope はデフォルトで daily ですが、cooperation には外部店舗への訪問が含まれます。呼び出しが成功すると 20 ポイントが課金され、失敗時には課金されません。
xhs_get_product_reviews	ユーザーから提供された、または xhs_search_products の結果からコピーした完全な sku_id を使って、小紅書の商品レビューを取得します。sort_type は general（総合順、デフォルト）または time_descending を指定でき、has_image と page_token による続きの取得にも対応します。ページネーションを続けるには、返された next_page_token 全体を変更せず page_token として渡してください。途中を省略記号に置き換えたり、切り詰めたり、要約したり、マスクしたりしないでください。このツールは spu_id、商品リンク、検索キーワードを受け付けません。
xhs_get_product_review_replies	小紅書の商品レビューに対する第 1 階層の返信を取得します。ユーザーから提供された review_id を使用するか、xhs_get_product_reviews から取得してください。不透明な page_token による続きの取得に対応します。ページネーションを続けるには、返された next_page_token 全体を変更せず page_token として渡してください。途中を省略記号に置き換えたり、切り詰めたり、要約したり、マスクしたりしないでください。このツールは root_review_id を受け付けません。
xhs_get_product_review_reply_replies	小紅書の商品レビューへの返信に対する、入れ子になった返信を取得します。ユーザーから提供された返信の review_id を使用するか、xhs_get_product_review_replies から取得してください。不透明な page_token による続きの取得に対応します。ページネーションを続けるには、返された next_page_token 全体を変更せず page_token として渡してください。途中を省略記号に置き換えたり、切り詰めたり、要約したり、マスクしたりしないでください。このツールは root_review_id を受け付けません。
xhs_get_search_hot_list	小紅書／小红书の検索急上昇リストを、各項目のタイトルと注目度とともに取得します。
xhs_search_suggestions	キーワードまたはフレーズの一部から、小紅書／小红书の検索候補を取得します。候補のテキスト、検索対象、任意の説明が含まれます。
xhs_get_note_detail_by_note_url	共有された XHS リンク、短縮リンク、または共有テキストを、構造化された投稿詳細に解決します。返された note_url を最終回答での表示、参照、保存、出力、転送などに使用する際は、xsec_token を含む URL 全体をそのまま保持してください。note_id からリンクを再構築しないでください。note_url が null の場合、note_id から公開リンクを合成したり再構築したりしないでください。
xhs_get_note_detail_by_note_id	呼び出し元がすでに投稿 ID を持っている場合、構造化された投稿詳細を取得します。note_url が返された場合は、最終回答での表示、参照、保存、出力、転送など、使用するすべての場面で xsec_token を含む URL 全体をそのまま保持してください。note_id からリンクを再構築しないでください。note_url が null の場合、note_id から公開リンクを合成したり再構築したりしないでください。
xhs_get_note_comments_by_note_id	呼び出し元がすでに投稿 ID を持っている場合、ページネーション対応の第 1 階層のコメントを取得します。任意のコメント sort_type は default、time_descending、like_count_descending を指定できます。ページネーションを続けるには、返された next_page_token 全体を変更せず page_token として渡してください。途中を省略記号に置き換えたり、切り詰めたり、要約したり、マスクしたりしないでください。
xhs_get_note_comments_by_note_url	共有された投稿 URL、短縮リンク、または共有テキストから、ページネーション対応の第 1 階層のコメントを直接取得します。任意のコメント sort_type は default、time_descending、like_count_descending を指定できます。ページネーションを続けるには、返された next_page_token 全体を変更せず page_token として渡してください。途中を省略記号に置き換えたり、切り詰めたり、要約したり、マスクしたりしないでください。
xhs_get_note_sub_comments_by_comment_id	投稿 ID とコメント ID を指定して、第 1 階層のコメントへの返信をページネーション形式で取得します。ページネーションを続けるには、返された next_page_token 全体を変更せず page_token として渡してください。途中を省略記号に置き換えたり、切り詰めたり、要約したり、マスクしたりしないでください。
xhs_get_user_id_by_encrypted_user_id	完全な暗号化済み XHS ユーザー ID を安定した user_id に解決します。解決した ID は、クリエイタープロフィールや投稿取得ツールで使用できます。
xhs_get_user_info_by_user_id	呼び出し元がすでにユーザー ID を持っている場合、クリエイタープロフィールデータを取得します。
xhs_get_user_info_by_profile_url	プロフィールリンク、短縮リンク、または共有テキストをクリエイタープロフィールデータに解決します。
xhs_get_user_posted_notes_by_user_id	呼び出し元がすでにユーザー ID を持っている場合、クリエイターが公開した投稿の一覧をページネーション形式で取得します。ページネーションを続けるには、返された next_page_token 全体を変更せず page_token として渡してください。途中を省略記号に置き換えたり、切り詰めたり、要約したり、マスクしたりしないでください。
xhs_get_user_posted_notes_by_profile_url	プロフィールリンク、短縮リンク、または共有テキストから、クリエイターが公開した投稿の一覧をページネーション形式で取得します。ページネーションを続けるには、返された next_page_token 全体を変更せず page_token として渡してください。途中を省略記号に置き換えたり、切り詰めたり、要約したり、マスクしたりしないでください。
xhs_get_topic_notes_by_topic_url	トピック URL、短縮リンク、または共有テキストから、ページネーション対応のタグページ投稿一覧を取得します。sort_type は hot または time_descending を指定できます。ページネーションを続けるには、返された next_page_token 全体を変更せず page_token として渡してください。途中を省略記号に置き換えたり、切り詰めたり、要約したり、マスクしたりしないでください。
xhs_get_topic_notes_by_page_id	呼び出し元がすでにタグページの page_id を持っている場合、ページネーション対応のタグページ投稿一覧を取得します。sort_type は hot または time_descending を指定できます。ページネーションを続けるには、返された next_page_token 全体を変更せず page_token として渡してください。途中を省略記号に置き換えたり、切り詰めたり、要約したり、マスクしたりしないでください。
xhs_submit_video_speech_text_by_note_url	投稿リンク、短縮リンク、または共有テキストから、動画投稿の音声文字起こしタスクを送信します。送信呼び出しは最大 240 秒待機する場合があります。未完了の場合は、同じ job_id で完了状態になるまでポーリングを続けてください。
xhs_submit_video_speech_text_by_note_id	note_id から、動画投稿の音声文字起こしタスクを送信します。送信呼び出しは最大 240 秒待機する場合があります。未完了の場合は、同じ job_id で完了状態になるまでポーリングを続けてください。
xhs_get_video_speech_text_job	ユーザーから提供された有効な job_id、または送信ツールから返された job_id を使って、動画投稿の音声文字起こしジョブを確認します。このツールは note_id や投稿リンクを受け付けず、新しいタスクも作成しません。各呼び出しは最大 240 秒待機します。未完了の場合は、同じ job_id で完了状態になるまで照会を続けてください。この v1 インターフェースが返すのは文字起こしとコンテンツのコンテキストであり、要約ではありません。

クイックスタート

認証付きの streamable-http に対応したクライアントでは、ホストされたエンドポイントを直接使用します。

{
  "mcpServers": {
    "socialdatax-xhs": {
      "type": "streamable_http",
      "url": "https://mcp.socialdatax.com/xhs/mcp",
      "headers": {
        "Authorization": "Bearer <SOCIALDATAX_API_KEY>"
      }
    }
  }
}

すぐにコピーして使える例は、examples/streamable_http_config.json にあります。

mcp-remote の直接設定

コマンド／stdio のみをサポートする MCP クライアントでは、mcp-remote を使用します。

{
  "mcpServers": {
    "socialdatax-xhs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.socialdatax.com/xhs/mcp",
        "--header",
        "Authorization: Bearer ${SOCIALDATAX_API_KEY}"
      ],
      "env": {
        "SOCIALDATAX_API_KEY": "<SOCIALDATAX_API_KEY>"
      }
    }
  }
}

Claude Code はリモート HTTP を直接使用できます。

claude mcp add --transport http socialdatax-xhs https://mcp.socialdatax.com/xhs/mcp --header 'Authorization: Bearer ${SOCIALDATAX_API_KEY}'

Claude Code を再起動する前に、実行環境またはクライアントのシークレットに SOCIALDATAX_API_KEY を保存してください。

Claude Desktop では、利用可能な場合、リモート MCP／Connectors の UI を使用してください。お使いのバージョンがコマンド／stdio サーバーのみをサポートする場合は、npm ブリッジまたは以下の mcp-remote 設定を使用してください。

クライアントの例

設定例はexamples にあります。

• npm ブリッジのコマンド／stdio 設定
• Claude Desktop のフォールバック設定
• mcp-remote の直接使用例
• Cursor のリモート HTTP 設定
• Codex のリモート HTTP 設定
• streamable HTTP の直接設定

API キー

製品ウェブサイトから API アクセスを申請または管理してください。

https://socialdatax.com/ai?from=github

キーは Authorization リクエストヘッダーで Bearer トークンとして使用してください。実際の API キーの値をコード、ドキュメント、イシュー、スクリーンショットにコミットしないでください。

ディレクトリのメタデータ

このリポジトリに含まれる公開メタデータファイル：

• server-card.json：ホスト型サービス向けのディレクトリ用メタデータです。公式 MCP Registry への公開では、現在の com.52choujiang/xhs-insights エントリに、非公開のソースリポジトリにある registry/xhs/server.json を使用します。
• mcp.json：npm ブリッジを使用するコマンド／stdio 設定です。API キーがなくてもツールを検出できます。
• glama.json：Glama リポジトリの所有権メタデータです。
• SUBMISSION_CHECKLIST.md：MCP ディレクトリへの提出用チェックリストです。

ライセンス

この公開リポジトリ内のファイルは、MIT ライセンスの下で公開されています。このライセンスの対象は、このリポジトリ内の公開ドキュメントと設定例のみです。管理対象サービスの実装、ホストされたインフラストラクチャ、またはこのリポジトリ外にある非公開のバックエンドコードは対象外です。

Gemini CLI 拡張機能

公開されている GitHub リポジトリからこのサービスをインストールします。

gemini extensions install https://github.com/DevinChen2014/xiaohongshu-xhs-rednote-mcp

プロンプトが表示されたら、ご自身の SOCIALDATAX_API_KEY を入力してください。SocialDataX からキーを取得できます。業務向けツールの呼び出しには SocialDataX クレジットを消費します。この拡張機能は既存のホスト型 MCP エンドポイントに直接接続し、非公開のサービス実装は含みません。

gemini mcp list で接続を確認します。保存したキーを変更するには、次を実行します。

gemini extensions config socialdatax-xhs