com.52choujiang/xhs-insights
Official14 toolsSocialDataX 小红书 Xiaohongshu XHS RedNote MCP
XHS note search, hot list, details, comments/replies, profiles, transcript.
Search and analyze Xiaohongshu notes, trends, comments, user profiles, and transcripts.
Captured live from the server via tools/list.
xhs_get_note_detail_by_note_url
根据笔记链接、短链接或分享文案获取单篇小红书笔记详情。 返回的 note_url 在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接；note_url 为 null 时不要用 note_id 合成公开链接。
Parameters (1)
- note_urlstringrequired
小红书笔记链接、短链接或分享文案。支持以下形式：1) 小红书笔记长链接；2) xhslink.com 短链接；3) 包含上述任一链接的完整分享文案。
xhs_get_note_detail_by_note_id
根据 note_id 获取单篇小红书笔记详情。 返回的 note_url 非 null 时，在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接；note_url 为 null 时不要用 note_id 合成公开链接。
Parameters (1)
- note_idstringrequired
note_id 是 24 位小写十六进制稳定笔记 ID。必须原样复制搜索、详情、评论或用户发帖列表返回的完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。
xhs_search_notes
按关键词搜索相关小红书笔记。 返回的 note_url 在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接。
Parameters (6)
- keywordstringrequired
小红书搜索关键词
- pageinteger
兼容旧客户端保留的分页参数；新调用请使用 page_token。
- page_tokenstring
搜索分页令牌。首次请求留空；继续翻页时传入上一页返回的 next_page_token。传入 page_token 时会忽略 page；page_token 只能用于同一关键词、排序、笔记类型、发布时间范围和调用方的搜索链路。
- sort_typestring
搜索结果排序方式，可选：general（综合，默认）、time_descending（最新发布优先）、like_count_descending（最多点赞优先）、comment_count_descending（最多评论优先）、collect_count_descending（最多收藏优先）
- note_typestring
笔记类型筛选，可选：all（不限，默认）、image（图文）、video（视频）
- publish_time_rangestring
发布时间范围筛选，可选：all（不限，默认）、day（一天内）、week（一周内）、half_year（半年内）
xhs_get_search_hot_list
获取小红书搜索热榜。
No parameters.
xhs_submit_video_speech_text_by_note_url
提交小红书视频笔记口播转文字任务；提交完成后最多短等 15 秒，未完成时返回 job_id 和下一步查询动作。
Parameters (1)
- note_urlstringrequired
小红书视频笔记链接、短链接或分享文案。
xhs_submit_video_speech_text_by_note_id
根据小红书 note_id 提交视频笔记口播转文字任务；提交完成后最多短等 15 秒，未完成时返回 job_id 和下一步查询动作。
Parameters (1)
- note_idstringrequired
note_id 是 24 位小写十六进制稳定笔记 ID。必须原样复制搜索、详情、评论或用户发帖列表返回的完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。
xhs_get_video_speech_text_job
查询小红书视频口播转文字任务状态；只查询当前 job，不触发重处理或长等待。
Parameters (1)
- job_idstringrequired
口播转文字任务 ID。
xhs_get_note_comments_by_note_id
根据 note_id 获取单篇小红书笔记的一级评论。 返回的 next_page_token 是不透明分页令牌；继续翻页时必须将完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前用户、笔记或评论链路，不能跨用户、笔记或评论链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
Parameters (2)
- note_idstringrequired
note_id 是 24 位小写十六进制稳定笔记 ID。必须原样复制搜索、详情、评论或用户发帖列表返回的完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。
- page_tokenany
分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只绑定当前用户、笔记或评论链路，不能跨用户、笔记或评论链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
xhs_get_note_comments_by_note_url
根据笔记链接、短链接或分享文案获取单篇小红书笔记的一级评论。 返回的 next_page_token 是不透明分页令牌；继续翻页时必须将完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前用户、笔记或评论链路，不能跨用户、笔记或评论链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
Parameters (2)
- note_urlstringrequired
小红书笔记链接、短链接或分享文案。支持以下形式：1) 小红书笔记长链接；2) xhslink.com 短链接；3) 包含上述任一链接的完整分享文案。
- page_tokenany
分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只绑定当前用户、笔记或评论链路，不能跨用户、笔记或评论链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
xhs_get_note_sub_comments_by_comment_id
根据 note_id 和一级评论 comment_id 获取二级评论。 返回的 next_page_token 是不透明分页令牌；继续翻页时必须将完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前用户、笔记或评论链路，不能跨用户、笔记或评论链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
Parameters (3)
- note_idstringrequired
note_id 是 24 位小写十六进制稳定笔记 ID。必须原样复制搜索、详情、评论或用户发帖列表返回的完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。
- comment_idstringrequired
一级评论 ID。可直接传一级评论结果中的 comment_id
- page_tokenany
分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只绑定当前用户、笔记或评论链路，不能跨用户、笔记或评论链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
xhs_get_user_info_by_user_id
根据 user_id 获取单个小红书用户信息。
Parameters (1)
- user_idstringrequired
小红书用户 user_id。请直接复制搜索结果、笔记详情、用户信息或用户发帖列表返回的 user_id/author.user_id；如果只有主页链接，请使用 profile_url 入口；不要传小红书号、昵称或主页名称
xhs_get_user_info_by_profile_url
根据主页链接、短链接或分享文案获取单个小红书用户信息。
Parameters (1)
- profile_urlstringrequired
小红书主页链接、短链接或分享文案。支持以下形式：1) xiaohongshu.com/user/profile/... 主页长链；2) xhslink.com 短链接；3) 包含上述任一链接的完整分享文案。请传主页链接，不要传笔记链接。
xhs_get_user_posted_notes_by_user_id
根据 user_id 获取用户已发布笔记列表。 返回的 next_page_token 是不透明分页令牌；继续翻页时必须将完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前用户、笔记或评论链路，不能跨用户、笔记或评论链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
Parameters (2)
- user_idstringrequired
小红书用户 user_id。请直接复制搜索结果、笔记详情、用户信息或用户发帖列表返回的 user_id/author.user_id；如果只有主页链接，请使用 profile_url 入口；不要传小红书号、昵称或主页名称
- page_tokenany
分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只绑定当前用户、笔记或评论链路，不能跨用户、笔记或评论链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
xhs_get_user_posted_notes_by_profile_url
根据主页链接、短链接或分享文案获取用户已发布笔记列表。 返回的 next_page_token 是不透明分页令牌；继续翻页时必须将完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前用户、笔记或评论链路，不能跨用户、笔记或评论链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
Parameters (2)
- profile_urlstringrequired
小红书主页链接、短链接或分享文案。支持以下形式：1) xiaohongshu.com/user/profile/... 主页长链；2) xhslink.com 短链接；3) 包含上述任一链接的完整分享文案。请传主页链接，不要传笔记链接。
- page_tokenany
分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只绑定当前用户、笔记或评论链路，不能跨用户、笔记或评论链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
README not available yet.
Install
claude_desktop_config.json
{
"mcpServers": {
"xhs-insights": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.52choujiang.com/xhs/mcp"
]
}
}
}Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.