MCP.so
Sign In
S

Social Insights Assistant XHS MCP

@chatmcp

About Social Insights Assistant XHS MCP

A read-only Xiaohongshu MCP server for AI workflows, with note search, note detail retrieval, and first-level comment analysis for competitor research, audience insight, and topic discovery.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "xhs-mcp": {
      "url": "https://mcp.52choujiang.com/xhs/mcp",
      "headers": {
        "Authorization": "Bearer ${XHS_MCP_API_KEY}"
      }
    }
  }
}

Tools

23

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

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

搜索小红书 / Xiaohongshu / XHS / RedNote 相关笔记。用户需要按搜索词查找笔记时使用;已有笔记链接或 note_id 且需要单篇笔记详情时使用对应的详情工具;需要评论、回复或口播转文字时使用相应的 URL/ID 工具;支持 page_token 翻页。 返回的 note_url 在任何使用场景都必须原样保留完整 URL,包括 xsec_token 等 query 参数;例如最终回答、展示、引用、存储、输出或传递;不得用 note_id 重新拼接链接。

搜索小红书商品。用户需要按搜索词查找商品时使用;已有商品搜索结果中的 sku_id 时使用商品详情或商品评价工具;支持 page_token 翻页。

根据商品搜索结果中的 sku_id 获取小红书商品详情;不支持商品链接、spu_id 或搜索词。

根据 note_id 获取小红书蒲公英单篇笔记商业增强详情,包括正文、图片或视频摘要、作者、曝光量、阅读量、互动量和图文/视频报价。 这是蒲公英商业口径数据,不等同普通公开笔记详情;成功调用扣减 20 积分,失败不扣费。

根据笔记链接、短链接或分享文案获取小红书蒲公英单篇笔记商业增强详情。 这是蒲公英商业口径数据,不等同普通公开笔记详情;成功调用扣减 20 积分,失败不扣费。

根据商品搜索结果中的 sku_id 获取小红书商品评价,支持 sort_type、has_image 和 page_token 翻页;不支持商品链接、spu_id 或搜索词。

获取小红书搜索热榜。

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

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

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

根据口播转文字提交工具返回的 job_id 查询任务状态;用于继续未完成任务,每次最多等待 240 秒,不触发重处理,也不要重复提交任务。

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

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

根据 note_id 和一级评论 comment_id 获取二级评论,支持 page_token 翻页。

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

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

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

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

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

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

Query the current API Key account's SocialDataX points balance.

Overview

What is Social Insights Assistant XHS MCP?

Social Insights Assistant XHS MCP is a read-only MCP server for Xiaohongshu (Little Red Book) designed for AI workflows. It enables AI agents to search notes, resolve shared links into structured note details, and fetch paginated first-level comments.

How to use Social Insights Assistant XHS MCP?

Configure the server in your MCP client using the endpoint URL https://mcp.52choujiang.com/xhs/mcp and authenticate with an API key sent in the Authorization: Bearer <API_KEY> header. The example JSON config shows the xhs-mcp server setup with the API key referenced from an environment variable.

Key features of Social Insights Assistant XHS MCP

  • Search Xiaohongshu notes by keyword
  • Resolve shared links or share text into structured note details
  • Fetch paginated first-level comments
  • Designed for competitor research, audience insight, and topic discovery
  • Read-only access for safe AI integration

Use cases of Social Insights Assistant XHS MCP

  • Competitor research on Xiaohongshu
  • Audience feedback analysis from note comments
  • Topic discovery and trend identification
  • Social media intelligence workflows

FAQ from Social Insights Assistant XHS MCP

What authentication method does this server use?

It uses an API key sent as a Bearer token in the Authorization header.

What data operations are supported?

The server provides read-only access: search notes by keyword, resolve shared links into note details, and fetch paginated first-level comments.

Is the connection encrypted and what transport does it use?

The server is accessed via HTTPS at the endpoint URL https://mcp.52choujiang.com/xhs/mcp. No additional transport details are specified.

Where can I find more information or submit issues?

More details are available at the website https://52choujiang.com/assistant. Issues can be submitted via the GitHub link https://github.com/chatmcp/mcpso/issues/2139.

Frequently asked questions

What authentication method does this server use?

It uses an API key sent as a Bearer token in the `Authorization` header.

What data operations are supported?

The server provides read-only access: search notes by keyword, resolve shared links into note details, and fetch paginated first-level comments.

Is the connection encrypted and what transport does it use?

The server is accessed via HTTPS at the endpoint URL `https://mcp.52choujiang.com/xhs/mcp`. No additional transport details are specified.

Where can I find more information or submit issues?

More details are available at the website `https://52choujiang.com/assistant`. Issues can be submitted via the GitHub link `https://github.com/chatmcp/mcpso/issues/2139`.

Comments

More AI & Agents MCP servers