Skip to content
Back to search
100
MCP live v0.1.5 MCP 2025-11-25 streamable-http ext: ui

SocialDataX 小红书 Xiaohongshu XHS RedNote MCP

com.52choujiang/xhs-insights

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

Uptime
100.0%
5 direct probes · 30d
Response
2831ms
last probe
Tools
36
callable
Resources
2
readable
Prompts
0
available
Score: 100/100
Handshake verified by our own probe.
why this score
pass Answers the MCP handshake 50/50
The handshake and the list calls succeeded on the primary URL.
pass Lists tools, resources or prompts 30/30
36 tools, 2 resources, 0 prompts returned.
pass 3 or more catalogue items 10/10
38 items in total; 3 or more earns these points.
pass Describes itself 10/10
80 characters; more than 30 earns these points.

Tools · 36

xhs_get_note_detail_by_note_url

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

xhs_get_note_detail_by_note_id

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

xhs_search_notes

搜索小红书 / Xiaohongshu / XHS / RedNote 相关笔记。用户需要按搜索词查找笔记时使用;查找图文笔记可设 note_type="image",查找单张图片用 xhs_search_images;视频默认搜索用 xhs_search_videos,需要排序或发布时间筛选时用本工具并设 note_type="video";已有笔记链接或 note_id 且需要单篇笔记详情时使…

xhs_search_videos

按搜索词搜索小红书视频标签结果;已有笔记链接或 note_id,且需要读取该篇笔记详情时,使用对应详情工具。每项为视频笔记,note_type 固定为 video,支持 page_token 翻页;结果按平台相关性排序,不承诺每条内容包含原词,不承诺完整召回;需要排序或发布时间筛选时使用 xhs_search_notes(note_type="video");本工具不接受这些筛选参数;需要图片时使…

xhs_search_images

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

xhs_search_users

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

xhs_search_products

搜索小红书商品。用户需要按搜索词查找商品时使用;已有完整 sku_id(包括用户直接提供)时使用商品详情或商品评价工具,已有商品链接或分享文案时使用 xhs_get_product_detail_by_url;支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 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_pgy_get_note_detail_by_note_id

根据 note_id 获取小红书蒲公英单篇笔记商业增强详情,包括正文、图片或视频摘要、作者、曝光量、阅读量、点赞、收藏、评论、分享和创作者图文/视频合作报价(单位:人民币元;不是当前笔记的成交金额;零值不表示免费合作)。 仅适用于已入驻蒲公英博主的笔记;用户明确要求蒲公英商业数据时使用,普通笔记详情使用普通详情工具。 用户只提曝光量、阅读量或报价且上下文未明确蒲公英口径时,先澄清商业口径和成功 2…

xhs_pgy_get_note_detail_by_note_url

根据笔记链接、短链接或分享文案获取小红书蒲公英单篇笔记商业增强详情,包括曝光量、阅读量、点赞、收藏、评论、分享和创作者图文/视频合作报价(单位:人民币元;不是当前笔记的成交金额;零值不表示免费合作)。 仅适用于已入驻蒲公英博主的笔记;用户明确要求蒲公英商业数据时使用,普通笔记详情使用普通详情工具。 用户只提曝光量、阅读量或报价且上下文未明确蒲公英口径时,先澄清商业口径和成功 20 积分的费用;上下…

xhs_pgy_get_creator_profile

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

xhs_pgy_get_creator_notes_performance

根据完整 user_id 获取小红书蒲公英创作者笔记表现,包括笔记数量、曝光/阅读/互动中位数、互动率、视频完播率、图文 3 秒阅读率、内容标签和笔记明细。 查询日常或合作笔记表现及最近明细时使用;商业汇总与成本参考使用商业概览工具,资料和报价使用创作者档案工具。 视频完播相关字段仅在 video_note_count 大于 0 时用于表现判断;图文 3 秒阅读率仅在统计范围内有图文笔记时用于表现…

xhs_pgy_get_creator_fans_profile

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

xhs_pgy_get_creator_fans_summary

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

xhs_pgy_get_creator_commercial_overview

根据完整 user_id 获取小红书蒲公英创作者商业概览:笔记规模和中位数、服务表现、平台标签、增长、预估成本及对比值。 查询指定日常/合作口径的商业汇总与成本参考时使用,不返回逐篇明细。逐篇表现使用创作者笔记表现工具,也可选择日常或合作口径。资料与报价使用创作者档案工具,粉丝构成使用粉丝画像工具。 查看日常内容表现选 daily(默认,不是按天汇总);查看商单、品牌合作笔记或外溢进店的汇总表现选…

xhs_pgy_get_creator_metrics_trend

根据完整 user_id 获取小红书蒲公英创作者曝光、阅读、互动中位数及预估成本的日期趋势和概览。 观察指标随时间变化时使用;中位数按 note_scope 选择日常或合作笔记,固定图文+视频、近30日、全流量,不支持自选日期。合作口径包含进店指标,日常口径的进店字段为 null;输出回显口径,不能混用。 返回指标不是每日新增量或累计总量,不可跨日期求和;可能缺少日期,不补零。 成本估算口径见字段…

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_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_search_hot_list

获取小红书搜索热榜。

xhs_search_suggestions

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

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 查询任务状态;用于继续未完成任务,每次最多等待 240 秒,不触发重处理,也不要重复提交任务。

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_sub_comments_by_comment_id

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

xhs_get_user_id_by_encrypted_user_id

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

xhs_get_user_info_by_user_id

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

xhs_get_user_info_by_profile_url

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

xhs_get_user_posted_notes_by_user_id

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

xhs_get_user_posted_notes_by_profile_url

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

xhs_get_topic_notes_by_topic_url

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

xhs_get_topic_notes_by_page_id

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

socialdatax_get_points_balance

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

Resources · 2

xhs_tool_capabilities_resource

Guide for selecting XHS tools and preserving follow-up inputs.

xhs://guides/tool-capabilities
server_card

Static discovery metadata for directory publishing and manual inspection.

mcp://server-card.json

How to use

Add to your Claude Desktop / Cursor / Cline MCP config:

{
  "mcpServers": {
    "socialdatax_\u5c0f\u7ea2\u4e66_xiaohongshu_xhs_rednote_mcp": {
      "url": "https://mcp.socialdatax.com/xhs/mcp",
      "transport": "streamable-http"
    }
  }
}