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 Server?

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.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
socialdatax_get_points_balanceQuery the current API Key account's SocialDataX points balance / 积分余额、剩余积分或点数.
xhs_search_notesSearch Xiaohongshu / 小红书 notes by keyword with optional sort, note type, publish-time filters, and page_token continuation. Use the corresponding detail tool wh
xhs_search_productsSearch Xiaohongshu products by product name, brand, category, or product-related query, with page_token continuation. Use this tool for search terms; if a compl
xhs_get_product_detail_by_sku_idFetch Xiaohongshu product details by a complete sku_id supplied by the user or copied from xhs_search_products results. For product links or share text, use xhs
xhs_get_product_detail_by_urlFetch Xiaohongshu product details from a product URL, short link, or share text containing a product link, without searching first. Returns the same fields as x
xhs_pgy_get_note_detail_by_note_idFetch one Xiaohongshu PGY / 蒲公英 enhanced note detail when the caller already has a complete note_id, including content, images or a video summary, author, expos
xhs_pgy_get_note_detail_by_note_urlFetch one Xiaohongshu PGY / 蒲公英 enhanced note detail from a complete note link, short link, or share text, with the same PGY commercial output and creator image
xhs_pgy_get_creator_profileFetch a Xiaohongshu PGY / 蒲公英 creator profile by a complete user_id, including creator and commercial-note scale, cooperation industries, note medians, content
xhs_pgy_get_creator_notes_performanceFetch Xiaohongshu PGY / 蒲公英 creator note performance by a complete user_id, including note counts, exposure/read/interaction medians, interaction rate, video co
xhs_pgy_get_creator_fans_profileFetch PGY fan distributions and their data date by a complete user_id. Ratios use 0–1 decimals; distributions may be incomplete. Successful calls cost 20 points
xhs_pgy_get_creator_fans_summaryFetch PGY follower counts, growth, activity, reading and engagement metrics by a complete user_id. Window end dates and growth periods are unspecified. Successf
xhs_pgy_get_creator_metrics_trendFetch date-indexed medians and estimated costs. Requires user_id; note_scope defaults to daily, while cooperation includes outbound store metrics. Fixed image +
xhs_pgy_get_creator_commercial_overviewFetch PGY commercial metrics and estimated costs. Requires user_id; note_scope defaults to daily, while cooperation includes outbound store visits. Successful c
xhs_get_product_reviewsFetch Xiaohongshu product reviews by a complete sku_id supplied by the user or copied from xhs_search_products results; accepts sort_type: general (comprehensiv
xhs_get_product_review_repliesFetch replies under a first-level Xiaohongshu product review. Use a user-provided review_id, or obtain one from xhs_get_product_reviews; accepts opaque page_tok
xhs_get_product_review_reply_repliesFetch nested replies under a Xiaohongshu product review reply. Use a user-provided reply review_id, or obtain one from xhs_get_product_review_replies; accepts o
xhs_get_search_hot_listGet the Xiaohongshu / 小红书 search hot list with each item's title and heat value.
xhs_search_suggestionsGet Xiaohongshu / 小红书 search suggestions for a keyword or partial phrase, including suggestion text, search target, and an optional description.
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, referenc
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,
xhs_get_note_comments_by_note_idFetch paginated first-level comments when the caller already has a note ID; accepts optional comment sort_type: default, time_descending, or like_count_descendi
xhs_get_note_comments_by_note_urlFetch paginated first-level comments directly from a shared note URL, short link, or share text; accepts optional comment sort_type: default, time_descending, o
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
xhs_get_user_id_by_encrypted_user_idResolve a complete encrypted XHS user ID to a stable user_id, which can then be used with creator profile and posted-note tools.
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 bac
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_
xhs_get_topic_notes_by_topic_urlFetch a paginated tag page note list from a topic URL, short link, or share text; accepts sort_type: hot or time_descending. To continue pagination, pass the fu
xhs_get_topic_notes_by_page_idFetch a paginated tag page note list when the caller already has the tag page page_id; accepts sort_type: hot or time_descending. To continue pagination, pass t
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. The submit call may wait up to 240 seconds; if unfinished, conti
xhs_submit_video_speech_text_by_note_idSubmit a video note speech-to-text transcript task from a note_id. The submit call may wait up to 240 seconds; if unfinished, continue polling the same job_id u
xhs_get_video_speech_text_jobCheck a video note speech-to-text transcript job using a valid job_id supplied by the user, or a job_id returned by a submit tool; this tool does not accept not

How to install the Xiaohongshu Xhs Rednote MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
SOCIALDATAX_API_KEYDeclared in the maintainer’s client configuration.Check documentation

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

Local stdio bridge for the hosted SocialDataX Xiaohongshu / XHS / RedNote MCP service. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.