SocialDataX 小红书 Xiaohongshu XHS RedNote MCP Server

by 52choujiang Your server? Claim it

answering

SocialDataX 小红书 Xiaohongshu XHS RedNote MCP is answering right now. Last checked 11 min ago. It exposes 38 tools.

XHS search/details, PGY, comments/replies, users/ID resolution/posts, transcript

Uptime history 91 days of history · worst day 98%

91 days agonow

100.0%

Uptime 24h

182 of 182 checks

Tools

read from the server

1695 ms

Response time

average over 24h

open, no key

Access

streamable-http

What changed 139

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 12 August 2026. No other catalogue keeps this.

23 Oct 2 tools appeared xhs_get_note_share_link_by_note_id, xhs_get_note_share_link_by_note_url

19 Oct 3 tools changed the parameters they ask for xhs_get_user_info_by_user_id, xhs_get_user_posted_notes_by_profile_url, xhs_get_user_posted_notes_by_user_id

19 Oct a tool appeared xhs_get_share_info

19 Oct a tool description was rewritten xhs_get_user_id_by_encrypted_user_id

14 Oct a tool changed version2 times that day

14 Oct 2 tool descriptions were rewritten xhs_search_images, xhs_search_notes

14 Oct a tool disappeared xhs_search_videos

8 Oct 2 tool descriptions were rewritten xhs_search_images, xhs_search_videos

30 Sep 2 tools appeared xhs_search_images, xhs_search_videos

30 Sep a tool description was rewritten xhs_search_notes

and 123 more, back to 12 August 2026

Tools have disappeared from this server

A tool that vanishes takes a piece of your agent with it, and the change arrives silently. Watch this server and every such change lands in your inbox.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 11 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add xhs-insights --transport http https://mcp.52choujiang.com/xhs/mcp

Settings → Connectors → Add custom connector, then paste this address

https://mcp.52choujiang.com/xhs/mcp

~/.codex/config.toml

[mcp_servers.xhs-insights]
url = "https://mcp.52choujiang.com/xhs/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "xhs-insights": {
      "url": "https://mcp.52choujiang.com/xhs/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "xhs-insights": {
      "type": "http",
      "url": "https://mcp.52choujiang.com/xhs/mcp"
    }
  }
}

This server publishes 1 more address. The block above uses the one we reach during checks; the full list is under Endpoints below, and the author may intend a particular one for your client.

Available tools 38

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

xhs

xhs_get_note_comments_by_note_id

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

xhs_get_note_comments_by_note_url

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

xhs_get_note_detail_by_note_id

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

xhs_get_note_detail_by_note_url

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

xhs_get_note_share_link_by_note_id

根据小红书笔记 ID 获取完整分享内容和分享短链接。已有笔记链接时使用按链接获取分享链接工具。

xhs_get_note_share_link_by_note_url

根据小红书笔记链接、短链接或分享文案获取完整分享内容和分享短链接。已有 note_id 时使用按 ID 获取分享链接工具。

xhs_get_note_sub_comments_by_comment_id

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

xhs_get_product_detail_by_sku_id

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

xhs_get_product_detail_by_url

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

xhs_get_product_review_replies

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

xhs_get_product_review_reply_replies

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

xhs_get_product_reviews

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

xhs_get_search_hot_list

获取小红书搜索热榜。

xhs_get_share_info

根据小红书笔记分享短链接或完整分享文案获取分享人、笔记摘要及作者。需要笔记完整内容时，使用笔记详情工具；分享信息不包含分享时间。

xhs_get_topic_notes_by_page_id

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

xhs_get_topic_notes_by_topic_url

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

xhs_get_user_id_by_encrypted_user_id

根据完整加密用户 ID 获取稳定 user_id。仅需单独转换 ID 时使用；查询用户信息或作品可直接使用已有用户 ID 或主页链接，无需先调用本工具。

xhs_get_user_info_by_profile_url

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

xhs_get_user_info_by_user_id

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

xhs_get_user_posted_notes_by_profile_url

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

xhs_get_user_posted_notes_by_user_id

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

xhs_get_video_speech_text_job

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

xhs_pgy_get_creator_commercial_overview

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

xhs_pgy_get_creator_fans_profile

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

xhs_pgy_get_creator_fans_summary

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

xhs_pgy_get_creator_metrics_trend

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

xhs_pgy_get_creator_notes_performance

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

xhs_pgy_get_creator_profile

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

xhs_pgy_get_note_detail_by_note_id

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

xhs_pgy_get_note_detail_by_note_url

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

xhs_search_images

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

xhs_search_notes

搜索小红书 / 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 重新拼接链接。

xhs_search_products

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

xhs_search_suggestions

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

xhs_search_users

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

xhs_submit_video_speech_text_by_note_id

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

xhs_submit_video_speech_text_by_note_url

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

socialdatax

socialdatax_get_points_balance

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

Tools removed

Tools this server used to expose. Anything built against them stopped working on the day they went.

xhs_pgy_get_note_detail

removed 20 Aug 2026

xhs_get_product_detail

removed 8 Sep 2026

xhs_search_videos

removed 14 Oct 2026

Endpoints

URL	Transport	State	Latency	Checked
https://mcp.52choujiang.com/xhs/mcp	streamable-http	answering	999 ms	11 min ago
https://mcp.socialdatax.com/xhs/mcp	streamable-http	answering	1365 ms	11 min ago

Alternatives to SocialDataX 小红书 Xiaohongshu XHS RedNote MCP

same job, measured the same way

SocialDataX 快手 Kuaishou MCP

by 52choujiang

Kuaishou hot, suggestions, video/user search, details, comments/replies, profiles/posts, transcript.

17 tools answering

SocialDataX 微博 Weibo MCP

by 52choujiang

Weibo user/post search, suggestions, trends, details, comments, likes/reposts, transcript.

22 tools answering

SocialDataX X / Twitter MCP

by 52choujiang

X/Twitter search, posts, comments, user profiles, user posts/replies and video transcripts.

21 tools answering

SocialDataX Instagram MCP

by 52choujiang

Instagram tag/user/post search, details, comments/replies, users/posts, video/Reels speech-to-text.

15 tools answering

SocialDataX TikTok MCP

by 52choujiang

TikTok suggestions,user search,post search/details,comments/replies,creators/posts,speech-to-text.

15 tools answering

SocialDataX YouTube MCP

by 52choujiang

YouTube video/channel search, suggestions, details, comments/replies, Shorts, transcripts, paging.

12 tools answering

SocialDataX 抖音 Douyin MCP

by 52choujiang

hot search、suggestions、video/user/product search、comments/replies、users/works/series、transcript

26 tools answering

SocialDataX 知乎 Zhihu MCP

by 52choujiang

Zhihu/知乎 hot list, search/details, comments/replies, creators/articles, and video transcripts.

13 tools answering

SocialDataX 小红书 Xiaohongshu XHS RedNote MCP — questions

Answers built from our own checks of this server.

What can SocialDataX 小红书 Xiaohongshu XHS RedNote MCP do?

It exposes 38 tools, read directly from the server on our last check. Among them: socialdatax_get_points_balance, xhs_get_note_comments_by_note_id, xhs_get_note_comments_by_note_url, xhs_get_note_detail_by_note_id, xhs_get_note_detail_by_note_url, xhs_get_note_share_link_by_note_id and 32 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is SocialDataX 小红书 Xiaohongshu XHS RedNote MCP working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 182 of 182 checks got a reply (100.0%), average response time 1695 ms. The bar chart above shows every period we have measured.

Did SocialDataX 小红书 Xiaohongshu XHS RedNote MCP ever remove tools?

Yes. xhs_pgy_get_note_detail, xhs_get_product_detail, xhs_search_videos are no longer exposed — we recorded the date each one disappeared. A tool vanishing usually means a breaking change for anything that depended on it.

How do I connect SocialDataX 小红书 Xiaohongshu XHS RedNote MCP?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does SocialDataX 小红书 Xiaohongshu XHS RedNote MCP need an API key?

No. SocialDataX 小红书 Xiaohongshu XHS RedNote MCP completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 38 of them are readable on this page. This is what we observed, not what the docs claim.