xhs-search

Original：🇨🇳 Chinese

Translated

Search Xiaohongshu notes, supporting keyword search and multi-dimensional filtering (sorting, content type, time range, location, etc.). Use this when users want to search or find content on Xiaohongshu — including scenarios like searching for notes, finding guides, checking if certain content exists on Xiaohongshu, searching, looking up, etc.

2installs

Sourceautoclaw-cc/xiaohongshu-mcp-skills

Added on2026-03-24

NPX Install

npx skill4agent add autoclaw-cc/xiaohongshu-mcp-skills xhs-search

SKILL.md Content (Chinese)

View Translation Comparison →

Execution Flow

1. Confirm Search Criteria

Extract from user input:

```
keyword
```
(required) — Search keyword
```
filters
```
(optional) — Filter conditions

2. Call the Search

Call

search_feeds

:

```
keyword
```
(string, required)
```
filters
```
(object, optional):
- ```
sort_by
```
  : Comprehensive | Latest | Most Likes | Most Comments | Most Collected
- ```
note_type
```
  : All | Video | Image-Text
- ```
publish_time
```
  : All | Within a day | Within a week | Within half a year
- ```
search_scope
```
  : All | Viewed | Unviewed | Followed
- ```
location
```
  : All | Same City | Nearby

3. Display Results

Organize search results into a list for display, each entry includes:

Title, Author
Like count, Comment count, Collection count
```
feed_id
```
and
```
xsec_token
```
(required for subsequent operations)

Tell users they can:

View details of a specific note (use xhs-explore)
Interact with notes (use xhs-interact)

Failure Handling

Scenario	Handling
Not logged in	Guide users to log in using xhs-login
No search results	Suggest adjusting keywords or filter conditions