SocialDataX 小红书 Xiaohongshu XHS RedNote MCP
REMOTE · MCP.52CHOUJIANG.COM · SCANNED AUG 3
XHS note search, hot list, details, comments/replies, profiles, transcript.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →
Endpoint Security71
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation is enforced on tool calls, but the challenge carries no valid RFC 9728 metadata, so a client cannot discover where to get a token. See how to fix → View diagnostics → Fail
- HTTPS not yet verified: we couldn't determine whether a plaintext access path exists. View diagnostics → Unverified
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability60
- 50% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Partial
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 2881 tokens (~180/item across 16 items; 14 tools + 2 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
- Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage96
- 93% of tools have a non-trivial description (not blank, and not just the tool's name).Partial
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
remote · mcp.52choujiang.com
claude mcp add --transport http com-52choujiang-xhs-insights https://mcp.52choujiang.com/xhs/mcp
[mcp_servers.com-52choujiang-xhs-insights] url = "https://mcp.52choujiang.com/xhs/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"com-52choujiang-xhs-insights": {
"type": "remote",
"url": "https://mcp.52choujiang.com/xhs/mcp",
"enabled": true
}
}
} openclaw mcp add com-52choujiang-xhs-insights --url https://mcp.52choujiang.com/xhs/mcp --transport streamable-http
mcp_servers:
com-52choujiang-xhs-insights:
url: "https://mcp.52choujiang.com/xhs/mcp" {
"mcpServers": {
"com-52choujiang-xhs-insights": {
"type": "http",
"url": "https://mcp.52choujiang.com/xhs/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 3 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
- 31 Jul 26 +4
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 29 Jul 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.
- 28 Jul 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.
- 27 Jul 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 26 Jul 26 62
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Probed https://mcp.52choujiang.com/xhs/mcp
TLS valid
Negotiated TLS 1.2 with TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=mcp.52choujiang.com | CN=TrustAsia DV TLS RSA CA 2025,O=TrustAsia Technologies\, Inc.,C=CN | 20 Jun 2026 | 17 Sept 2026 | RSA 2048 | SHA256-RSA | 532ae96f05b6fbb35eb2296c034c190 |
| SANs: mcp.52choujiang.com | ||||||
| CN=TrustAsia DV TLS RSA CA 2025,O=TrustAsia Technologies\, Inc.,C=CN (CA) | CN=DigiCert Global Root G2,OU=www.digicert.com,O=DigiCert Inc,C=US | 8 Jan 2025 | 7 Jan 2035 | RSA 4096 | SHA256-RSA | 926323b4964e368461512def1a5d52c |
DNSSEC insecure
Validation of mcp.52choujiang.com. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| com. | present | 19718 | 13 | Verified |
| 52choujiang.com. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication Challenged, unverified
The endpoint asked for a token, but we could not retrieve and validate the RFC 9728 metadata that tells a client how to obtain one.
| Result | Challenged, unverified |
|---|---|
| Enforced | On tool calls |
| HTTP status | 200 |
WWW-Authenticate challenge Bearer error="missing_api_key", error_description="API Key required"
Bearer error="missing_api_key", error_description="API Key required"Protected resource metadata
| Retrieved | No |
|---|---|
| Problem | no_resource_metadata |
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://mcp.52choujiang.com/xhs/mcp | Verified | 200 | |
| http (plaintext) | http://mcp.52choujiang.com/xhs/mcp | Inconclusive | 405 |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
xhs_get_note_comments_by_note_id ~378
根据 note_id 获取单篇小红书笔记的一级评论，支持 sort_type 评论排序和 page_token 翻页。 返回的 next_page_token 是不透明分页令牌；继续翻页时必须将完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前用户、笔记、排序或评论链路，不能跨用户、笔记或评论链路复用；一级评论还不能跨排序复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
| Name | Type | Req | Description |
|---|---|---|---|
| note_id | string | yes | note_id 是 24 位小写十六进制稳定笔记 ID。必须原样复制搜索、详情、评论或用户发帖列表返回的完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。 |
| page_token | — | — | 分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只绑定当前用户、笔记、排序或评论链路，不能跨用户、笔记或评论链路复用；一级评论还不能跨排序复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| sort_type | string | — | 评论排序方式，可选：default（默认/综合排序）、time_descending（最新评论优先）、like_count_descending（点赞最多优先） |
| Name | Type | Req | Description |
|---|---|---|---|
| comment_count | integer | yes | 整篇笔记的总评论数，含一级评论与回复；不是当前页 items 数量 |
| items | array | yes | 当前页一级评论列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前用户、笔记或评论链路，不能跨用户、笔记或评论链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| top_level_comment_count | — | yes | 整篇笔记的一级评论总数，不含回复；不是当前页 items 数量；无法获取时为 null |
No examples provided.
xhs_get_note_comments_by_note_url ~391
根据笔记链接、短链接或分享文案获取单篇小红书笔记的一级评论，支持 sort_type 评论排序和 page_token 翻页。 返回的 next_page_token 是不透明分页令牌；继续翻页时必须将完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前用户、笔记、排序或评论链路，不能跨用户、笔记或评论链路复用；一级评论还不能跨排序复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
| Name | Type | Req | Description |
|---|---|---|---|
| note_url | string | yes | 小红书笔记链接、短链接或分享文案。支持以下形式：1) 小红书笔记长链接；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。 |
| page_token | — | — | 分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只绑定当前用户、笔记、排序或评论链路，不能跨用户、笔记或评论链路复用；一级评论还不能跨排序复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| sort_type | string | — | 评论排序方式，可选：default（默认/综合排序）、time_descending（最新评论优先）、like_count_descending（点赞最多优先） |
| Name | Type | Req | Description |
|---|---|---|---|
| comment_count | integer | yes | 整篇笔记的总评论数，含一级评论与回复；不是当前页 items 数量 |
| items | array | yes | 当前页一级评论列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前用户、笔记或评论链路，不能跨用户、笔记或评论链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| top_level_comment_count | — | yes | 整篇笔记的一级评论总数，不含回复；不是当前页 items 数量；无法获取时为 null |
No examples provided.
xhs_get_note_detail_by_note_id ~165
根据 note_id 获取单篇小红书笔记详情。 返回的 note_url 非 null 时，在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接；note_url 为 null 时不要用 note_id 合成公开链接。
| Name | Type | Req | Description |
|---|---|---|---|
| note_id | string | yes | note_id 是 24 位小写十六进制稳定笔记 ID。必须原样复制搜索、详情、评论或用户发帖列表返回的完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。 |
| Name | Type | Req | Description |
|---|---|---|---|
| author | object | yes | 作者信息；详情页不返回小红书号 |
| collect_count | integer | yes | 收藏数 |
| comment_count | integer | yes | 评论数 |
| content | string | yes | 笔记正文 |
| cover_image_url | string | yes | 统一封面图 |
| image_items | array | yes | 图片结构化明细；每项都表示一张图片，Live 图会在对应项携带 live_photo 摘要 |
| ip_location | string | yes | 笔记发布时的 IP 属地；没有 IP 属地时为空字符串 |
| like_count | integer | yes | 点赞数 |
| mentioned_users | array | yes | 笔记正文中 @ 到的用户列表；无 @ 时为空数组 |
| note_id | string | yes | note_id 是 24 位小写十六进制稳定笔记 ID。必须原样复制搜索、详情、评论或用户发帖列表返回的完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。 |
| note_type | string | yes | 笔记类型；当前公开值固定为 image 或 video |
| note_url | — | yes | note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。无法提供可用链接时为 null；note_url 为 null 时不要用 note_id 合成公开链接。 |
| publish_time | integer | yes | 发布时间，秒级 Unix 时间戳 |
| share_count | integer | yes | 分享数 |
| title | string | yes | 笔记标题 |
| topic_tags | array | yes | 笔记详情中的话题标签；无话题时为空数组 |
| update_time | — | yes | 更新时间，秒级 Unix 时间戳；没有有效更新时间时为 null |
| video | — | yes | 视频摘要信息；无可用视频摘要时为 null |
No examples provided.
xhs_get_note_detail_by_note_url ~175
根据笔记链接、短链接或分享文案获取单篇小红书笔记详情。 返回的 note_url 在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接；note_url 为 null 时不要用 note_id 合成公开链接。
| Name | Type | Req | Description |
|---|---|---|---|
| note_url | string | yes | 小红书笔记链接、短链接或分享文案。支持以下形式：1) 小红书笔记长链接；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。 |
| Name | Type | Req | Description |
|---|---|---|---|
| author | object | yes | 作者信息；详情页不返回小红书号 |
| collect_count | integer | yes | 收藏数 |
| comment_count | integer | yes | 评论数 |
| content | string | yes | 笔记正文 |
| cover_image_url | string | yes | 统一封面图 |
| image_items | array | yes | 图片结构化明细；每项都表示一张图片，Live 图会在对应项携带 live_photo 摘要 |
| ip_location | string | yes | 笔记发布时的 IP 属地；没有 IP 属地时为空字符串 |
| like_count | integer | yes | 点赞数 |
| mentioned_users | array | yes | 笔记正文中 @ 到的用户列表；无 @ 时为空数组 |
| note_id | string | yes | note_id 是 24 位小写十六进制稳定笔记 ID。必须原样复制搜索、详情、评论或用户发帖列表返回的完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。 |
| note_type | string | yes | 笔记类型；当前公开值固定为 image 或 video |
| note_url | — | yes | note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。无法提供可用链接时为 null；note_url 为 null 时不要用 note_id 合成公开链接。 |
| publish_time | integer | yes | 发布时间，秒级 Unix 时间戳 |
| share_count | integer | yes | 分享数 |
| title | string | yes | 笔记标题 |
| topic_tags | array | yes | 笔记详情中的话题标签；无话题时为空数组 |
| update_time | — | yes | 更新时间，秒级 Unix 时间戳；没有有效更新时间时为 null |
| video | — | yes | 视频摘要信息；无可用视频摘要时为 null |
No examples provided.
xhs_get_note_sub_comments_by_comment_id ~326
根据 note_id 和一级评论 comment_id 获取二级评论。 返回的 next_page_token 是不透明分页令牌；继续翻页时必须将完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前用户、笔记或评论链路，不能跨用户、笔记或评论链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
| Name | Type | Req | Description |
|---|---|---|---|
| comment_id | string | yes | 一级评论 ID。可直接传一级评论结果中的 comment_id |
| note_id | string | yes | note_id 是 24 位小写十六进制稳定笔记 ID。必须原样复制搜索、详情、评论或用户发帖列表返回的完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。 |
| page_token | — | — | 分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只绑定当前用户、笔记或评论链路，不能跨用户、笔记或评论链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 当前页二级评论列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前用户、笔记或评论链路，不能跨用户、笔记或评论链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
No examples provided.
xhs_get_search_hot_list ~20
获取小红书搜索热榜。
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 搜索热榜条目列表 |
No examples provided.
xhs_get_user_info_by_profile_url ~124
根据主页链接、短链接或分享文案获取单个小红书用户信息。
| Name | Type | Req | Description |
|---|---|---|---|
| profile_url | string | yes | 小红书主页链接、短链接或分享文案。支持以下形式：1) xiaohongshu.com/user/profile/... 主页长链；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。请传主页链接，不要传笔记链接。 |
| Name | Type | Req | Description |
|---|---|---|---|
| avatar_url | — | yes | 用户头像链接；没有头像链接时为 null |
| bio | string | yes | 用户个人简介（biography）；没有简介时为空字符串 |
| follower_count | integer | yes | 粉丝数 |
| following_count | integer | yes | 关注数 |
| ip_location | string | yes | 用户 IP 属地；没有 IP 属地时为空字符串 |
| is_enterprise_account | boolean | yes | 是否为企业账号 |
| is_professional_account | boolean | yes | 是否为专业号 |
| name | string | yes | 用户名称 |
| posted_note_count | integer | yes | 已发布笔记数 |
| profile_tags | array | yes | 主页头部标签名称列表；没有标签时为空数组 |
| profile_url | — | yes | 用户主页链接；没有主页链接时为 null |
| received_collect_count | integer | yes | 用户内容累计被收藏数 |
| received_like_count | integer | yes | 用户内容累计收到的点赞数 |
| red_id | string | yes | 用户公开小红书号；没有小红书号时为空字符串 |
| user_id | string | yes | 用户 user_id |
| verification_category | string | yes | 认证补充信息；可能是行业类目或认证主体名称；未认证或没有认证信息时为空字符串 |
| verification_name | string | yes | 认证主体名称；没有认证主体时为空字符串 |
| verified | boolean | yes | 是否已认证 |
No examples provided.
xhs_get_user_info_by_user_id ~89
根据 user_id 获取单个小红书用户信息。
| Name | Type | Req | Description |
|---|---|---|---|
| user_id | string | yes | 小红书用户 user_id。请直接复制搜索结果、笔记详情、用户信息或用户发帖列表返回的 user_id/author.user_id；如果只有主页链接，请使用 profile_url 入口；不要传小红书号、昵称或主页名称 |
| Name | Type | Req | Description |
|---|---|---|---|
| avatar_url | — | yes | 用户头像链接；没有头像链接时为 null |
| bio | string | yes | 用户个人简介（biography）；没有简介时为空字符串 |
| follower_count | integer | yes | 粉丝数 |
| following_count | integer | yes | 关注数 |
| ip_location | string | yes | 用户 IP 属地；没有 IP 属地时为空字符串 |
| is_enterprise_account | boolean | yes | 是否为企业账号 |
| is_professional_account | boolean | yes | 是否为专业号 |
| name | string | yes | 用户名称 |
| posted_note_count | integer | yes | 已发布笔记数 |
| profile_tags | array | yes | 主页头部标签名称列表；没有标签时为空数组 |
| profile_url | — | yes | 用户主页链接；没有主页链接时为 null |
| received_collect_count | integer | yes | 用户内容累计被收藏数 |
| received_like_count | integer | yes | 用户内容累计收到的点赞数 |
| red_id | string | yes | 用户公开小红书号；没有小红书号时为空字符串 |
| user_id | string | yes | 用户 user_id |
| verification_category | string | yes | 认证补充信息；可能是行业类目或认证主体名称；未认证或没有认证信息时为空字符串 |
| verification_name | string | yes | 认证主体名称；没有认证主体时为空字符串 |
| verified | boolean | yes | 是否已认证 |
No examples provided.
xhs_get_user_posted_notes_by_profile_url ~332
根据主页链接、短链接或分享文案获取用户已发布笔记列表。 返回的 next_page_token 是不透明分页令牌；继续翻页时必须将完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前用户、笔记或评论链路，不能跨用户、笔记或评论链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
| Name | Type | Req | Description |
|---|---|---|---|
| page_token | — | — | 分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只绑定当前用户、笔记或评论链路，不能跨用户、笔记或评论链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| profile_url | string | yes | 小红书主页链接、短链接或分享文案。支持以下形式：1) xiaohongshu.com/user/profile/... 主页长链；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。请传主页链接，不要传笔记链接。 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 当前页用户发帖摘要列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前用户、笔记或评论链路，不能跨用户、笔记或评论链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
No examples provided.
xhs_get_user_posted_notes_by_user_id ~297
根据 user_id 获取用户已发布笔记列表。 返回的 next_page_token 是不透明分页令牌；继续翻页时必须将完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前用户、笔记或评论链路，不能跨用户、笔记或评论链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
| Name | Type | Req | Description |
|---|---|---|---|
| page_token | — | — | 分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只绑定当前用户、笔记或评论链路，不能跨用户、笔记或评论链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| user_id | string | yes | 小红书用户 user_id。请直接复制搜索结果、笔记详情、用户信息或用户发帖列表返回的 user_id/author.user_id；如果只有主页链接，请使用 profile_url 入口；不要传小红书号、昵称或主页名称 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 当前页用户发帖摘要列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前用户、笔记或评论链路，不能跨用户、笔记或评论链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
No examples provided.
xhs_get_video_speech_text_job ~54
查询小红书视频口播转文字任务状态；每次最多等待 240 秒，不触发重处理。
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | 口播转文字任务 ID。 |
| Name | Type | Req | Description |
|---|---|---|---|
| content_id | string | yes | 平台内容 ID。 |
| content_meta | object | yes | 作品上下文信息，便于结合转写内容做口播分析。 |
| content_type | string | yes | 内容类型。 |
| error | — | yes | 失败或过期时的稳定错误结构；非终态或成功时为 null。 |
| is_terminal | boolean | yes | 是否已终态。 |
| job_id | string | yes | 任务 ID。 |
| message | string | yes | 面向用户/AI 的状态说明。 |
| next_action | — | yes | 非终态时建议的下一步查询动作。 |
| next_poll_after_seconds | — | yes | 建议下次查询前等待的秒数；非终态时可用。 |
| platform | string | yes | 任务所属平台。 |
| source_id | string | yes | 任务来源 ID。 |
| status | string | yes | 任务状态。 |
| transcript | — | yes | 成功时的口播转文字结果；非终态或失败时为 null。 |
No examples provided.
xhs_search_notes ~307
按关键词搜索相关小红书笔记。 返回的 note_url 在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接。
| Name | Type | Req | Description |
|---|---|---|---|
| keyword | string | yes | 小红书搜索关键词 |
| note_type | string | — | 笔记类型筛选，可选：all（不限，默认）、image（图文）、video（视频） |
| page_token | string | — | 搜索分页令牌。首次请求留空；继续翻页时传入上一页返回的 完整 next_page_token 原样作为 page_token 传回。page_token 只能用于同一关键词、排序、笔记类型、发布时间范围和调用方的搜索链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。 |
| publish_time_range | string | — | 发布时间范围筛选，可选：all（不限，默认）、day（一天内）、week（一周内）、half_year（半年内） |
| sort_type | string | — | 搜索结果排序方式，可选：general（综合，默认）、time_descending（最新发布优先）、like_count_descending（最多点赞优先）、comment_count_descending（最多评论优先）、collect_count_descending（最多收藏优先） |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 搜索结果中的笔记列表，已过滤非笔记卡片与不可公开笔记；当前页过滤后可能为空数组 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果或无法继续 token 翻页。继续搜索时必须将完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一关键词、排序、笔记类型、发布时间范围和调用方的搜索链路。items 为空时不要单独据此判断结束。 |
No examples provided.
xhs_submit_video_speech_text_by_note_id ~125
根据小红书 note_id 提交视频笔记口播转文字任务；提交完成后最多短等 240 秒，未完成时返回 job_id 和下一步查询动作。
| Name | Type | Req | Description |
|---|---|---|---|
| note_id | string | yes | note_id 是 24 位小写十六进制稳定笔记 ID。必须原样复制搜索、详情、评论或用户发帖列表返回的完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。 |
| Name | Type | Req | Description |
|---|---|---|---|
| content_id | string | yes | 平台内容 ID。 |
| content_meta | object | yes | 作品上下文信息，便于结合转写内容做口播分析。 |
| content_type | string | yes | 内容类型。 |
| error | — | yes | 失败或过期时的稳定错误结构；非终态或成功时为 null。 |
| is_terminal | boolean | yes | 是否已终态。 |
| job_id | string | yes | 任务 ID。 |
| message | string | yes | 面向用户/AI 的状态说明。 |
| next_action | — | yes | 非终态时建议的下一步查询动作。 |
| next_poll_after_seconds | — | yes | 建议下次查询前等待的秒数；非终态时可用。 |
| platform | string | yes | 任务所属平台。 |
| source_id | string | yes | 任务来源 ID。 |
| status | string | yes | 任务状态。 |
| transcript | — | yes | 成功时的口播转文字结果；非终态或失败时为 null。 |
No examples provided.
xhs_submit_video_speech_text_by_note_url ~74
提交小红书视频笔记口播转文字任务；提交完成后最多短等 240 秒，未完成时返回 job_id 和下一步查询动作。
| Name | Type | Req | Description |
|---|---|---|---|
| note_url | string | yes | 小红书视频笔记链接、短链接或分享文案。 |
| Name | Type | Req | Description |
|---|---|---|---|
| content_id | string | yes | 平台内容 ID。 |
| content_meta | object | yes | 作品上下文信息，便于结合转写内容做口播分析。 |
| content_type | string | yes | 内容类型。 |
| error | — | yes | 失败或过期时的稳定错误结构；非终态或成功时为 null。 |
| is_terminal | boolean | yes | 是否已终态。 |
| job_id | string | yes | 任务 ID。 |
| message | string | yes | 面向用户/AI 的状态说明。 |
| next_action | — | yes | 非终态时建议的下一步查询动作。 |
| next_poll_after_seconds | — | yes | 建议下次查询前等待的秒数；非终态时可用。 |
| platform | string | yes | 任务所属平台。 |
| source_id | string | yes | 任务来源 ID。 |
| status | string | yes | 任务状态。 |
| transcript | — | yes | 成功时的口播转文字结果；非终态或失败时为 null。 |
No examples provided.