内容
# 小红书 MCP
本公开仓库为托管的小红书 MCP 服务提供公开连接文档和 MCP 元数据。
如果您正在寻找用于社交媒体研究工作流的小红书 MCP，请注意本仓库包含：
- 公开的 MCP 元数据和客户端配置示例
- 支持远程 MCP 的客户端的托管 `streamable-http` 端点
- 用于仅支持命令/标准输入输出的 MCP 客户端的 `mcp-remote` 回退示例
业务实现在私有环境中托管。本仓库仅公开用于社交媒体内容情报工作流的连接接口。
## 搜索别名
此 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.52choujiang.com/xhs/mcp`
- 托管的传输方式：`streamable-http`
- 认证方式：`Authorization: Bearer <SOCIALDATAX_API_KEY>`
- 产品：`SocialDataX` / `社媒数据助手`
- 网站：<https://socialdatax.com>
- 注册名称：`com.52choujiang/xhs-insights`
- 未来注册名称：`com.socialdatax/xhs-insights`
- 当前公共能力版本：`0.1.7`
## 平台 MCP
直接从支持认证远程 MCP 的客户端使用托管的 `streamable-http` 端点。对于仅支持命令/标准输入输出的 MCP 服务器的客户端，请使用 `mcp-remote` 作为本地兼容性代理。
## 工作流范围
此 MCP 服务设计用于社交媒体内容情报工作流。它不提供账户登录、发布、编辑、点赞、评论或其他账户操作。
支持的工作流包括：
- 按关键词搜索相关的 小红书 笔记，带有可选的排序、笔记类型和发布时间过滤器。
- 读取 小红书 搜索热榜，包含标题和热度值。
- 将分享的笔记链接、短链接或分享文本解析为结构化的笔记详情。
- 读取笔记详情，当调用者已经拥有笔记 ID 时。
- 获取分页的一级评论，用于评论分析。
- 获取分页的回复，在一级评论下。
- 从个人资料链接、短链接、分享文本或用户 ID 读取创作者资料数据。
- 获取分页的创作者笔记列表，从用户 ID、个人资料链接、短链接或分享文本，用于内容样式和账户研究。
- 提交视频笔记语音转文本的任务；提交完成后最多等待 15 秒，未完成的任务可以通过 `job_id` 查询。
## 工具
| 工具 | 公开用途 |
| --- | --- |
| `xhs_search_notes` | 按关键词搜索 小红书 / 小红书 笔记，带有可选的排序、笔记类型和发布时间过滤器。在每次使用返回的 `note_url` 时，例如在最终答案、展示、引用、存储、输出或转发中，必须保留完整的 URL，包括 `xsec_token`；不要从 `note_id` 重建链接。 |
| `xhs_get_search_hot_list` | 获取 小红书 / 小红书 搜索热榜，每个项目包含标题和热度值。 |
| `xhs_get_note_detail_by_note_url` | 将分享的 小红书 链接、短链接或分享文本解析为结构化的笔记详情。在每次使用返回的 `note_url` 时，例如在最终答案、展示、引用、存储、输出或转发中，必须保留完整的 URL，包括 `xsec_token`；不要从 `note_id` 重建链接。如果 `note_url` 为空，请不要从 `note_id` 合成或重建公共链接。 |
| `xhs_get_note_detail_by_note_id` | 获取结构化的笔记详情，当调用者已经拥有笔记 ID。如果返回 `note_url`，请在每次使用中保留完整的 URL，包括 `xsec_token`；不要从 `note_id` 重建链接。如果 `note_url` 为空，请不要从 `note_id` 合成或重建公共链接。 |
| `xhs_get_note_comments_by_note_id` | 获取分页的一级评论，当调用者已经拥有笔记 ID。要继续分页，请将返回的完整的 `next_page_token` 作为 `page_token` 传回；不要截断、总结、遮蔽或用省略号替换中间内容。 |
| `xhs_get_note_comments_by_note_url` | 直接从分享的笔记 URL、短链接或分享文本获取分页的一级评论。要继续分页，请将返回的完整的 `next_page_token` 作为 `page_token` 传回；不要截断、总结、遮蔽或用省略号替换中间内容。 |
| `xhs_get_note_sub_comments_by_comment_id` | 获取分页的回复，在一级评论下，通过笔记 ID 和评论 ID。要继续分页，请将返回的完整的 `next_page_token` 作为 `page_token` 传回；不要截断、总结、遮蔽或用省略号替换中间内容。 |
| `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_submit_video_speech_text_by_note_url` | 从笔记链接、短链接或分享文本提交视频笔记语音转文本的任务。提交完成后最多等待 15 秒。 |
| `xhs_submit_video_speech_text_by_note_id` | 从 `note_id` 提交视频笔记语音转文本的任务。提交完成后最多等待 15 秒。 |
| `xhs_get_video_speech_text_job` | 通过 `job_id` 查询视频笔记语音转文本的任务，无需创建新任务。此 v1 接口仅返回转录文本，不返回摘要。 |
## 快速开始
对于支持认证 `streamable-http` 的客户端，请直接使用托管的端点：
```json
{
"mcpServers": {
"socialdatax-xhs": {
"type": "streamable_http",
"url": "https://mcp.52choujiang.com/xhs/mcp",
"headers": {
"Authorization": "Bearer <SOCIALDATAX_API_KEY>"
}
}
}
}
```
一个可以直接复制的示例位于 [`examples/streamable_http_config.json`](examples/streamable_http_config.json)。
对于仅支持命令/标准输入输出的 MCP 客户端，请使用 `mcp-remote`：
```json
{
"mcpServers": {
"socialdatax-xhs": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.52choujiang.com/xhs/mcp",
"--header",
"Authorization: Bearer <SOCIALDATAX_API_KEY>"
]
}
}
}
```
Claude Code 可以直接使用远程 HTTP：
```bash
claude mcp add --transport http socialdatax-xhs https://mcp.52choujiang.com/xhs/mcp --header 'Authorization: Bearer ${SOCIALDATAX_API_KEY}'
```
在重启 Claude Code 之前，请在运行时环境或客户端秘密中持久化 `SOCIALDATAX_API_KEY`。
Claude Desktop 应在其可用时使用其远程 MCP / 连接器 UI。如果您所在版本的本地配置文件仅支持命令/标准输入输出服务器，请使用 `mcp-remote` 回退。
## 客户端示例
配置示例位于 [examples](examples/)：
- [命令/标准输入输出回退配置](mcp.json)
- [Claude Desktop 回退配置](examples/claude_desktop_config.json)
- [Cursor 远程 HTTP 配置](examples/cursor_mcp.json)
- [Codex 远程 HTTP 配置](examples/codex_config.toml)
- [直接 streamable HTTP 配置](examples/streamable_http_config.json)
## API 密钥
从产品网站请求或管理 API 访问：
<https://socialdatax.com>
在 `Authorization` 请求头中使用密钥作为 Bearer 令牌。不要将实际的 API 密钥提交到代码、文档、问题或截图中。
## 目录元数据
此仓库中的公共元数据文件：
- [server-card.json](server-card.json)：托管服务的目录元数据。官方 MCP 注册表发布使用私有源代码仓库的 `registry/xhs/server.json`，用于当前的 `com.52choujiang/xhs-insights` 条目。
- [mcp.json](mcp.json)：使用 `mcp-remote` 的通用命令/标准输入输出回退配置。
- [glama.json](glama.json)：Glama 仓库所有权元数据。
- [SUBMISSION_CHECKLIST.md](SUBMISSION_CHECKLIST.md)：MCP 目录提交的检查清单。
## 许可证
此公开仓库中的文件根据 MIT 许可证发布。许可证仅涵盖本仓库中的公开文档和配置示例。它不涵盖托管服务实现、托管基础设施或此仓库外部的任何私有后端代码。
