# SocialDataX 小红书 Xiaohongshu XHS RedNote MCP

> 小红书 Xiaohongshu XHS RedNote MCP

- Listing: https://mcp-hunter.com/server/socialdatax-xiaohongshu-xhs-rednote-mcp
- Launch week: Week 44, 2026 (26 Oct to 1 Nov 2026)
- Week archive: https://mcp-hunter.com/week/2026/44
- Currently ranked: #3
- Votes: 0
- Evidence on file: Verified 2026-10-19 | 35 tools | responded in 1990ms

## From the maker

XHS search/details, PGY, comments/replies, users/ID resolution/posts, transcript Hosted Streamable HTTP MCP; 35 tools, version 0.1.15. Requires your own Bearer API key; business calls consume credits. Website and API key: https://socialdatax.com/ai?from=mcp-hunter

## Links

- Product: https://socialdatax.com/ai?from=mcp-hunter
- Docs: https://socialdatax.com/ai?from=mcp-hunter
- Source: https://github.com/DevinChen2014/xiaohongshu-xhs-rednote-mcp

## How to connect

Streamable HTTP endpoint:

```
https://mcp.socialdatax.com/xhs/mcp
```

## What we found when we connected

Verified 2026-10-19 | 35 tools | responded in 1990ms

- Protocol revision: 2025-11-25
- Server identified itself as: xhs_mcp 0.1.15
- Tools exposed: 35
- Tool descriptions: present
- tools/list round trip: 1990ms
- Tested: 2026-10-19 06:37 UTC

### The 35 tools it exposed

Every name below came back from this server's own tools/list response on the date above. So did each description, parameter list and label like "read-only": they are the server describing itself. We did not call any of them.

- xhs_get_note_detail_by_note_url (read-only, reaches outside services): 根据笔记链接、短链接或分享文案获取单篇小红书笔记详情。 返回的 note_url 在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接；note_url 为 null 时不要用 note_id 合成公开链接。
  - Parameters: note_url (required)
- xhs_get_note_detail_by_note_id (read-only, reaches outside services): 根据 note_id 获取单篇小红书笔记详情。 返回的 note_url 非 null 时，在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接；note_url 为 null 时不要用 note_id 合成公开链接。
  - Parameters: note_id (required)
- xhs_search_notes (read-only, reaches outside services): 搜索小红书 / 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 重新拼接链接。
  - Parameters: keyword (required), page_token, sort_type, note_type, publish_time_range
- xhs_search_images (read-only, reaches outside services): 按搜索词搜索小红书图片；已有笔记链接或 note_id，且需要读取该篇笔记详情时，使用对应详情工具。每项为一张图片及关联笔记，同一笔记可返回多张图片；page_token 可用于尝试下一页，不保证下一页有结果；结果按平台相关性排序，不承诺每条内容包含原词，不承诺完整召回；需要图文笔记而非单张图片时使用 xhs_search_notes(note_type="image")；需要视频笔记时使用 xhs_search_notes(note_type="video")。
  - Parameters: keyword (required), page_token
- xhs_search_users (read-only, reaches outside services): 按搜索词搜索小红书用户、账号或博主，支持分页；已有用户 ID 或主页链接时，使用用户资料工具。
  - Parameters: keyword (required), page_token
- xhs_search_products (read-only, reaches outside services): 搜索小红书商品。用户需要按搜索词查找商品时使用；已有完整 sku_id（包括用户直接提供）时使用商品详情或商品评价工具，已有商品链接或分享文案时使用 xhs_get_product_detail_by_url；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容。
  - Parameters: keyword (required), page_token
- xhs_get_product_detail_by_sku_id (read-only, reaches outside services): 根据小红书商品 sku_id 获取商品详情；已有该 ID 时直接使用，否则可从 xhs_search_products 获取。只有商品链接、短链接或分享文案时使用 xhs_get_product_detail_by_url；本工具不支持商品链接、spu_id 或搜索词。
  - Parameters: sku_id (required)
- xhs_get_product_detail_by_url (read-only, reaches outside services): 根据小红书商品链接、短链接或分享文案获取商品详情，无需先搜索。已有完整 sku_id 时使用 xhs_get_product_detail_by_sku_id；返回的 sku_id 可继续用于商品评价工具。
  - Parameters: url (required)
- xhs_pgy_get_note_detail_by_note_id (read-only, reaches outside services): 根据 note_id 获取小红书蒲公英单篇笔记商业增强详情，包括正文、图片或视频摘要、作者、曝光量、阅读量、点赞、收藏、评论、分享和创作者图文/视频合作报价（单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作）。 仅适用于已入驻蒲公英博主的笔记；用户明确要求蒲公英商业数据时使用，普通笔记详情使用普通详情工具。 用户只提曝光量、阅读量或报价且上下文未明确蒲公英口径时，先澄清商业口径和成功 20 积分的费用；上下文已明确时不重复确认。 这是蒲公英商业口径数据，不等同普通公开笔记详情；成功调用扣减 20 积分，失败不扣费。 查询明确无商业数据时按博主未入驻蒲公英处理，返回 pgy_commercial_data_unavailable，不换 ID/链接入口重试；超时、鉴权和余额不足等错误不表示未入驻。
  - Parameters: note_id (required)
- xhs_pgy_get_note_detail_by_note_url (read-only, reaches outside services): 根据笔记链接、短链接或分享文案获取小红书蒲公英单篇笔记商业增强详情，包括曝光量、阅读量、点赞、收藏、评论、分享和创作者图文/视频合作报价（单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作）。 仅适用于已入驻蒲公英博主的笔记；用户明确要求蒲公英商业数据时使用，普通笔记详情使用普通详情工具。 用户只提曝光量、阅读量或报价且上下文未明确蒲公英口径时，先澄清商业口径和成功 20 积分的费用；上下文已明确时不重复确认。 这是蒲公英商业口径数据，不等同普通公开笔记详情；成功调用扣减 20 积分，失败不扣费。 查询明确无商业数据时按博主未入驻蒲公英处理，返回 pgy_commercial_data_unavailable，不换 ID/链接入口重试；超时、鉴权和余额不足等错误不表示未入驻。
  - Parameters: note_url (required)
- xhs_pgy_get_creator_profile (read-only, reaches outside services): 根据完整 user_id 获取小红书蒲公英创作者档案、粉丝和商业笔记规模、合作行业、笔记阅读与互动中位数、内容分类、特征标签和创作者图文/视频合作报价。 查询蒲公英创作者资料和报价时使用；普通账号资料使用用户信息工具。 笔记表现使用创作者笔记表现工具；粉丝画像使用创作者粉丝画像工具；指标随日期变化使用创作者指标趋势工具。图文和视频报价单位为人民币元；零值不表示免费合作。 成功返回档案字段和 points；成功调用扣减 20 积分，失败不扣费。
  - Parameters: user_id (required)
- xhs_pgy_get_creator_notes_performance (read-only, reaches outside services): 根据完整 user_id 获取小红书蒲公英创作者笔记表现，包括笔记数量、曝光/阅读/互动中位数、互动率、视频完播率、图文 3 秒阅读率、内容标签和笔记明细。 查询日常或合作笔记表现及最近明细时使用；商业汇总与成本参考使用商业概览工具，资料和报价使用创作者档案工具。 视频完播相关字段仅在 video_note_count 大于 0 时用于表现判断；图文 3 秒阅读率仅在统计范围内有图文笔记时用于表现判断；其他情况下 0 值不表示对应表现为 0%。 固定近30日、图文＋视频、全流量，不支持自选日期或笔记类型；明细最多 15 篇，不是全量列表。仅 notes[] 内的 *_benchmark_rate 是相较于平台中位数的相对差异，允许负数和超过 1，不能当作排名比例；汇总层同名字段仍是平台返回的 0 到 1 对比值，计算方式未公开，不能混用。 成功返回表现字段和 points；成功调用扣减 20 积分，失败不扣费。
  - Parameters: user_id (required), note_scope
- xhs_pgy_get_creator_fans_profile (read-only, reaches outside services): 根据完整 user_id 获取小红书蒲公英创作者粉丝画像，包括年龄、性别、地域、城市、兴趣和设备品牌分布及数据日期。 查询粉丝构成时使用；粉丝规模、增长、活跃、阅读和互动情况使用创作者粉丝汇总工具；创作者资料和报价使用创作者档案工具。 使用平台默认统计范围，不支持指定日期；分布不保证完整，不能据此推算粉丝人数或补齐其他类别。 成功返回画像字段和 points；成功调用扣减 20 积分，失败不扣费。
  - Parameters: user_id (required)
- xhs_pgy_get_creator_fans_summary (read-only, reaches outside services): 根据完整 user_id 获取小红书蒲公英创作者粉丝总数、平台增长指标、活跃、阅读和互动粉丝人数及占比。 查询粉丝规模和活跃情况时使用；年龄、性别、地域和兴趣等构成使用创作者粉丝画像工具。 不支持指定日期或统计周期；增长周期及各统计窗口截止日期未提供，不能按查询日期推算，不承诺指定期间增长数据。 成功直接返回汇总字段和 points；成功调用扣减 20 积分，失败不扣费。
  - Parameters: user_id (required)
- xhs_pgy_get_creator_commercial_overview (read-only, reaches outside services): 根据完整 user_id 获取小红书蒲公英创作者商业概览：笔记规模和中位数、服务表现、平台标签、增长、预估成本及对比值。 查询指定日常/合作口径的商业汇总与成本参考时使用，不返回逐篇明细。逐篇表现使用创作者笔记表现工具，也可选择日常或合作口径。资料与报价使用创作者档案工具，粉丝构成使用粉丝画像工具。 查看日常内容表现选 daily（默认，不是按天汇总）；查看商单、品牌合作笔记或外溢进店的汇总表现选 cooperation。输出回显口径，不能混用；不是对全部字段统一筛选，note_count 不能解释为所选口径的笔记数。两种口径的成本估计依据不同，均不代表实际成交成本或ROI。 不支持指定日期，统计截止日期未提供；进店不等于订单或成交，不据此推断调用方自己的投放成绩。 成功直接返回业务字段和 points；成功调用扣减 20 积分，失败不扣费。
  - Parameters: user_id (required), note_scope
- xhs_pgy_get_creator_metrics_trend (read-only, reaches outside services): 根据完整 user_id 获取小红书蒲公英创作者曝光、阅读、互动中位数及预估成本的日期趋势和概览。 观察指标随时间变化时使用；中位数按 note_scope 选择日常或合作笔记，固定图文＋视频、近30日、全流量，不支持自选日期。合作口径包含进店指标，日常口径的进店字段为 null；输出回显口径，不能混用。 返回指标不是每日新增量或累计总量，不可跨日期求和；可能缺少日期，不补零。 成本估算口径见字段说明，不代表实际成交成本；按图文/视频拆分的成本及商业汇总使用商业概览工具，逐篇表现使用笔记表现工具。 成功直接返回业务字段和 points；成功调用扣减 20 积分，失败不扣费。
  - Parameters: user_id (required), note_scope
- xhs_get_product_reviews (read-only, reaches outside services): 根据小红书商品 sku_id 获取商品评价；已有该 ID 时直接使用，否则可从 xhs_search_products 获取；支持 sort_type、has_image 和 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容；不支持商品链接、spu_id 或搜索词。
  - Parameters: sku_id (required), page_token, sort_type, has_image
- xhs_get_product_review_replies (read-only, reaches outside services): 根据一级商品评价 review_id 获取其下回复；已有该 ID 时直接使用，否则可从 xhs_get_product_reviews 获取；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容；不接受 root_review_id。
  - Parameters: review_id (required), page_token
- xhs_get_product_review_reply_replies (read-only, reaches outside services): 根据商品评价回复 review_id 获取其下的嵌套回复；已有该 ID 时直接使用，否则可从 xhs_get_product_review_replies 获取；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容；不接受 root_review_id。
  - Parameters: review_id (required), page_token
- xhs_get_search_hot_list (read-only, reaches outside services): 获取小红书搜索热榜。
- xhs_search_suggestions (read-only, reaches outside services): 根据搜索词获取小红书候选搜索建议，用于补全搜索词；需要实际搜索笔记或商品时，分别使用 xhs_search_notes 或 xhs_search_products。
  - Parameters: keyword (required)
- xhs_submit_video_speech_text_by_note_url (reaches outside services): 根据小红书视频笔记链接、短链接或分享文案提交口播转文字任务；提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。
  - Parameters: note_url (required)
- xhs_submit_video_speech_text_by_note_id (reaches outside services): 根据小红书 note_id 提交视频笔记口播转文字任务；提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。
  - Parameters: note_id (required)
- xhs_get_video_speech_text_job (read-only, reaches outside services): 根据用户提供的有效 job_id，或提交工具返回的 job_id 查询任务状态；用于继续未完成任务，每次最多等待 240 秒，不触发重处理，也不要重复提交任务。
  - Parameters: job_id (required)
- xhs_get_note_comments_by_note_id (read-only, reaches outside services): 根据 note_id 获取单篇小红书笔记的一级评论，支持 sort_type 评论排序和 page_token 翻页。
  - Parameters: note_id (required), page_token, sort_type
- xhs_get_note_comments_by_note_url (read-only, reaches outside services): 根据笔记链接、短链接或分享文案获取单篇小红书笔记的一级评论，支持 sort_type 评论排序和 page_token 翻页。
  - Parameters: note_url (required), page_token, sort_type
- xhs_get_note_sub_comments_by_comment_id (read-only, reaches outside services): 根据 note_id 和一级评论 comment_id 获取二级评论；用户已提供完整合法的 ID 组合时直接使用；已有 note_id 或笔记链接但缺少必需 ID 时，调用对应一级评论工具补全；缺少笔记定位信息时向用户索取；支持 page_token 翻页。
  - Parameters: note_id (required), comment_id (required), page_token
- xhs_get_user_id_by_encrypted_user_id (read-only, reaches outside services): 根据完整加密用户 ID 获取稳定 user_id。
  - Parameters: encrypted_user_id (required)
- xhs_get_user_info_by_user_id (read-only, reaches outside services): 根据 user_id 获取单个小红书用户信息。
  - Parameters: user_id (required)
- xhs_get_user_info_by_profile_url (read-only, reaches outside services): 根据主页链接、短链接或分享文案获取单个小红书用户信息。
  - Parameters: profile_url (required)
- xhs_get_user_posted_notes_by_user_id (read-only, reaches outside services): 根据 user_id 获取用户已发布笔记列表，支持 page_token 翻页。
  - Parameters: user_id (required), page_token
- xhs_get_user_posted_notes_by_profile_url (read-only, reaches outside services): 根据主页链接、短链接或分享文案获取用户已发布笔记列表，支持 page_token 翻页。
  - Parameters: profile_url (required), page_token
- xhs_get_topic_notes_by_topic_url (read-only, reaches outside services): 根据话题页链接、短链接或分享文案获取标签页笔记列表，支持 sort_type 排序和 page_token 翻页。
  - Parameters: topic_url (required), page_token, sort_type
- xhs_get_topic_notes_by_page_id (read-only, reaches outside services): 根据 page_id 获取标签页笔记列表，支持 sort_type 排序和 page_token 翻页。
  - Parameters: page_id (required), page_token, sort_type
- socialdatax_get_points_balance (read-only, reaches outside services): 查询当前 API Key 账户的 SocialDataX 积分余额、剩余积分或点数 / remaining points balance。需要充值时请访问 https://socialdatax.com/dashboard/billing。

---

Anything above describes one moment on the date shown. We do not re-test on a schedule, so nothing here says what this server is doing now. We have not audited its code, its data handling or its permissions, and this is not a safety rating.

Canonical page: https://mcp-hunter.com/server/socialdatax-xiaohongshu-xhs-rednote-mcp
The rest of Week 44, 2026: https://mcp-hunter.com/week/2026/44
MCP Hunter is the weekly launch board for MCP products: https://mcp-hunter.com