SocialDataX 小红书 Xiaohongshu XHS RedNote MCP

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

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

此公开仓库提供托管的小红书 MCP / Xiaohongshu MCP / XHS MCP / RedNote MCP 服务的公开连接文档和 MCP 元数据。

如果您正在寻找用于社交媒体研究工作流的小红书 MCP、Xiaohongshu MCP、XHS MCP 或 RedNote MCP，本仓库包含：

• 公开 MCP 元数据和客户端配置示例
• 为支持远程 MCP 的客户端提供的托管 streamable-http 端点
• 用于 npm 桥接程序和直接使用 mcp-remote 的命令/stdio 配置

业务实现托管于私有环境。本仓库仅公开社交媒体内容智能工作流的连接信息。

搜索别名

此 MCP 服务的常见搜索词：

• 小红书 MCP
• 小红书 数据 MCP
• 小红书 搜索 MCP
• 小红书 XHS MCP
• Xiaohongshu MCP
• Xiaohongshu data MCP
• XHS MCP
• XHS data MCP
• RedNote MCP
• RedNote data MCP
• Xiaohongshu note search MCP

服务

• 托管 MCP 端点：https://mcp.socialdatax.com/xhs/mcp
• 托管传输方式：streamable-http
• 身份验证：Authorization: Bearer <SOCIALDATAX_API_KEY>
• 产品：SocialDataX / 社媒数据助手
• 网站和 API 密钥访问：https://socialdatax.com/ai?from=github
• Registry 名称：com.52choujiang/xhs-insights
• 未来的 Registry 名称：com.socialdatax/xhs-insights
• 当前公开功能版本：0.1.15（35 个工具）
• 托管生产环境：0.1.15，包含 35 个工具；已于 2026-10-14 验证部署和经过身份验证的工具发现。视频笔记仍可通过 xhs_search_notes(note_type="video") 获取。
• 官方 MCP Registry：0.1.15（active，isLatest=true），已于 2026-10-14 发布并验证。
• 公开 GitHub 服务卡片：0.1.15，包含 35 个工具，已于 2026-10-14 同步并验证。
• 公开工具目录维护在 server-card.json 中；npm 桥接程序版本独立于托管工具目录。
• npm stdio 桥接程序：[email protected]；桥接程序包版本独立于托管功能版本。

当前功能包括加密用户 ID 解析、PGY 创作者资料、笔记表现、粉丝资料和粉丝摘要、商品评论回复的逐条查询、通过 URL 查询商品详情，以及商品详情字段重命名（images 改为 main_images；detail_images 保持不变）。

平台 MCP

对于支持经过身份验证的远程 MCP 的客户端，可直接使用托管的 streamable-http 端点。命令/stdio 客户端可在 mcp.json 中使用 npm 桥接程序，或直接配置 mcp-remote。

npm stdio 桥接程序

需要 Node.js 20.18.1 或更高版本。

仅支持命令/stdio 的 MCP 客户端可直接从 npm 安装并启动桥接程序：

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

此程序包仅将本地 stdio MCP 消息转发到托管的 SocialDataX XHS 端点。它不包含私有服务实现，也不存储 API 密钥。

无需 API 密钥即可发现公开工具目录。设置 SOCIALDATAX_API_KEY 以调用业务工具；未设置时，桥接程序仍可启动以供发现，但托管服务要求通过身份验证才能访问业务数据。

工作流范围

此 MCP 服务面向社交媒体内容情报工作流，不提供账号登录、发布、编辑、点赞、评论或其他账号操作。

支持的工作流包括：

• 查询当前 API Key 账号的 SocialDataX 积分余额。
• 按关键词搜索相关的小红书笔记，并可选择排序方式、笔记类型和发布时间筛选条件。
• 按关键词搜索小红书商品，并通过 page_token 获取后续页面。
• 根据用户提供或从商品搜索结果中复制的完整 sku_id 获取商品详情。
• 根据完整 note_id，或笔记链接、短链接、分享文本，获取一条 PGY / 蒲公英增强笔记详情；成功调用消耗 20 积分，失败不收费。
• PGY 仅适用于已入驻创作者的笔记。用户请求商业数据时使用此工具；普通笔记请求使用普通详情工具。明确返回无商业数据时，视为未入驻（pgy_commercial_data_unavailable）；停止操作，不要改用其他 ID / URL 路径重试。超时、身份验证失败和余额不足仍保留各自的错误。
• 根据用户提供或从商品搜索结果中复制的完整 sku_id 获取商品评价。
• 根据用户提供或从 xhs_get_product_review_replies 复制的 review_id，获取商品评价回复下的嵌套回复；接受不透明的 page_token 续页参数，不接受 root_review_id。
• 读取小红书搜索热榜，包含标题和热度值。
• 读取关键词或部分短语的小红书搜索建议。
• 将分享笔记链接、短链接或分享文本解析为结构化笔记详情。
• 调用方已有笔记 ID 时，读取笔记详情。
• 获取分页的一级评论，用于评论分析。
• 获取一级评论下的分页回复。
• 根据主页链接、短链接、分享文本或用户 ID 读取创作者主页数据。
• 根据用户 ID、主页链接、短链接或分享文本，获取分页的创作者笔记列表，用于内容风格和账号调研。
• 根据话题 URL、短链接、分享文本或页面 ID，获取分页的话题页笔记列表。
• 提交视频笔记语音转文字任务；提交调用最多可能等待 240 秒，未完成的任务应使用同一 job_id 继续轮询，直到任务进入终止状态。

工具

工具	公开用途
socialdatax_get_points_balance	查询当前 API Key 账户的 SocialDataX 积分余额 / 剩余积分或点数。
xhs_search_users	按关键词搜索小红书用户、账号或创作者，支持使用 page_token 翻页。已有用户 ID 或个人主页 URL 时，使用对应的用户资料工具。
xhs_search_notes	搜索小红书笔记，包括 note_type="video" 的视频笔记和 note_type="image" 的图片笔记；支持排序、发布时间筛选和使用 page_token 继续翻页。如果调用方已有笔记链接或 note_id，且需要查看某条笔记详情，请使用对应的详情工具；如需查看评论、回复或进行语音转文字，请使用对应的 URL/ID 工具。继续搜索翻页时，将完整的返回值 next_page_token 原样作为 page_token 传入；首次请求时省略 page_token。每次使用返回的 note_url 时，例如在最终答案、展示、引用、存储、输出或转发中，都必须完整保留 URL，包括 xsec_token；不得根据 note_id 重建链接。
xhs_search_images	按关键词搜索小红书图片；每条结果是一张图片及其关联笔记，一条笔记可能对应多张图片。翻页时可能没有更多结果。对于图片笔记，请使用 xhs_search_notes 并设置 note_type="image"。
xhs_search_products	按商品名称、品牌、类别或商品相关查询搜索小红书商品，支持使用 page_token 继续翻页。如果已有完整的 sku_id，包括用户提供的 sku_id，请改用 xhs_get_product_detail_by_sku_id 或 xhs_get_product_reviews。不得将商品链接、sku_id、spu_id 或 page_token 用作关键词。继续商品搜索翻页时，将完整的返回值 next_page_token 原样作为 page_token 传入；不得截断、概述、遮盖或用省略号替换中间部分。
xhs_get_product_detail_by_sku_id	根据用户提供或从 xhs_search_products 结果中复制的完整 sku_id 获取小红书商品详情。对于商品链接或分享文本，请使用 xhs_get_product_detail_by_url。此 ID 工具不接受 spu_id、商品链接或搜索关键词。
xhs_get_product_detail_by_url	通过商品 URL、短链接或包含商品链接的分享文本获取小红书商品详情，无需先搜索。返回字段与 xhs_get_product_detail_by_sku_id 相同；返回的 sku_id 可用于查看商品评价。不支持笔记链接、个人主页链接或独立分享码。
xhs_pgy_get_note_detail_by_note_id	调用方已有完整的 note_id 时，获取一条小红书蒲公英增强笔记详情，包括内容、图片或视频摘要、作者、曝光、阅读、点赞、收藏、评论、分享，以及以人民币计价的创作者图文合作报价。报价并非笔记成交价。仅限已入驻蒲公英的创作者笔记。此工具返回的是蒲公英商业数据，而非普通公开笔记详情；调用成功消耗 20 积分，失败不收费。
xhs_pgy_get_note_detail_by_note_url	通过完整笔记链接、短链接或分享文本，获取一条小红书蒲公英增强笔记详情，返回相同的蒲公英商业数据和以人民币计价的创作者图文合作报价。报价并非笔记成交价。仅限已入驻创作者的笔记。调用成功消耗 20 积分，失败不收费。
xhs_pgy_get_creator_profile	根据完整的 user_id 获取小红书蒲公英创作者资料，包括创作者及商业笔记规模、合作行业、笔记中位数、内容标签，以及以人民币计价的创作者图文合作报价。非蒲公英账号数据请使用普通用户资料工具。调用成功消耗 20 积分，失败不收费。
xhs_pgy_get_creator_notes_performance	根据完整的 user_id 获取小红书蒲公英创作者笔记表现，包括笔记数量、曝光/阅读/互动中位数、互动率、视频完播率、图片 3 秒阅读率、内容标签和笔记条目。可选参数 note_scope 选择 daily（默认值）或 cooperation，响应中会回显该范围。笔记条目最多包含最新的 15 条笔记。只有 notes[] 中的对比率是相对于平台中位数的带符号差值，可能为负数或大于 1；同名的摘要对比字段是 0 到 1 之间的不透明平台值，不得混用。调用成功消耗 20 积分，失败不收费。
xhs_pgy_get_creator_fans_profile	根据完整的 user_id 获取蒲公英粉丝分布及其数据日期。比例以 0–1 小数表示；分布可能不完整。调用成功消耗 20 积分，失败不收费。
xhs_pgy_get_creator_fans_summary	根据完整的 user_id 获取蒲公英粉丝数、增长、活跃度、阅读和互动指标。统计窗口结束日期和增长周期未指定。调用成功消耗 20 积分，失败不收费。
xhs_pgy_get_creator_metrics_trend	获取按日期索引的中位数和预估成本。需要提供 user_id；note_scope 默认为 daily，cooperation 包含外链店铺指标。中位数固定统计图文和视频、最近 30 天及全部流量；成本按字段适用范围统计。保留数据缺口；不同日期的值不能相加。调用成功消耗 20 积分，失败不收费。
xhs_pgy_get_creator_commercial_overview	获取蒲公英商业指标和预估成本。需要提供 user_id；note_scope 默认为 daily，cooperation 包含外链店铺访问。调用成功消耗 20 积分，失败不收费。
xhs_get_product_reviews	根据用户提供或从 xhs_search_products 结果中复制的完整 sku_id 获取小红书商品评价；接受 sort_type：general（综合排序，默认值）或 time_descending、has_image，并支持使用 page_token 继续翻页。继续翻页时，将完整的返回值 next_page_token 原样作为 page_token 传入；不得截断、概述、遮盖或用省略号替换中间部分。此工具不接受 spu_id、商品链接或搜索关键词。
xhs_get_product_review_replies	获取小红书商品一级评价下的回复。使用用户提供的 review_id，或从 xhs_get_product_reviews 获取该值；接受不透明的 page_token 以继续翻页。继续翻页时，将完整的返回值 next_page_token 原样作为 page_token 传入；不得截断、概述、遮盖或用省略号替换中间部分。此工具不接受 root_review_id。
xhs_get_product_review_reply_replies	获取小红书商品评价回复下的嵌套回复。使用用户提供的回复 review_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_get_note_detail_by_note_url	将分享的 XHS 链接、短链接或分享文本解析为结构化笔记详情。每次使用返回的 note_url 时，例如在最终答案、展示、引用、存储、输出或转发中，都必须完整保留 URL，包括 xsec_token；不得根据 note_id 重建链接。如果 note_url 为 null，不得根据 note_id 合成或重建公开链接。
xhs_get_note_detail_by_note_id	调用方已有笔记 ID 时，获取结构化笔记详情。如果返回了 note_url，每次使用时，例如在最终答案、展示、引用、存储、输出或转发中，都必须完整保留 URL，包括 xsec_token；不得根据 note_id 重建链接。如果 note_url 为 null，不得根据 note_id 合成或重建公开链接。
xhs_get_note_comments_by_note_id	调用方已有笔记 ID 时，获取分页的一级评论；可选评论 sort_type：default、time_descending 或 like_count_descending。继续翻页时，将完整的返回值 next_page_token 原样作为 page_token 传入；不得截断、概述、遮盖或用省略号替换中间部分。
xhs_get_note_comments_by_note_url	直接通过分享的笔记 URL、短链接或分享文本获取分页的一级评论；可选评论 sort_type：default、time_descending 或 like_count_descending。继续翻页时，将完整的返回值 next_page_token 原样作为 page_token 传入；不得截断、概述、遮盖或用省略号替换中间部分。
xhs_get_note_sub_comments_by_comment_id	根据笔记 ID 和评论 ID，获取一级评论下的分页回复。继续翻页时，将完整的返回值 next_page_token 原样作为 page_token 传入；不得截断、概述、遮盖或用省略号替换中间部分。
xhs_get_user_id_by_encrypted_user_id	将完整的加密 XHS 用户 ID 解析为稳定的 user_id，之后可用于创作者资料和已发布笔记工具。
xhs_get_user_info_by_user_id	调用方已有用户 ID 时，获取创作者资料数据。
xhs_get_user_info_by_profile_url	将个人主页链接、短链接或分享文本解析为创作者资料数据。
xhs_get_user_posted_notes_by_user_id	调用方已有用户 ID 时，获取创作者已发布笔记的分页列表。继续翻页时，将完整的返回值 next_page_token 原样作为 page_token 传入；不得截断、概述、遮盖或用省略号替换中间部分。
xhs_get_user_posted_notes_by_profile_url	通过个人主页链接、短链接或分享文本，获取创作者已发布笔记的分页列表。继续翻页时，将完整的返回值 next_page_token 原样作为 page_token 传入；不得截断、概述、遮盖或用省略号替换中间部分。
xhs_get_topic_notes_by_topic_url	通过话题 URL、短链接或分享文本，获取标签页笔记列表的分页数据；接受 sort_type：hot 或 time_descending。继续翻页时，将完整的返回值 next_page_token 原样作为 page_token 传入；不得截断、概述、遮盖或用省略号替换中间部分。
xhs_get_topic_notes_by_page_id	调用方已有标签页 page_id 时，获取标签页笔记列表的分页数据；接受 sort_type：hot 或 time_descending。继续翻页时，将完整的返回值 next_page_token 原样作为 page_token 传入；不得截断、概述、遮盖或用省略号替换中间部分。
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，查询视频笔记语音转文字任务；此工具不接受 note_id 或笔记链接，也不会创建新任务。每次调用最长等待 240 秒。如果任务尚未完成，请继续使用同一个 job_id 查询，直到任务结束。此 v1 接口返回转录文本及内容上下文，不提供摘要。

快速开始

对于支持经过身份验证的 streamable-http 的客户端，请直接使用托管端点：

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

可直接复制的示例见 examples/streamable_http_config.json。

直接配置 mcp-remote

对于仅支持命令/stdio 的 MCP 客户端，请使用 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 可以直接使用远程 HTTP：

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

重启 Claude Code 前，请将 SOCIALDATAX_API_KEY 保存到运行时环境或客户端密钥中。

如可用，Claude Desktop 应使用其远程 MCP / Connectors 界面。如果你的版本仅支持命令/stdio 服务，请使用 npm 桥接程序或下方的 mcp-remote 配置。

客户端示例

配置示例见 examples：

• npm 桥接程序命令/stdio 配置
• Claude Desktop 备用配置
• 直接使用 mcp-remote 的示例
• Cursor 远程 HTTP 配置
• Codex 远程 HTTP 配置
• 直接使用 streamable HTTP 的配置

API 密钥

请通过产品网站申请或管理 API 访问权限：

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

在 Authorization 请求标头中将密钥用作 Bearer 令牌。请勿将真实的 API 密钥值提交到代码、文档、问题或屏幕截图中。

目录元数据

此仓库中的公开元数据文件：

• server-card.json：面向目录的托管服务元数据。官方 MCP Registry 发布使用私有源代码仓库中的 registry/xhs/server.json，对应当前的 com.52choujiang/xhs-insights 条目。
• mcp.json：使用 npm 桥接程序的命令/stdio 配置；无需 API 密钥即可发现工具。
• glama.json：Glama 仓库所有权元数据。
• SUBMISSION_CHECKLIST.md：MCP 目录提交检查清单。

许可证

此公开仓库中的文件以 MIT License 发布。该许可证仅涵盖此仓库中的公开文档和配置示例，不涵盖托管服务的实现、托管基础设施或此仓库之外的任何私有后端代码。

Gemini CLI 扩展

从其公开 GitHub 仓库安装此服务：

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

出现提示时，请输入你自己的 SOCIALDATAX_API_KEY。请从 SocialDataX 获取密钥；业务工具调用会消耗 SocialDataX 积分。该扩展直接连接到现有的托管 MCP 端点，不包含私有服务实现。

使用 gemini mcp list 验证连接。若要更改已保存的密钥，请运行：

gemini extensions config socialdatax-xhs