SocialDataX 小红书 Xiaohongshu XHS RedNote MCP
REMOTE · MCP.SOCIALDATAX.COM · SCANNED SEP 21
XHS hot search/suggestions、note/product search/details、PGY、comments/replies、users/posts、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 → Why this is hard to 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 enforcement could not be verified: the plaintext port answered with HTTP 404, which proves neither a plaintext path nor enforcement. 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 Usability80
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 5304 tokens (~182/item across 29 items; 27 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 Management96
- Stability check failed: schema churn in the 30 days we've observed: 1 tool removals, 0 breaking changes, 0 auth/transport breaks, 4 additions. See how to fix → Fail
Tool Coverage98
- 96% 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
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 27 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 29 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the SocialDataX 小红书 Xiaohongshu XHS RedNote MCP server?
SocialDataX 小红书 Xiaohongshu XHS RedNote MCP is a hosted endpoint at https://mcp.socialdatax.com/xhs/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · mcp.socialdatax.com
claude mcp add --transport http com-52choujiang-xhs-insights 'https://mcp.socialdatax.com/xhs/mcp'
{
"mcpServers": {
"com-52choujiang-xhs-insights": {
"url": "https://mcp.socialdatax.com/xhs/mcp"
}
}
} {
"servers": {
"com-52choujiang-xhs-insights": {
"type": "http",
"url": "https://mcp.socialdatax.com/xhs/mcp"
}
}
} [mcp_servers.com-52choujiang-xhs-insights] url = "https://mcp.socialdatax.com/xhs/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"com-52choujiang-xhs-insights": {
"type": "remote",
"url": "https://mcp.socialdatax.com/xhs/mcp",
"enabled": true
}
}
} openclaw mcp add com-52choujiang-xhs-insights --url 'https://mcp.socialdatax.com/xhs/mcp' --transport streamable-http
mcp_servers:
com-52choujiang-xhs-insights:
url: "https://mcp.socialdatax.com/xhs/mcp" {
"McpServers": {
"com-52choujiang-xhs-insights": {
"Transport": "http",
"Url": "https://mcp.socialdatax.com/xhs/mcp"
}
}
} assistant mcp add com-52choujiang-xhs-insights -t streamable-http -u 'https://mcp.socialdatax.com/xhs/mcp'
{
"mcpServers": {
"com-52choujiang-xhs-insights": {
"type": "http",
"url": "https://mcp.socialdatax.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.
- 21 Sept 26 0
- Server version: 0.1.12 → 0.1.13 functional
- New tool “xhs_get_product_review_reply_replies” functional
- 18 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 90 to 92.
- 16 Sept 26 0
- The server rewrote its instructions, which are the text every model session reads security
- Tool “socialdatax_get_points_balance” rewrote its description, which is the text the model reads security
- New tool “xhs_search_users” functional
- 12 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 84 to 87.
- 10 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 77 to 80.
- 9 Sept 26 −1
- Tool “xhs_get_product_detail” was removed ▼ security
- Tool “xhs_search_products” rewrote its description, which is the text the model reads security
- Server version: 0.1.11 → 0.1.12 functional
- New tool “xhs_get_product_detail_by_sku_id” functional
- New tool “xhs_get_product_detail_by_url” functional
- 8 Sept 26 +1
- Tool “xhs_pgy_get_note_detail_by_note_id” rewrote its description, which is the text the model reads security
- Tool “xhs_pgy_get_note_detail_by_note_url” rewrote its description, which is the text the model reads security
- 6 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 69 to 72.
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 21 Sept 2026 · Probed https://mcp.socialdatax.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.socialdatax.com | CN=TrustAsia DV TLS RSA CA 2024,O=TrustAsia Technologies\, Inc.,C=CN | 30 Jun 2026 | 28 Sept 2026 | RSA 2048 | SHA256-RSA | 8e8caa5cf3d2f797fec12571ba1ea84b323016 |
| SANs: mcp.socialdatax.com | ||||||
| CN=TrustAsia DV TLS RSA CA 2024,O=TrustAsia Technologies\, Inc.,C=CN (CA) | CN=TrustAsia TLS RSA Root CA,O=TrustAsia Technologies\, Inc.,C=CN | 15 May 2024 | 15 May 2034 | RSA 4096 | SHA384-RSA | 1c9e6b412deb0a85461de03dbe30984d0573888b |
| CN=TrustAsia TLS RSA Root CA,O=TrustAsia Technologies\, Inc.,C=CN (CA) | CN=Certum Trusted Network CA,OU=Certum Certification Authority,O=Unizeto Technologies S.A.,C=PL | 7 Oct 2025 | 14 Jan 2029 | RSA 4096 | SHA384-RSA | b2dc4c34932d709cd4bf0b099401695c |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of mcp.socialdatax.com. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| com. | present | 19718 | 13 | Verified |
| socialdatax.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 |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://mcp.socialdatax.com/xhs/mcp | Verified | 200 | |
| http (plaintext) | http://mcp.socialdatax.com/xhs/mcp | Inconclusive | 404 |
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. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
socialdatax_get_points_balance ~53
查询当前 API Key 账户的 SocialDataX 积分余额、剩余积分或点数 / remaining points balance。需要充值时请访问 https://socialdatax.com/dashboard/billing。
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
xhs_get_note_comments_by_note_id ~267
根据 note_id 获取单篇小红书笔记的一级评论，支持 sort_type 评论排序和 page_token 翻页。
| Name | Type | Req | Description |
|---|---|---|---|
| note_id | string | yes | note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。 |
| page_token | – | – | 分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一笔记和 sort_type 的一级评论列表，不能跨笔记或 sort_type 复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| 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 只能用于同一笔记和 sort_type 的一级评论列表，不能跨笔记或 sort_type 复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| points | object | yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 |
| top_level_comment_count | – | yes | 整篇笔记的一级评论总数，不含回复；不是当前页 items 数量；无法获取时为 null |
No examples provided.
xhs_get_note_comments_by_note_url ~272
根据笔记链接、短链接或分享文案获取单篇小红书笔记的一级评论，支持 sort_type 评论排序和 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 的一级评论列表，不能跨笔记或 sort_type 复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| 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 只能用于同一笔记和 sort_type 的一级评论列表，不能跨笔记或 sort_type 复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| points | object | yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 |
| top_level_comment_count | – | yes | 整篇笔记的一级评论总数，不含回复；不是当前页 items 数量；无法获取时为 null |
No examples provided.
xhs_get_note_detail_by_note_id ~173
根据 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 是小红书笔记 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 是小红书笔记 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 合成公开链接。 |
| points | object | yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 |
| 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 是小红书笔记 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 合成公开链接。 |
| points | object | yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 |
| 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 ~312
根据 note_id 和一级评论 comment_id 获取二级评论；用户已提供完整合法的 ID 组合时直接使用；已有 note_id 或笔记链接但缺少必需 ID 时，调用对应一级评论工具补全；缺少笔记定位信息时向用户索取；支持 page_token 翻页。
| Name | Type | Req | Description |
|---|---|---|---|
| comment_id | string | yes | 一级评论 ID；用户已提供时直接使用，否则可从一级评论结果 items[].comment_id 复制；不要传二级评论项自身的 comment_id。 |
| note_id | string | yes | note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。 |
| page_token | – | – | 分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一 note_id 和 comment_id 的二级评论列表，不能跨笔记或一级评论复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 当前页二级评论列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一 note_id 和 comment_id 的二级评论列表，不能跨笔记或一级评论复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| points | object | yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 |
No examples provided.
xhs_get_product_detail_by_sku_id ~123
根据小红书商品 sku_id 获取商品详情；已有该 ID 时直接使用，否则可从 xhs_search_products 获取。只有商品链接、短链接或分享文案时使用 xhs_get_product_detail_by_url；本工具不支持商品链接、spu_id 或搜索词。
| Name | Type | Req | Description |
|---|---|---|---|
| sku_id | string | yes | 小红书商品 SKU ID。用户已提供时原样使用；否则从 xhs_search_products 的 items[*].sku_id 原样复制。不支持 spu_id、商品链接或搜索关键词。 |
| Name | Type | Req | Description |
|---|---|---|---|
| assurances | array | yes | 商品保障服务列表 |
| coupon_price | number | yes | 当前 SKU 展示的券后/成交价格，单位：元；不保证是最终实付价 |
| detail_images | array | yes | 商品详情图列表 |
| main_images | array | yes | 商品顶部主图/轮播图列表 |
| points | object | yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 |
| price | number | yes | 当前 SKU 的商品原价，单位：元；不是商品搜索的展示销售价，也不是最终实付价 |
| sales_text | string | yes | 平台展示的商品销量文本；没有时为空字符串。带“+”的数量表示下限，不是精确销量；结合 sold_count 解读。 |
| selected_variant | string | yes | 当前选中规格；没有规格时为空字符串 |
| shipping | object | yes | 发货信息 |
| shop_avatar_url | string | yes | 店铺头像链接 |
| shop_fans_text | string | yes | 店铺粉丝数展示值；没有粉丝信息时为空字符串 |
| shop_id | string | yes | 店铺 ID |
| shop_name | string | yes | 店铺名称 |
| shop_score | string | yes | 店铺评分展示值；没有评分时为空字符串 |
| shop_sold_text | string | yes | 店铺已售展示值；没有已售信息时为空字符串 |
| sku_id | string | yes | 商品 SKU ID |
| sold_count | – | yes | 已售数量；平台以带“+”的千级或万级文本展示时转换为对应整数下限（如“90.2k+ sold”返回 90200、“已售1.2万+”返回 12000），不是精确销量，须结合 sales_text 解读；缺失或无法解析时为 null，不代表零销量；0 表示明确已售 0。 |
| specifications | array | yes | 商品属性/规格参数列表（name/value），不是可选 SKU 规格组 |
| stock_status | integer | yes | 库存状态码；具体码值含义未公开定义，不要自行解释为是否在售或是否可购买 |
| title | string | yes | 商品标题 |
No examples provided.
xhs_get_product_detail_by_url ~104
根据小红书商品链接、短链接或分享文案获取商品详情，无需先搜索。已有完整 sku_id 时使用 xhs_get_product_detail_by_sku_id；返回的 sku_id 可继续用于商品评价工具。
| Name | Type | Req | Description |
|---|---|---|---|
| url | string | yes | 小红书商品详情链接、短链接或包含商品链接的完整分享文案。不支持笔记链接、博主主页链接、纯分享口令或搜索词。 |
| Name | Type | Req | Description |
|---|---|---|---|
| assurances | array | yes | 商品保障服务列表 |
| coupon_price | number | yes | 当前 SKU 展示的券后/成交价格，单位：元；不保证是最终实付价 |
| detail_images | array | yes | 商品详情图列表 |
| main_images | array | yes | 商品顶部主图/轮播图列表 |
| points | object | yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 |
| price | number | yes | 当前 SKU 的商品原价，单位：元；不是商品搜索的展示销售价，也不是最终实付价 |
| sales_text | string | yes | 平台展示的商品销量文本；没有时为空字符串。带“+”的数量表示下限，不是精确销量；结合 sold_count 解读。 |
| selected_variant | string | yes | 当前选中规格；没有规格时为空字符串 |
| shipping | object | yes | 发货信息 |
| shop_avatar_url | string | yes | 店铺头像链接 |
| shop_fans_text | string | yes | 店铺粉丝数展示值；没有粉丝信息时为空字符串 |
| shop_id | string | yes | 店铺 ID |
| shop_name | string | yes | 店铺名称 |
| shop_score | string | yes | 店铺评分展示值；没有评分时为空字符串 |
| shop_sold_text | string | yes | 店铺已售展示值；没有已售信息时为空字符串 |
| sku_id | string | yes | 商品 SKU ID |
| sold_count | – | yes | 已售数量；平台以带“+”的千级或万级文本展示时转换为对应整数下限（如“90.2k+ sold”返回 90200、“已售1.2万+”返回 12000），不是精确销量，须结合 sales_text 解读；缺失或无法解析时为 null，不代表零销量；0 表示明确已售 0。 |
| specifications | array | yes | 商品属性/规格参数列表（name/value），不是可选 SKU 规格组 |
| stock_status | integer | yes | 库存状态码；具体码值含义未公开定义，不要自行解释为是否在售或是否可购买 |
| title | string | yes | 商品标题 |
No examples provided.
xhs_get_product_review_replies ~193
根据一级商品评价 review_id 获取其下回复；已有该 ID 时直接使用，否则可从 xhs_get_product_reviews 获取；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容；不接受 root_review_id。
| Name | Type | Req | Description |
|---|---|---|---|
| page_token | string | – | 商品评价回复分页令牌。首次请求留空；续页时将上一页返回的完整 next_page_token 原样传回。令牌只绑定同一一级评价和调用方，不能跨链路复用。 |
| review_id | string | yes | 一级商品评价 ID。用户已提供时原样使用；否则从 xhs_get_product_reviews 的 items[*].review_id 原样复制。不要传 root_review_id。 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 当前页商品评价回复列表 |
| next_page_token | string | yes | 下一页不透明商品评价回复分页令牌；为空表示没有更多结果或当前无法继续翻页。继续翻页时必须原样传回，只能用于同一一级评价和调用方。 |
| points | object | yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 |
No examples provided.
xhs_get_product_review_reply_replies ~206
根据商品评价回复 review_id 获取其下的嵌套回复；已有该 ID 时直接使用，否则可从 xhs_get_product_review_replies 获取；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容；不接受 root_review_id。
| Name | Type | Req | Description |
|---|---|---|---|
| page_token | string | – | 商品评价回复的回复分页令牌。首次请求留空；续页时将上一页返回的完整 next_page_token 原样传回。令牌只绑定同一父级回复和调用方，不能跨链路复用。 |
| review_id | string | yes | 商品评价回复 ID。用户已提供时原样使用；否则从 xhs_get_product_review_replies 的 items[*].review_id 原样复制。不要传 root_review_id。 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 当前页商品评价回复的回复列表 |
| next_page_token | string | yes | 下一页不透明商品评价回复的回复分页令牌；为空表示没有更多结果或当前无法继续翻页。继续翻页时必须原样传回，只能用于同一父级回复和调用方。 |
| points | object | yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 |
No examples provided.
xhs_get_product_reviews ~300
根据小红书商品 sku_id 获取商品评价；已有该 ID 时直接使用，否则可从 xhs_search_products 获取；支持 sort_type、has_image 和 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容；不支持商品链接、spu_id 或搜索词。
| Name | Type | Req | Description |
|---|---|---|---|
| has_image | boolean | – | 是否只返回带图片的商品评价 |
| page_token | string | – | 商品评价分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 只能用于同一商品 SKU、排序、图片筛选和调用方的商品评价链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| sku_id | string | yes | 小红书商品 SKU ID。用户已提供时原样使用；否则从 xhs_search_products 的 items[*].sku_id 原样复制。不支持 spu_id、商品链接或搜索关键词。 |
| sort_type | string | – | 商品评价排序方式，可选：general（综合，默认）、time_descending（最新评价优先） |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 当前页商品评价列表 |
| next_page_token | string | yes | 下一页不透明商品评价分页令牌；items 为空时仍应继续翻页；为空表示没有更多结果或当前无法继续翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一商品 SKU、排序、图片筛选和调用方的商品评价链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| points | object | yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 |
No examples provided.
xhs_get_search_hot_list ~20
获取小红书搜索热榜。
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 搜索热榜条目列表 |
| points | object | yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 |
No examples provided.
xhs_get_topic_notes_by_page_id ~185
根据 page_id 获取标签页笔记列表，支持 sort_type 排序和 page_token 翻页。
| Name | Type | Req | Description |
|---|---|---|---|
| page_id | string | yes | 小红书标签页 page_id。 |
| page_token | string | – | 分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只绑定当前标签页和排序链路，不能跨 page_id 或排序复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| sort_type | string | – | 标签页笔记排序方式，可选：hot（最热，默认）、time_descending（最新） |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 标签页笔记列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；非空表示可尝试请求下一页，为空表示当前没有可继续的下一页令牌。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前标签页和排序链路，不能跨 page_id 或排序复用；items 为空时不要单独据此判断结束；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换… |
| points | object | yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 |
| total_note_count | integer | yes | 标签页笔记总数 |
| total_user_count | integer | yes | 标签页涉及用户总数 |
No examples provided.
xhs_get_topic_notes_by_topic_url ~264
根据话题页链接、短链接或分享文案获取标签页笔记列表，支持 sort_type 排序和 page_token 翻页。
| Name | Type | Req | Description |
|---|---|---|---|
| page_token | string | – | 分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只绑定当前标签页和排序链路，不能跨 page_id 或排序复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| sort_type | string | – | 标签页笔记排序方式，可选：hot（最热，默认）、time_descending（最新） |
| topic_url | string | yes | 小红书话题页链接、短链接或分享文案。支持以下形式：1) xiaohongshu.com/topic/normal/... 话题页长链；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 只绑定当前标签页和排序链路，不能跨 page_id 或排序复用；items 为空时不要单独据此判断结束；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换… |
| points | object | yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 |
| total_note_count | integer | yes | 标签页笔记总数 |
| total_user_count | integer | 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 | 用户名称 |
| points | object | 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 ~113
根据 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 | 用户名称 |
| points | object | 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 ~233
根据主页链接、短链接或分享文案获取用户已发布笔记列表，支持 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 只能用于同一用户的发帖列表，不能跨用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| points | object | yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 |
No examples provided.
xhs_get_user_posted_notes_by_user_id ~222
根据 user_id 获取用户已发布笔记列表，支持 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 只能用于同一用户的发帖列表，不能跨用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| points | object | yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 |
No examples provided.
xhs_get_video_speech_text_job ~95
根据用户提供的有效 job_id，或提交工具返回的 job_id 查询任务状态；用于继续未完成任务，每次最多等待 240 秒，不触发重处理，也不要重复提交任务。
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | 口播转文字任务 ID；用户已提供时直接使用，否则使用提交工具返回的 job_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_pgy_get_note_detail_by_note_id ~301
根据 note_id 获取小红书蒲公英单篇笔记商业增强详情，包括正文、图片或视频摘要、作者、曝光量、阅读量、互动量和图文/视频报价。 仅适用于已入驻蒲公英博主的笔记；用户明确要求蒲公英商业数据时使用，普通笔记详情使用普通详情工具。 用户只提曝光量、阅读量或报价且上下文未明确蒲公英口径时，先澄清商业口径和成功 20 积分的费用；上下文已明确时不重复确认。 这是蒲公英商业口径数据，不等同普通公开笔记详情；成功调用扣减 20 积分，失败不扣费。 查询明确无商业数据时按博主未入驻蒲公英处理，返回 pgy_commercial_data_unavailable，不换 ID/链接入口重试；超时、鉴权和余额不足等错误不表示未入驻。
| Name | Type | Req | Description |
|---|---|---|---|
| note_id | string | yes | note_id 是小红书笔记 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 | 统一封面图 |
| exposure_count | integer | yes | 笔记曝光量 |
| image_items | array | yes | 图片结构化明细；每项都表示一张图片 |
| like_count | integer | yes | 点赞数 |
| note_id | string | yes | note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。 |
| note_type | string | yes | 笔记类型；当前公开值固定为 image 或 video |
| note_url | string | yes | note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。 |
| picture_price | number | yes | 图文笔记报价 |
| points | object | yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 |
| publish_time | integer | yes | 发布时间，秒级 Unix 时间戳 |
| read_count | integer | yes | 笔记阅读量 |
| share_count | integer | yes | 分享数 |
| title | string | yes | 蒲公英笔记标题 |
| update_time | integer | yes | 更新时间，秒级 Unix 时间戳 |
| video | – | yes | 视频摘要信息；视频笔记返回对象，图文笔记为 null |
| video_price | number | yes | 视频笔记报价 |
No examples provided.
xhs_pgy_get_note_detail_by_note_url ~270
根据笔记链接、短链接或分享文案获取小红书蒲公英单篇笔记商业增强详情。 仅适用于已入驻蒲公英博主的笔记；用户明确要求蒲公英商业数据时使用，普通笔记详情使用普通详情工具。 用户只提曝光量、阅读量或报价且上下文未明确蒲公英口径时，先澄清商业口径和成功 20 积分的费用；上下文已明确时不重复确认。 这是蒲公英商业口径数据，不等同普通公开笔记详情；成功调用扣减 20 积分，失败不扣费。 查询明确无商业数据时按博主未入驻蒲公英处理，返回 pgy_commercial_data_unavailable，不换 ID/链接入口重试；超时、鉴权和余额不足等错误不表示未入驻。
| Name | Type | Req | Description |
|---|---|---|---|
| note_url | string | yes | 小红书笔记链接、短链接或分享文案。支持小红书笔记长链接、xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接，以及包含上述链接的完整分享文案。 |
| Name | Type | Req | Description |
|---|---|---|---|
| author | object | yes | 作者信息；详情页不返回小红书号 |
| collect_count | integer | yes | 收藏数 |
| comment_count | integer | yes | 评论数 |
| content | string | yes | 笔记正文 |
| cover_image_url | string | yes | 统一封面图 |
| exposure_count | integer | yes | 笔记曝光量 |
| image_items | array | yes | 图片结构化明细；每项都表示一张图片 |
| like_count | integer | yes | 点赞数 |
| note_id | string | yes | note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。 |
| note_type | string | yes | 笔记类型；当前公开值固定为 image 或 video |
| note_url | string | yes | note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。 |
| picture_price | number | yes | 图文笔记报价 |
| points | object | yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 |
| publish_time | integer | yes | 发布时间，秒级 Unix 时间戳 |
| read_count | integer | yes | 笔记阅读量 |
| share_count | integer | yes | 分享数 |
| title | string | yes | 蒲公英笔记标题 |
| update_time | integer | yes | 更新时间，秒级 Unix 时间戳 |
| video | – | yes | 视频摘要信息；视频笔记返回对象，图文笔记为 null |
| video_price | number | yes | 视频笔记报价 |
No examples provided.
xhs_search_notes ~464
搜索小红书 / Xiaohongshu / XHS / RedNote 相关笔记。用户需要按搜索词查找笔记时使用；已有笔记链接或 note_id 且需要单篇笔记详情时使用对应的详情工具；需要评论、回复或口播转文字时使用相应的 URL/ID 工具；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容。 返回的 note_url 在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接。
| Name | Type | Req | Description |
|---|---|---|---|
| keyword | string | yes | 搜索词，可传关键词或短语，例如品牌名、话题、人物名、产品名或内容需求；不要传笔记链接、主页链接、note_id、user_id 或 page_token。 |
| 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 为空时不要单独据此判断结束。 |
| points | object | yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 |
No examples provided.
xhs_search_products ~248
搜索小红书商品。用户需要按搜索词查找商品时使用；已有完整 sku_id（包括用户直接提供）时使用商品详情或商品评价工具，已有商品链接或分享文案时使用 xhs_get_product_detail_by_url；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容。
| Name | Type | Req | Description |
|---|---|---|---|
| keyword | string | yes | 搜索词，可传商品名、品牌名、品类或商品需求；不要传商品链接、sku_id、spu_id 或 page_token。 |
| page_token | string | – | 商品搜索分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 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 只能用于同一商品关键词和调用方的商品搜索链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| points | object | yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 |
No examples provided.
xhs_search_suggestions ~88
根据搜索词获取小红书候选搜索建议，用于补全搜索词；需要实际搜索笔记或商品时，分别使用 xhs_search_notes 或 xhs_search_products。
| Name | Type | Req | Description |
|---|---|---|---|
| keyword | string | yes | 搜索词，可传正在输入的关键词或短语；不要传笔记链接、主页链接、note_id、user_id 或分页令牌。 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 搜索建议条目列表 |
| points | object | yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 |
No examples provided.
xhs_search_users ~119
按搜索词搜索小红书用户、账号或博主，支持分页；已有用户 ID 或主页链接时，使用用户资料工具。
| Name | Type | Req | Description |
|---|---|---|---|
| keyword | string | yes | 搜索词，可传昵称、账号名或小红书号；不要传主页链接、user_id 或分页令牌。 |
| page_token | string | – | 用户搜索分页令牌，首次请求留空；续页保持 keyword 不变，将上一页完整 next_page_token 原样传回，不得截断、修改或自行生成。 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 搜索到的用户列表 |
| next_page_token | string | yes | 下一页分页令牌，为空表示结束；续页保持 keyword 不变并完整原样传回。 |
| points | object | yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 |
No examples provided.
xhs_submit_video_speech_text_by_note_id ~131
根据小红书 note_id 提交视频笔记口播转文字任务；提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。
| Name | Type | Req | Description |
|---|---|---|---|
| note_id | string | yes | note_id 是小红书笔记 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 ~80
根据小红书视频笔记链接、短链接或分享文案提交口播转文字任务；提交后最多等待 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.
What is the SocialDataX 小红书 Xiaohongshu XHS RedNote MCP server?
SocialDataX 小红书 Xiaohongshu XHS RedNote MCP is listed in the public MCP registry as com.52choujiang/xhs-insights. XHS hot search/suggestions、note/product search/details、PGY、comments/replies、users/posts、transcript. This page covers its hosted endpoint (https://mcp.socialdatax.com/xhs/mcp).
Is the SocialDataX 小红书 Xiaohongshu XHS RedNote MCP server safe to use?
SocialDataX 小红书 Xiaohongshu XHS RedNote MCP scores 84 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the SocialDataX 小红书 Xiaohongshu XHS RedNote MCP server expose?
SocialDataX 小红书 Xiaohongshu XHS RedNote MCP exposes 27 tools: xhs_get_note_detail_by_note_url, xhs_get_note_detail_by_note_id, xhs_search_notes, xhs_search_users, xhs_search_products, and 22 more. Their descriptions and schemas cost roughly 5,135 tokens of context every time the server is loaded.
Does the SocialDataX 小红书 Xiaohongshu XHS RedNote MCP server require authentication?
Yes. SocialDataX 小红书 Xiaohongshu XHS RedNote MCP asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.
Is the SocialDataX 小红书 Xiaohongshu XHS RedNote MCP server still maintained?
SocialDataX 小红书 Xiaohongshu XHS RedNote MCP is still listed as active in the MCP registry. We last reached this channel on 21 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.