Xiaohongshu Xhs Rednote MCP Server

Local stdio bridge for the hosted SocialDataX Xiaohongshu / XHS / RedNote MCP service.

Remote serverstreamable-http

What is the Xiaohongshu Xhs Rednote MCP MCP server?

Xiaohongshu Xhs Rednote MCP MCP server is a hosted integration for AI assistants that speak the Model Context Protocol. Local stdio bridge for the hosted SocialDataX Xiaohongshu / XHS / RedNote MCP service.

What you get

This public repository provides public connection docs and MCP metadata for a hosted 小红书 MCP / Xiaohongshu MCP / XHS MCP / RedNote MCP service.

What the assistant can call

Once Xiaohongshu Xhs Rednote MCP is connected, these are the calls the assistant has available:

  • xhs_search_notes — Search Xiaohongshu / 小红书 notes by keyword with optional sort, note type, and publish-time filters. In every use of a returned note_url, such as final
  • xhs_get_search_hot_list — Get the Xiaohongshu / 小红书 search hot list with each item's title and heat value
  • xhs_get_note_detail_by_note_url — Resolve a shared XHS link, short link, or share text into structured note details. In every use of a returned note_url, such as final answers
  • xhs_get_note_detail_by_note_id — Fetch structured note details when the caller already has a note ID. If note_url is returned, preserve the full URL exactly in every use, such as
  • xhs_get_note_comments_by_note_id — Fetch paginated first-level comments when the caller already has a note ID. To continue pagination, pass the full returned next_page_token back
  • xhs_get_note_comments_by_note_url — Fetch paginated first-level comments directly from a shared note URL, short link, or share text. To continue pagination, pass the full returned
  • xhs_get_note_sub_comments_by_comment_id — Fetch paginated replies under a first-level comment by note ID and comment ID. To continue pagination, pass the full returned next_page_token back
  • xhs_get_user_info_by_user_id — Fetch creator profile data when the caller already has a user ID
  • xhs_get_user_info_by_profile_url — Resolve a profile link, short link, or share text into creator profile data
  • xhs_get_user_posted_notes_by_user_id — Fetch a paginated list of notes published by a creator when the caller already has a user ID. To continue pagination, pass the full returned
  • xhs_get_user_posted_notes_by_profile_url — Fetch a paginated list of notes published by a creator from a profile link, short link, or share text. To continue pagination, pass the full returned
  • xhs_submit_video_speech_text_by_note_url — Submit a video note speech-to-text transcript task from a note link, short link, or share text. 提交完成后最多短等 15 秒

Setting it up

Being a remote server, there is no local install. You register the endpoint with your client, authorise it once, and the tools appear.

Configuration and credentials

You will need one environment variable: SOCIALDATAX_API_KEY. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Choosing this one

Plenty of planning and project tracking servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Xiaohongshu Xhs Rednote MCP's toolset — xhs_search_notes, xhs_get_search_hot_list, xhs_get_note_detail_by_note_url and 11 more — is a fair guide to whether it matches your workflow. It is maintained by devinchen2014; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Before you rely on it

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Xiaohongshu Xhs Rednote MCP.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the xiaohongshu xhs rednote mcp mcp server does with a few real requests.

Available tools

ToolWhat it does
xhs_search_notesSearch Xiaohongshu / 小红书 notes by keyword with optional sort, note type, and publish-time filters. In every use of a returned note_url, such as final answers, display, references, storage, output, or forwarding, preserve
xhs_get_search_hot_listGet the Xiaohongshu / 小红书 search hot list with each item's title and heat value.
xhs_get_note_detail_by_note_urlResolve a shared XHS link, short link, or share text into structured note details. In every use of a returned note_url, such as final answers, display, references, storage, output, or forwarding, preserve the full URL ex
xhs_get_note_detail_by_note_idFetch structured note details when the caller already has a note ID. If note_url is returned, preserve the full URL exactly in every use, such as final answers, display, references, storage, output, or forwarding, includ
xhs_get_note_comments_by_note_idFetch paginated first-level comments when the caller already has a note ID. To continue pagination, pass the full returned next_page_token back unchanged as page_token; do not truncate, summarize, mask, or replace the mi
xhs_get_note_comments_by_note_urlFetch paginated first-level comments directly from a shared note URL, short link, or share text. To continue pagination, pass the full returned next_page_token back unchanged as page_token; do not truncate, summarize, ma
xhs_get_note_sub_comments_by_comment_idFetch paginated replies under a first-level comment by note ID and comment ID. To continue pagination, pass the full returned next_page_token back unchanged as page_token; do not truncate, summarize, mask, or replace the
xhs_get_user_info_by_user_idFetch creator profile data when the caller already has a user ID.
xhs_get_user_info_by_profile_urlResolve a profile link, short link, or share text into creator profile data.
xhs_get_user_posted_notes_by_user_idFetch a paginated list of notes published by a creator when the caller already has a user ID. To continue pagination, pass the full returned next_page_token back unchanged as page_token; do not truncate, summarize, mask,
xhs_get_user_posted_notes_by_profile_urlFetch a paginated list of notes published by a creator from a profile link, short link, or share text. To continue pagination, pass the full returned next_page_token back unchanged as page_token; do not truncate, summari
xhs_submit_video_speech_text_by_note_urlSubmit a video note speech-to-text transcript task from a note link, short link, or share text. 提交完成后最多短等 15 秒.
xhs_submit_video_speech_text_by_note_idSubmit a video note speech-to-text transcript task from a note_id. 提交完成后最多短等 15 秒.
xhs_get_video_speech_text_jobCheck a video note speech-to-text transcript job by job_id without creating a new task. This v1 surface returns transcript only, not summary.

How to install the Xiaohongshu Xhs Rednote MCP MCP server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
SOCIALDATAX_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Xiaohongshu Xhs Rednote MCP to xhs search notes.
  • Use Xiaohongshu Xhs Rednote MCP to xhs get search hot list.
  • Use Xiaohongshu Xhs Rednote MCP to xhs get note detail by note url.

Frequently asked questions

It connects Xiaohongshu Xhs Rednote MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (xhs_search_notes, xhs_get_search_hot_list, xhs_get_note_detail_by_note_url, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Xiaohongshu Xhs Rednote MCP directly.