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.

6installs
Added on

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

ScenarioHandling
Not logged inGuide users to log in using xhs-login
No search resultsSuggest adjusting keywords or filter conditions