Skip to main content
Glama
Sign In
deenesjakoruzh
SocialDataX 小红书 Xiaohongshu XHS RedNote MCP

SocialDataX 小红书 Xiaohongshu XHS RedNote MCP

by DevinChen2014
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

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

LobeHub 用户请使用 LobeHub setup / 接入说明，包含专属官网入口、认证和来源配置。

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

If you are looking for a 小红书 MCP, Xiaohongshu MCP, XHS MCP, or RedNote MCP for social media research workflows, this repository includes:

  • public MCP metadata and client configuration examples

  • the hosted streamable-http endpoint for clients that support remote MCP

  • command/stdio configurations for the npm bridge and direct mcp-remote use

The business implementation is privately hosted. This repository exposes only the public connection surface for social media content intelligence workflows.

Search Aliases

Common search phrases for this MCP service:

  • 小红书 MCP

  • 小红书 数据 MCP

  • 小红书 搜索 MCP

  • 小红书 XHS MCP

  • Xiaohongshu MCP

  • Xiaohongshu data MCP

  • XHS MCP

  • XHS data MCP

  • RedNote MCP

  • RedNote data MCP

  • Xiaohongshu note search MCP

Related MCP server: xiaohongshu-skill

Service

  • Hosted MCP endpoint: https://mcp.socialdatax.com/xhs/mcp

  • Hosted transport: streamable-http

  • Authentication: Authorization: Bearer <SOCIALDATAX_API_KEY>

  • Product: SocialDataX / 社媒数据助手

  • Website and API Key access: https://socialdatax.com/ai?from=github

  • Registry name: com.52choujiang/xhs-insights

  • Future registry name: com.socialdatax/xhs-insights

  • Current public capability version: 0.1.15 (35 tools)

  • Hosted production: 0.1.15 with 35 tools; deployment and authenticated tool discovery verified on 2026-10-14. Video notes remain available through xhs_search_notes(note_type="video").

  • Official MCP Registry: 0.1.15 (active, isLatest=true), published and verified on 2026-10-14.

  • Public GitHub server card: 0.1.15 with 35 tools, synced and verified on 2026-10-14.

  • The public tool catalog is maintained in server-card.json; npm bridge versions are independent of the hosted tool catalog.

  • npm stdio bridge: xiaohongshu-xhs-rednote-mcp@0.1.18; bridge package versions are independent of hosted capability versions.

The current capability includes encrypted user ID resolution, PGY creator profiles, note performance, fans profiles and fans summaries, product review reply-reply lookup, product detail lookup by URL, and the product detail field rename (images to main_images; detail_images remains unchanged).

Platform MCP

Use the hosted streamable-http endpoint directly from clients that support authenticated remote MCP. Command/stdio clients can use the npm bridge in mcp.json or configure mcp-remote directly.

npm stdio bridge

Requires Node.js 20.18.1 or later.

Command/stdio-only MCP clients can install and start the bridge directly from npm:

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

The package only forwards local stdio MCP messages to the hosted SocialDataX XHS endpoint. It does not contain the private service implementation or store the API Key.

The public tool catalog can be discovered without an API Key. Set SOCIALDATAX_API_KEY for business tool calls; without it, the bridge can start for discovery, while the hosted service requires authentication for business data.

Workflow Scope

This MCP service is designed for social media content intelligence workflows. It does not provide account login, posting, editing, liking, commenting, or other account actions.

Supported workflows include:

  • Query the current API Key account's SocialDataX points balance / 积分余额、剩余积分或点数.

  • Search related Xiaohongshu notes by keyword, with optional sort, note type, and publish-time filters.

  • Search Xiaohongshu products by keyword with page_token continuation.

  • Fetch product details by a complete sku_id supplied by the user or copied from product search results.

  • Fetch one PGY / 蒲公英 enhanced note detail from either a complete note_id or a note link, short link, or share text; successful calls cost 20 points and failures are not charged.

  • PGY applies only to notes from enrolled creators. Use it for requested commercial data; keep ordinary note requests on ordinary detail tools. An explicit no-commercial-data result is treated as not enrolled (pgy_commercial_data_unavailable); stop without retrying the other ID/URL route. Timeouts, authentication failures and insufficient balance keep their own errors.

  • Fetch product reviews by a complete sku_id supplied by the user or copied from product search results.

  • Fetch nested replies under a product review reply by a review_id supplied by the user or copied from xhs_get_product_review_replies; accepts opaque page_token continuation and does not accept root_review_id.

  • Read the Xiaohongshu search hot list with title and heat value.

  • Read Xiaohongshu search suggestions for a keyword or partial phrase.

  • Resolve a shared note link, short link, or share text into structured note details.

  • Read note details when the caller already has a note ID.

  • Fetch paginated first-level comments for comment analysis.

  • Fetch paginated replies under a first-level comment.

  • Read creator profile data from a profile link, short link, share text, or user ID.

  • Fetch paginated creator note lists from a user ID, profile link, short link, or share text for content style and account research.

  • Fetch paginated tag page note lists from a topic URL, short link, share text, or page ID.

  • Submit a video note speech-to-text transcript task; the submit call may wait up to 240 seconds, and unfinished jobs should continue polling the same job_id until terminal.

Tools

Tool

Public purpose

socialdatax_get_points_balance

Query the current API Key account's SocialDataX points balance / 积分余额、剩余积分或点数.

xhs_search_users

Search Xiaohongshu / 小红书 users, accounts, or creators by keyword with page_token pagination. When a user ID or profile URL is already available, use the corresponding user-profile tool.

xhs_search_notes

Search Xiaohongshu / 小红书 notes, including video notes with note_type="video" and image notes with note_type="image"; supports sorting, publish-time filters, and page_token continuation. Use the corresponding detail tool when the caller already has a note link or note_id and needs one note's details; use the corresponding URL/ID tool for comments, replies, or speech-to-text. To continue search pagination, pass the full returned next_page_token back unchanged as page_token; omit page_token on the first request. In every use of a returned note_url, such as final answers, display, references, storage, output, or forwarding, preserve the full URL exactly, including xsec_token; do not rebuild links from note_id.

xhs_search_images

Search Xiaohongshu images by keyword; each result is one image with its associated note, and one note may contribute multiple images. Pagination may return no further results. For image notes, use xhs_search_notes with note_type="image".

xhs_search_products

Search Xiaohongshu products by product name, brand, category, or product-related query, with page_token continuation. Use this tool for search terms; if a complete sku_id is already available, including one supplied by the user, use xhs_get_product_detail_by_sku_id or xhs_get_product_reviews instead. Do not use product links, sku_id, spu_id, or page_token as the keyword. To continue product search pagination, pass the full returned next_page_token back unchanged as page_token; do not truncate, summarize, mask, or replace the middle with ellipses.

xhs_get_product_detail_by_sku_id

Fetch 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_get_product_detail_by_url. This ID tool does not accept spu_id, product links, or search keywords.

xhs_get_product_detail_by_url

Fetch Xiaohongshu product details from a product URL, short link, or share text containing a product link, without searching first. Returns the same fields as xhs_get_product_detail_by_sku_id; the returned sku_id can be used to read product reviews. Note links, profile links, and standalone share codes are not supported.

xhs_pgy_get_note_detail_by_note_id

Fetch one Xiaohongshu PGY / 蒲公英 enhanced note detail when the caller already has a complete note_id, including content, images or a video summary, author, exposure, reads, likes, saves, comments, shares, and creator image/video collaboration quotes in Chinese yuan. The quotes are not the note's transaction price. Only notes from PGY-enrolled creators are eligible. This is PGY commercial data, not ordinary public note detail; successful calls cost 20 points and failures are not charged.

xhs_pgy_get_note_detail_by_note_url

Fetch 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/video collaboration quotes in Chinese yuan. The quotes are not the note's transaction price. Only notes from enrolled creators are eligible. Successful calls cost 20 points and failures are not charged.

xhs_pgy_get_creator_profile

Fetch a Xiaohongshu PGY / 蒲公英 creator profile by a complete user_id, including creator and commercial-note scale, cooperation industries, note medians, content tags, and creator image/video collaboration quotes in Chinese yuan. Use ordinary user-profile tools for non-PGY account data. Successful calls cost 20 points and failures are not charged.

xhs_pgy_get_creator_notes_performance

Fetch Xiaohongshu PGY / 蒲公英 creator note performance by a complete user_id, including note counts, exposure/read/interaction medians, interaction rate, video completion rate, image three-second read rate, content tags, and note items. Optional note_scope selects daily (default) or cooperation; the response echoes the scope. Note items cover at most the latest 15 notes. Only notes[] comparison rates are signed differences relative to platform medians and may be negative or exceed 1; same-named summary comparison fields are opaque 0-to-1 platform values and must not be mixed. Successful calls cost 20 points and failures are not charged.

xhs_pgy_get_creator_fans_profile

Fetch 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; failures are not charged.

xhs_pgy_get_creator_fans_summary

Fetch PGY follower counts, growth, activity, reading and engagement metrics by a complete user_id. Window end dates and growth periods are unspecified. Successful calls cost 20 points; failures are not charged.

xhs_pgy_get_creator_metrics_trend

Fetch date-indexed medians and estimated costs. Requires user_id; note_scope defaults to daily, while cooperation includes outbound store metrics. Fixed image + video, last 30 days, all traffic for medians; costs use field-specific scopes. Gaps are preserved; values cannot be summed across dates. Successful calls cost 20 points; failures are not charged.

xhs_pgy_get_creator_commercial_overview

Fetch PGY commercial metrics and estimated costs. Requires user_id; note_scope defaults to daily, while cooperation includes outbound store visits. Successful calls cost 20 points; failures are not charged.

xhs_get_product_reviews

Fetch Xiaohongshu product reviews by a complete sku_id supplied by the user or copied from xhs_search_products results; accepts sort_type: general (comprehensive sort, the default) or time_descending, has_image, and page_token continuation. To continue pagination, pass the full returned next_page_token back unchanged as page_token; do not truncate, summarize, mask, or replace the middle with ellipses. This tool does not accept spu_id, product links, or search keywords.

xhs_get_product_review_replies

Fetch 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_token continuation. To continue pagination, pass the full returned next_page_token back unchanged as page_token; do not truncate, summarize, mask, or replace the middle with ellipses. This tool does not accept root_review_id.

xhs_get_product_review_reply_replies

Fetch 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 opaque page_token continuation. To continue pagination, pass the full returned next_page_token back unchanged as page_token; do not truncate, summarize, mask, or replace the middle with ellipses. This tool does not accept root_review_id.

xhs_get_search_hot_list

Get the Xiaohongshu / 小红书 search hot list with each item's title and heat value.

xhs_search_suggestions

Get Xiaohongshu / 小红书 search suggestions for a keyword or partial phrase, including suggestion text, search target, and an optional description.

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, display, references, storage, output, or forwarding, preserve the full URL exactly, including xsec_token; do not rebuild links from note_id. If note_url is null, do not synthesize or rebuild a public link from note_id.

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 final answers, display, references, storage, output, or forwarding, including xsec_token; do not rebuild links from note_id. If note_url is null, do not synthesize or rebuild a public link from note_id.

xhs_get_note_comments_by_note_id

Fetch paginated first-level comments when the caller already has a note ID; accepts optional comment sort_type: default, time_descending, or like_count_descending. To continue pagination, pass the full returned next_page_token back unchanged as page_token; do not truncate, summarize, mask, or replace the middle with ellipses.

xhs_get_note_comments_by_note_url

Fetch paginated first-level comments directly from a shared note URL, short link, or share text; accepts optional comment sort_type: default, time_descending, or like_count_descending. To continue pagination, pass the full returned next_page_token back unchanged as page_token; do not truncate, summarize, mask, or replace the middle with ellipses.

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 unchanged as page_token; do not truncate, summarize, mask, or replace the middle with ellipses.

xhs_get_user_id_by_encrypted_user_id

Resolve 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_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 next_page_token back unchanged as page_token; do not truncate, summarize, mask, or replace the middle with ellipses.

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 next_page_token back unchanged as page_token; do not truncate, summarize, mask, or replace the middle with ellipses.

xhs_get_topic_notes_by_topic_url

Fetch 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 full returned next_page_token back unchanged as page_token; do not truncate, summarize, mask, or replace the middle with ellipses.

xhs_get_topic_notes_by_page_id

Fetch 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 the full returned next_page_token back unchanged as page_token; do not truncate, summarize, mask, or replace the middle with ellipses.

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. The submit call may wait up to 240 seconds; if unfinished, continue polling the same job_id until terminal.

xhs_submit_video_speech_text_by_note_id

Submit 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 until terminal.

xhs_get_video_speech_text_job

Check 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 note_id or note links and does not create a new task. Each call waits up to 240 seconds. If unfinished, continue querying the same job_id until terminal. This v1 surface returns transcript plus content context, not summary.

Quick Start

For clients that support authenticated streamable-http, use the hosted endpoint directly:

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

A ready-to-copy example is available in examples/streamable_http_config.json.

Direct mcp-remote configuration

For command/stdio-only MCP clients, use 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 can use remote HTTP directly:

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

Persist SOCIALDATAX_API_KEY in the runtime environment or client Secret before restarting Claude Code.

Claude Desktop should use its remote MCP / Connectors UI when available. If your version only supports command/stdio servers, use the npm bridge or the mcp-remote configuration below.

Client Examples

Configuration examples are available in examples:

API Key

Request or manage API access from the product website:

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

Use the key as a Bearer token in the Authorization request header. Do not commit real API Key values to code, docs, issues, or screenshots.

Directory Metadata

Public metadata files in this repository:

  • server-card.json: directory-oriented metadata for the hosted service. Official MCP Registry publishing uses the private source repo's registry/xhs/server.json for the current com.52choujiang/xhs-insights entry.

  • mcp.json: command/stdio config using the npm bridge; tool discovery works without an API Key.

  • glama.json: Glama repository ownership metadata.

  • SUBMISSION_CHECKLIST.md: checklist for MCP directory submissions.

License

The files in this public repository are released under the MIT License. The license covers the public documentation and configuration examples in this repository only. It does not cover the managed service implementation, hosted infrastructure, or any private backend code outside this repository.

Gemini CLI extension

Install this service from its public GitHub repository:

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

When prompted, enter your own SOCIALDATAX_API_KEY. Get a key from SocialDataX; business tool calls consume SocialDataX credits. The extension connects directly to the existing hosted MCP endpoint and does not include the private service implementation.

Verify the connection with gemini mcp list. To change the saved key, run:

gemini extensions config socialdatax-xhs

Available Tools

35 tools
socialdatax_get_points_balanceA
Read-only

查询当前 API Key 账户的 SocialDataX 积分余额、剩余积分或点数 / remaining points balance。需要充值时请访问 https://socialdatax.com/dashboard/billing。

Inputs: no named parameters. Returns: object

xhs_get_note_comments_by_note_idB
Read-only

根据 note_id 获取单篇小红书笔记的一级评论，支持 sort_type 评论排序和 page_token 翻页。

Inputs: note_id (required), sort_type, page_token. Returns: items, points, comment_count, next_page_token, +1 more

xhs_get_note_comments_by_note_urlA
Read-only

根据笔记链接、短链接或分享文案获取单篇小红书笔记的一级评论，支持 sort_type 评论排序和 page_token 翻页。

Inputs: note_url (required), sort_type, page_token. Returns: items, points, comment_count, next_page_token, +1 more

xhs_get_note_detail_by_note_idA
Read-only

根据 note_id 获取单篇小红书笔记详情。 返回的 note_url 非 null 时，在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接；note_url 为 null 时不要用 note_id 合成公开链接。

Inputs: note_id (required). Returns: title, video, author, points, +15 more

xhs_get_note_detail_by_note_urlA
Read-only

根据笔记链接、短链接或分享文案获取单篇小红书笔记详情。 返回的 note_url 在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接；note_url 为 null 时不要用 note_id 合成公开链接。

Inputs: note_url (required). Returns: title, video, author, points, +15 more

xhs_get_note_sub_comments_by_comment_idA
Read-only

根据 note_id 和一级评论 comment_id 获取二级评论；用户已提供完整合法的 ID 组合时直接使用；已有 note_id 或笔记链接但缺少必需 ID 时，调用对应一级评论工具补全；缺少笔记定位信息时向用户索取；支持 page_token 翻页。

Inputs: note_id (required), comment_id (required), page_token. Returns: items, points, next_page_token

xhs_get_product_detail_by_sku_idA
Read-only

根据小红书商品 sku_id 获取商品详情；已有该 ID 时直接使用，否则可从 xhs_search_products 获取。只有商品链接、短链接或分享文案时使用 xhs_get_product_detail_by_url；本工具不支持商品链接、spu_id 或搜索词。

Inputs: sku_id (required). Returns: price, title, points, sku_id, +16 more

xhs_get_product_detail_by_urlA
Read-only

根据小红书商品链接、短链接或分享文案获取商品详情，无需先搜索。已有完整 sku_id 时使用 xhs_get_product_detail_by_sku_id；返回的 sku_id 可继续用于商品评价工具。

Inputs: url (required). Returns: price, title, points, sku_id, +16 more

xhs_get_product_review_repliesA
Read-only

根据一级商品评价 review_id 获取其下回复；已有该 ID 时直接使用，否则可从 xhs_get_product_reviews 获取；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容；不接受 root_review_id。

Inputs: review_id (required), page_token. Returns: items, points, next_page_token

xhs_get_product_review_reply_repliesA
Read-only

根据商品评价回复 review_id 获取其下的嵌套回复；已有该 ID 时直接使用，否则可从 xhs_get_product_review_replies 获取；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容；不接受 root_review_id。

Inputs: review_id (required), page_token. Returns: items, points, next_page_token

xhs_get_product_reviewsA
Read-only

根据小红书商品 sku_id 获取商品评价；已有该 ID 时直接使用，否则可从 xhs_search_products 获取；支持 sort_type、has_image 和 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容；不支持商品链接、spu_id 或搜索词。

Inputs: sku_id (required), has_image, sort_type, page_token. Returns: items, points, next_page_token

xhs_get_search_hot_listA
Read-only

获取小红书搜索热榜。

Inputs: no named parameters. Returns: items, points

xhs_get_topic_notes_by_page_idA
Read-only

根据 page_id 获取标签页笔记列表，支持 sort_type 排序和 page_token 翻页。

Inputs: page_id (required), sort_type, page_token. Returns: items, points, next_page_token, total_note_count, +1 more

xhs_get_topic_notes_by_topic_urlA
Read-only

根据话题页链接、短链接或分享文案获取标签页笔记列表，支持 sort_type 排序和 page_token 翻页。

Inputs: topic_url (required), sort_type, page_token. Returns: items, points, next_page_token, total_note_count, +1 more

xhs_get_user_id_by_encrypted_user_idA
Read-only

根据完整加密用户 ID 获取稳定 user_id。

Inputs: encrypted_user_id (required). Returns: points, user_id

xhs_get_user_info_by_profile_urlA
Read-only

根据主页链接、短链接或分享文案获取单个小红书用户信息。

Inputs: profile_url (required). Returns: bio, name, points, red_id, +15 more

xhs_get_user_info_by_user_idA
Read-only

根据 user_id 获取单个小红书用户信息。

Inputs: user_id (required). Returns: bio, name, points, red_id, +15 more

xhs_get_user_posted_notes_by_profile_urlA
Read-only

根据主页链接、短链接或分享文案获取用户已发布笔记列表，支持 page_token 翻页。

Inputs: profile_url (required), page_token. Returns: items, points, next_page_token

xhs_get_user_posted_notes_by_user_idA
Read-only

根据 user_id 获取用户已发布笔记列表，支持 page_token 翻页。

Inputs: user_id (required), page_token. Returns: items, points, next_page_token

xhs_get_video_speech_text_jobA
Read-only

根据用户提供的有效 job_id，或提交工具返回的 job_id 查询任务状态；用于继续未完成任务，每次最多等待 240 秒，不触发重处理，也不要重复提交任务。

Inputs: job_id (required). Returns: error, job_id, status, message, +9 more

xhs_pgy_get_creator_commercial_overviewA
Read-only

根据完整 user_id 获取小红书蒲公英创作者商业概览：笔记规模和中位数、服务表现、平台标签、增长、预估成本及对比值。 查询指定日常/合作口径的商业汇总与成本参考时使用，不返回逐篇明细。逐篇表现使用创作者笔记表现工具，也可选择日常或合作口径。资料与报价使用创作者档案工具，粉丝构成使用粉丝画像工具。 查看日常内容表现选 daily（默认，不是按天汇总）；查看商单、品牌合作笔记或外溢进店的汇总表现选 cooperation。输出回显口径，不能混用；不是对全部字段统一筛选，note_count 不能解释为所选口径的笔记数。两种口径的成本估计依据不同，均不代表实际成交成本或ROI。 不支持指定日期，统计截止日期未提供；进店不等于订单或成交，不据此推断调用方自己的投放成绩。 成功直接返回业务字段和 points；成功调用扣减 20 积分，失败不扣费。

Inputs: user_id (required), note_scope. Returns: points, user_id, data_date, note_count, +34 more

xhs_pgy_get_creator_fans_profileA
Read-only

根据完整 user_id 获取小红书蒲公英创作者粉丝画像，包括年龄、性别、地域、城市、兴趣和设备品牌分布及数据日期。 查询粉丝构成时使用；粉丝规模、增长、活跃、阅读和互动情况使用创作者粉丝汇总工具；创作者资料和报价使用创作者档案工具。 使用平台默认统计范围，不支持指定日期；分布不保证完整，不能据此推算粉丝人数或补齐其他类别。 成功返回画像字段和 points；成功调用扣减 20 积分，失败不扣费。

Inputs: user_id (required). Returns: points, user_id, data_date, age_distribution, +5 more

xhs_pgy_get_creator_fans_summaryA
Read-only

根据完整 user_id 获取小红书蒲公英创作者粉丝总数、平台增长指标、活跃、阅读和互动粉丝人数及占比。 查询粉丝规模和活跃情况时使用；年龄、性别、地域和兴趣等构成使用创作者粉丝画像工具。 不支持指定日期或统计周期；增长周期及各统计窗口截止日期未提供，不能按查询日期推算，不承诺指定期间增长数据。 成功直接返回汇总字段和 points；成功调用扣减 20 积分，失败不扣费。

Inputs: user_id (required). Returns: points, user_id, follower_count, read_follower_ratio, +7 more

xhs_pgy_get_creator_metrics_trendA
Read-only

根据完整 user_id 获取小红书蒲公英创作者曝光、阅读、互动中位数及预估成本的日期趋势和概览。 观察指标随时间变化时使用；中位数按 note_scope 选择日常或合作笔记，固定图文＋视频、近30日、全流量，不支持自选日期。合作口径包含进店指标，日常口径的进店字段为 null；输出回显口径，不能混用。 返回指标不是每日新增量或累计总量，不可跨日期求和；可能缺少日期，不补零。 成本估算口径见字段说明，不代表实际成交成本；按图文/视频拆分的成本及商业汇总使用商业概览工具，逐篇表现使用笔记表现工具。 成功直接返回业务字段和 points；成功调用扣减 20 积分，失败不扣费。

Inputs: user_id (required), note_scope. Returns: items, points, summary, user_id, +1 more

xhs_pgy_get_creator_notes_performanceA
Read-only

根据完整 user_id 获取小红书蒲公英创作者笔记表现，包括笔记数量、曝光/阅读/互动中位数、互动率、视频完播率、图文 3 秒阅读率、内容标签和笔记明细。 查询日常或合作笔记表现及最近明细时使用；商业汇总与成本参考使用商业概览工具，资料和报价使用创作者档案工具。 视频完播相关字段仅在 video_note_count 大于 0 时用于表现判断；图文 3 秒阅读率仅在统计范围内有图文笔记时用于表现判断；其他情况下 0 值不表示对应表现为 0%。 固定近30日、图文＋视频、全流量，不支持自选日期或笔记类型；明细最多 15 篇，不是全量列表。仅 notes[] 内的 *_benchmark_rate 是相较于平台中位数的相对差异，允许负数和超过 1，不能当作排名比例；汇总层同名字段仍是平台返回的 0 到 1 对比值，计算方式未公开，不能混用。 成功返回表现字段和 points；成功调用扣减 20 积分，失败不扣费。

Inputs: user_id (required), note_scope. Returns: notes, points, user_id, note_count, +19 more

xhs_pgy_get_creator_profileA
Read-only

根据完整 user_id 获取小红书蒲公英创作者档案、粉丝和商业笔记规模、合作行业、笔记阅读与互动中位数、内容分类、特征标签和创作者图文/视频合作报价。 查询蒲公英创作者资料和报价时使用；普通账号资料使用用户信息工具。 笔记表现使用创作者笔记表现工具；粉丝画像使用创作者粉丝画像工具；指标随日期变化使用创作者指标趋势工具。图文和视频报价单位为人民币元；零值不表示免费合作。 成功返回档案字段和 points；成功调用扣减 20 积分，失败不扣费。

Inputs: user_id (required). Returns: name, gender, points, red_id, +15 more

xhs_pgy_get_note_detail_by_note_idA
Read-only

根据 note_id 获取小红书蒲公英单篇笔记商业增强详情，包括正文、图片或视频摘要、作者、曝光量、阅读量、点赞、收藏、评论、分享和创作者图文/视频合作报价（单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作）。 仅适用于已入驻蒲公英博主的笔记；用户明确要求蒲公英商业数据时使用，普通笔记详情使用普通详情工具。 用户只提曝光量、阅读量或报价且上下文未明确蒲公英口径时，先澄清商业口径和成功 20 积分的费用；上下文已明确时不重复确认。 这是蒲公英商业口径数据，不等同普通公开笔记详情；成功调用扣减 20 积分，失败不扣费。 查询明确无商业数据时按博主未入驻蒲公英处理，返回 pgy_commercial_data_unavailable，不换 ID/链接入口重试；超时、鉴权和余额不足等错误不表示未入驻。

Inputs: note_id (required). Returns: title, video, author, points, +16 more

xhs_pgy_get_note_detail_by_note_urlA
Read-only

根据笔记链接、短链接或分享文案获取小红书蒲公英单篇笔记商业增强详情，包括曝光量、阅读量、点赞、收藏、评论、分享和创作者图文/视频合作报价（单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作）。 仅适用于已入驻蒲公英博主的笔记；用户明确要求蒲公英商业数据时使用，普通笔记详情使用普通详情工具。 用户只提曝光量、阅读量或报价且上下文未明确蒲公英口径时，先澄清商业口径和成功 20 积分的费用；上下文已明确时不重复确认。 这是蒲公英商业口径数据，不等同普通公开笔记详情；成功调用扣减 20 积分，失败不扣费。 查询明确无商业数据时按博主未入驻蒲公英处理，返回 pgy_commercial_data_unavailable，不换 ID/链接入口重试；超时、鉴权和余额不足等错误不表示未入驻。

Inputs: note_url (required). Returns: title, video, author, points, +16 more

xhs_search_imagesA
Read-only

按搜索词搜索小红书图片；已有笔记链接或 note_id，且需要读取该篇笔记详情时，使用对应详情工具。每项为一张图片及关联笔记，同一笔记可返回多张图片；page_token 可用于尝试下一页，不保证下一页有结果；结果按平台相关性排序，不承诺每条内容包含原词，不承诺完整召回；需要图文笔记而非单张图片时使用 xhs_search_notes(note_type="image")；需要视频笔记时使用 xhs_search_notes(note_type="video")。

Inputs: keyword (required), page_token. Returns: items, points, next_page_token

xhs_search_notesA
Read-only

搜索小红书 / Xiaohongshu / XHS / RedNote 笔记，包含普通、图文和视频笔记；note_type 默认 "all"。查找图文笔记可设 note_type="image"，查找视频笔记可设 note_type="video"。发布时间筛选参数名为 publish_time_range（不是 publish_time）；本工具不接受 max_items。查找单张图片用 xhs_search_images；已有笔记链接或 note_id 且需要单篇笔记详情时使用对应的详情工具；需要评论、回复或口播转文字时使用相应的 URL/ID 工具；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容。 返回的 note_url 在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接。

Inputs: keyword (required), note_type, sort_type, page_token, +1 more. Returns: items, points, next_page_token

xhs_search_productsA
Read-only

搜索小红书商品。用户需要按搜索词查找商品时使用；已有完整 sku_id（包括用户直接提供）时使用商品详情或商品评价工具，已有商品链接或分享文案时使用 xhs_get_product_detail_by_url；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容。

Inputs: keyword (required), page_token. Returns: items, points, next_page_token

xhs_search_suggestionsA
Read-only

根据搜索词获取小红书候选搜索建议，用于补全搜索词；需要实际搜索笔记或商品时，分别使用 xhs_search_notes 或 xhs_search_products。

Inputs: keyword (required). Returns: items, points

xhs_search_usersA
Read-only

按搜索词搜索小红书用户、账号或博主，支持分页；已有用户 ID 或主页链接时，使用用户资料工具。

Inputs: keyword (required), page_token. Returns: items, points, next_page_token

xhs_submit_video_speech_text_by_note_idA

根据小红书 note_id 提交视频笔记口播转文字任务；提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。

Inputs: note_id (required). Returns: error, job_id, status, message, +9 more

xhs_submit_video_speech_text_by_note_urlA

根据小红书视频笔记链接、短链接或分享文案提交口播转文字任务；提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。

Inputs: note_url (required). Returns: error, job_id, status, message, +9 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.9/5.0

    Scored across 35 tools

    Disambiguation4/5

    Tools are organized around clear resources (notes, users, products, topics, comments, commercial/pgy data), and the by_url vs by_id pairs are explicitly cross-referenced in descriptions so an agent can pick correctly. The only mild overlap is among the pgy creator analytics tools (profile vs performance vs fans vs commercial overview vs metrics trend), which are differentiated by description but require careful reading.

    Naming Consistency5/5

    Nearly every tool follows the xhs_<verb>_<noun>[_by_<input>] pattern, with a clean pgy_ namespace for commercial tools and consistent _by_url/_by_id variant suffixes. The single socialdatax_get_points_balance is a reasonable account-level exception, not a break in convention.

    Tool Count3/5

    35 tools is heavy for the surface, and the domain is broad enough (notes, users, products, comments, topics, commercial analytics) that most tools earn their place. However, the systematic url/id duplication of several operations inflates the count and pushes this toward the heavy end of the range.

    Completeness4/5

    Coverage spans search, note/image/user/product/topic detail, comments and nested replies, video speech-to-text job lifecycle, hot lists, suggestions, and a full commercial (pgy) analytics suite, which is close to lifecycle-complete for a data-reading API. Gaps are minor, e.g. no social-graph or follower-list operations, but core workflows are covered.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • RedNote MCP

      MilesCool
      A
      license
      B
      quality
      D
      maintenance
      Enables users to search and retrieve content from Xiaohongshu (Red Book) platform with smart search capabilities and rich data extraction including note content, author information, and images.
      1
      121 npm
      30
      MIT

    • xiaohongshu-skill

      Youhai020616
      A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for automating Xiaohongshu (RED Note). Publish posts, search content, comment, like, and analyze creator data on China's largest lifestyle social platform.
      31
      MIT

    • xhs-mcp

      xyj2570
      A
      license
      A
      quality
      D
      maintenance
      A lightweight MCP server that provides read-only access to Xiaohongshu (Little Red Book) data, enabling search, note details, user profiles, and trending feeds via direct HTTP APIs.
      5
      18 npm
      1
      MIT