Back to Details

xhs-search

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

执行流程

Execution Flow

1. 确认搜索条件

1. Confirm Search Criteria

从用户输入中提取：
  • keyword
    （必填）— 搜索关键词
  • filters
    （可选）— 筛选条件
Extract from user input:
  • keyword
    (required) — Search keyword
  • filters
    (optional) — Filter conditions

2. 调用搜索

2. Call the Search

调用 
search_feeds
：
  • keyword
    （string，必填）
  • filters
    （object，可选）： 
    • sort_by
      ：综合 | 最新 | 最多点赞 | 最多评论 | 最多收藏
    • note_type
      ：不限 | 视频 | 图文
    • publish_time
      ：不限 | 一天内 | 一周内 | 半年内
    • search_scope
      ：不限 | 已看过 | 未看过 | 已关注
    • location
      ：不限 | 同城 | 附近
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. 展示结果

3. Display Results

将搜索结果整理为列表展示，每条包含：
  • 标题、作者
  • 点赞数、评论数、收藏数
  • feed_id
    和 
    xsec_token
    （后续操作需要）
提示用户可以：
  • 查看某条笔记详情（使用 xhs-explore）
  • 对笔记进行互动（使用 xhs-interact）
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

场景处理
未登录引导使用 xhs-login 登录
无搜索结果建议调整关键词或筛选条件
ScenarioHandling
Not logged inGuide users to log in using xhs-login
No search resultsSuggest adjusting keywords or filter conditions