xhs_search_notes
Read-only
搜索小红书 / Xiaohongshu / XHS / RedNote 相关笔记。用户需要按搜索词查找笔记时使用；已有笔记链接或 note_id 且需要单篇笔记详情时使用对应的详情工具；需要评论、回复或口播转文字时使用相应的 URL/ID 工具；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容。 返回的 note_url 在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | Yes | 搜索词，可传关键词或短语，例如品牌名、话题、人物名、产品名或内容需求；不要传笔记链接、主页链接、note_id、user_id 或 page_token。 | |
| note_type | No | 笔记类型筛选，可选：all（不限，默认）、image（图文）、video（视频） | all |
| sort_type | No | 笔记搜索结果排序方式，可选：general（综合，默认）、time_descending（最新发布优先）、like_count_descending（最多点赞优先）、comment_count_descending（最多评论优先）、collect_count_descending（最多收藏优先） | general |
| page_token | No | 笔记搜索分页令牌。首次请求留空；继续翻页时传入上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 只能用于同一关键词、排序、笔记类型、发布时间范围和调用方的笔记搜索链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。 | |
| publish_time_range | No | 发布时间范围筛选，可选：all（不限，默认）、day（一天内）、week（一周内）、half_year（半年内） | all |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | 笔记搜索结果中的笔记列表，已过滤非笔记卡片与不可公开笔记；当前页过滤后可能为空数组 | |
| points | Yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 | |
| next_page_token | Yes | 下一页不透明分页令牌；为空表示没有更多结果或无法继续 token 翻页。继续笔记搜索时必须将完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一关键词、排序、笔记类型、发布时间范围和调用方的笔记搜索链路。items 为空时不要单独据此判断结束。 |