# xhs_search_notes

搜索小红书 / Xiaohongshu / XHS / RedNote 相关笔记。用户需要按搜索词查找笔记时使用；已有笔记链接或 note_id 且需要单篇笔记详情时使用对应的详情工具；需要评论、回复或口播转文字时使用相应的 URL/ID 工具；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容。 返回的 note_url 在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接。

Agent View of the PolicyLayer registry record for `xhs_search_notes`. HTML page: https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-search-notes

## Facts

- Tool: `xhs_search_notes`
- Server: SocialDataX 小红书 Xiaohongshu XHS RedNote MCP (`https://mcp.socialdatax.com/xhs/mcp`) — https://policylayer.com/tools/com-52choujiang-xhs-insights.md
- Homepage: https://github.com/https://mcp.socialdatax.com/xhs/mcp
- Risk category: Read (Low risk)
- Registry record: grade C, identity unverified
- Server auth posture: open
- Server rate-limited: no
- Parameters: 5 (1 required)
- Recommended policy verdict: Allowed

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `keyword` | string | yes | 搜索词，可传关键词或短语，例如品牌名、话题、人物名、产品名或内容需求；不要传笔记链接、主页链接、note_id、user_id 或 page_token。 |
| `note_type` | string | no | 笔记类型筛选，可选：all（不限，默认）、image（图文）、video（视频） |
| `sort_type` | string | no | 笔记搜索结果排序方式，可选：general（综合，默认）、time_descending（最新发布优先）、like_count_descending（最多点赞优先）、comment_count_descending（最多评论优先）、collect_count_descending（最多收藏优先） |
| `page_token` | string | no | 笔记搜索分页令牌。首次请求留空；继续翻页时传入上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 只能用于同一关键词、排序、笔记类型、发布时间范围和调用方的笔记搜索链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。 |
| `publish_time_range` | string | no | 发布时间范围筛选，可选：all（不限，默认）、day（一天内）、week（一周内）、half_year（半年内） |

Parameters from the server's own tool schema.

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "xhs_search_notes",
    "arguments": {
      "keyword": "<keyword>"
    }
  }
}
```

## Why xhs_search_notes is rated Low

Even though xhs_search_notes only reads data, uncontrolled read access leaks sensitive information and racks up API costs: an agent caught in a retry loop can make thousands of calls a minute without anyone noticing.

## Use case

AI agents call xhs_search_notes to retrieve information from SocialDataX 小红书 Xiaohongshu XHS RedNote MCP without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

## Recommended policy (PolicyLayer)

Verdict: **Allowed**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches SocialDataX 小红书 Xiaohongshu XHS RedNote MCP:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "xhs_search_notes": {}
  }
}
```

## Other tools on SocialDataX 小红书 Xiaohongshu XHS RedNote MCP (23)

- `socialdatax_get_points_balance` — Read — https://policylayer.com/tools/com-52choujiang-xhs-insights/socialdatax-get-points-balance.md
- `xhs_get_note_comments_by_note_id` — Read — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-get-note-comments-by-note-id.md
- `xhs_get_note_comments_by_note_url` — Read — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-get-note-comments-by-note-url.md
- `xhs_get_note_detail_by_note_id` — Read — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-get-note-detail-by-note-id.md
- `xhs_get_note_detail_by_note_url` — Read — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-get-note-detail-by-note-url.md
- `xhs_get_note_sub_comments_by_comment_id` — Read — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-get-note-sub-comments-by-comment-id.md
- `xhs_get_product_detail` — Read — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-get-product-detail.md
- `xhs_get_product_review_replies` — Read — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-get-product-review-replies.md
- `xhs_get_product_reviews` — Read — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-get-product-reviews.md
- `xhs_get_search_hot_list` — Read — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-get-search-hot-list.md
- `xhs_get_topic_notes_by_page_id` — Read — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-get-topic-notes-by-page-id.md
- `xhs_get_topic_notes_by_topic_url` — Read — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-get-topic-notes-by-topic-url.md
- `xhs_get_user_info_by_profile_url` — Read — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-get-user-info-by-profile-url.md
- `xhs_get_user_info_by_user_id` — Read — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-get-user-info-by-user-id.md
- `xhs_get_user_posted_notes_by_profile_url` — Read — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-get-user-posted-notes-by-profile-url.md
- `xhs_get_user_posted_notes_by_user_id` — Read — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-get-user-posted-notes-by-user-id.md
- `xhs_get_video_speech_text_job` — Read — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-get-video-speech-text-job.md
- `xhs_pgy_get_note_detail_by_note_id` — Read — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-pgy-get-note-detail-by-note-id.md
- `xhs_pgy_get_note_detail_by_note_url` — Read — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-pgy-get-note-detail-by-note-url.md
- `xhs_search_products` — Read — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-search-products.md
- `xhs_search_suggestions` — Read — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-search-suggestions.md
- `xhs_submit_video_speech_text_by_note_id` — Write — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-submit-video-speech-text-by-note-id.md
- `xhs_submit_video_speech_text_by_note_url` — Write — https://policylayer.com/tools/com-52choujiang-xhs-insights/xhs-submit-video-speech-text-by-note-url.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=com-52choujiang-xhs-insights · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/com-52choujiang-xhs-insights