git:20260812.88d45e6 to git:20260812.75039ff

---

name: kuaishou-search

description: 快手作品搜索工具。输入关键词就能搜到快手热门作品（广域库），支持按排序方式多维度筛选，作品标题、作者、播放数、点赞数、评论数、收藏数一览无余，点一下链接就能跳转看详情，还可提取视频详情和文案。当用户需要搜索快手作品、查找快手热门内容、查询快手作品数据时使用。触发词：快手搜索、快手作品、快手热门、快手视频查询、搜快手。

---

# 快手作品搜索

## 📝 简介

输入关键词就能搜到快手热门作品（广域库），支持按排序方式多维度筛选，作品标题、作者、播放数、点赞数、评论数、收藏数一览无余，点一下链接就能跳转看详情，还可关联提取视频详情和文案。

## ✨ 功能特性

| 功能模块 | 能力描述 | 核心价值 |

|---------|---------|----------|

| 关键词搜索 | 输入关键词搜索快手热门作品（广域库） | 精准发现目标赛道的内容 |

| 多维排序 | 综合/最新/最多点赞/最多收藏 | 按不同维度发现优质内容 |

| 视频详情提取 | work_id 可用于 kuaishou-video-extract 技能获取视频详情和提取视频文案 | 搜索→详情→文案提取全链路 |

## 🎯 适用对象

- 🔍 **内容创作者** — 找同赛道热门作品，研究对标内容的选题方向和爆款规律。

- 📊 **运营 / 数据分析** — 快速摸清某个品类在快手上有什么热门内容，掌握流量趋势。

- 🏢 **品牌 / MCN** — 筛选潜在合作达人，按互动量评估作品价值，辅助投放决策。

- 🛒 **电商选品** — 搜索细分赛道的带货作品，找到匹配的推广内容方向。

## 🔑 鉴权

### 获取 API Key

请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取 API KEY

### 配置 API Key

方案1: 以 Qoder 为例，将 REDFOX_API_KEY 添加到 `~/.openclaw/openclaw.json` 中：

```bash

{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }

```

方案2: 终端配置

```bash

export REDFOX_API_KEY="ak_xxxx..."

```

## 🔄 工作流程

### Step 1：理解用户意图，提取关键词和筛选参数

**1. 提取关键词**

- 从用户描述中提取 2~6 字的搜索关键词

- 若用户意图模糊（如“帮我搜快手”），主动询问：「请问你想搜索哪个方向或领域的内容？」

- 不得在用户未提供关键词时擅自猜测并调用脚本

**2. 识别筛选参数**（用户未指定时使用默认值）

- **排序方式**（`--sort`）：默认 `最多点赞`

- 用户提到“综合” → `综合`

- 用户提到“最新”、“最近” → `最新`

- 用户提到“点赞”、“热门”、“爆款” → `最多点赞`

- 用户提到“收藏” → `最多收藏`

- 未提及排序 → `最多点赞`（默认）

- **页码**（`--page`）：默认 `1`

- 用户提到“下一页”、“第2页” → 对应页码

- 未提及页码 → `1`（默认）

### Step 2：调用搜索脚本

```bash

python3 ~/.agents/skills/kuaishou-search/scripts/search_ks_work.py "<关键词>" [--sort 排序] [--page 页码]

```

**参数说明：**

| 参数 | 可选值 | 含义 |

|------|--------|------|

| keyword | 任意字符串 | 搜索关键词 |

| `--sort` | `综合` / `最新` / `最多点赞` / `最多收藏` | 排序方式（默认：最多点赞） |

| `--page` | 正整数 | 页码，从 1 开始（默认：1） |

脚本以 JSON 格式输出：

| 字段 | 说明 |

|------|------|

| `articles` | 关键词匹配作品列表（按请求排序参数排列） |

| `sort_label` | 本次排序方式文字说明 |

| `page` | 当前页码 |

| `has_next` | 是否有下一页（true/false） |

| `total` | 当前页返回条数 |

每条作品字段：

| 字段 | 说明 |

|------|------|

| `title` | 作品标题 |

| `author` | 作者名称 |

| `author_url` | 作者主页链接（保留字段，当前为空） |

| `author_fans` | 作者粉丝数 |

| `play_count` | 播放数 |

| `like_count` | 点赞数 |

| `comment_count` | 评论数 |

| `collect_count` | 收藏数 |

| `share_count` | 分享数 |

| `forward_count` | 转发数 |

| `work_url` | 作品链接（由 photoId 构建） |

| `cover_url` | 封面图 URL |

| `video_url` | 视频 URL |

| `head_url` | 作者头像 URL |

| `duration` | 视频时长（mm:ss 格式） |

| `duration_ms` | 视频时长（毫秒） |

| `work_type` | 作品类型 |

| `publish_time` | 发布时间（YYYY-MM-DD HH:MM:SS） |

| `publish_date` | 发布日期（YYYY-MM-DD） |

| `work_id` | 作品ID（photoId，可用于 kuaishou-video-extract 技能获取视频详情和提取视频文案） |

### Step 3：判断结果并展示

#### 情况 A：articles 数量 > 0（有匹配结果）

**A1. 告知用户查询范围**

> 📊 关键词「**XXX**」查询到 **N 条**作品（排序：{sort_label} | 第 {page} 页），以下是详细数据：

**A2. 渲染 Markdown 表格（⚠️ 必须逐条输出，条数必须与 A1 中 N 一致，一条不漏）**

```markdown

| # | 作品标题 | 作者 | 播放数 | 点赞数 | 评论数 | 收藏数 | 发布时间 |

|---|---------|------|--------|--------|--------|--------|---------|

| 1 | [标题文字](作品链接) | 作者名 | 32.5w | 1.2w | 305 | 8.7w | 2026-06-30 18:00:00 |

```

**数字格式化规则：**

- `< 10000`：原始数字（如 `320`）

- `≥ 10000`：`x.xw` 格式（如 `1.2w`）

**标题规则：** `[标题](work_url)`；标题完整展示，严禁截断；标题为空时显示 `-`；标题中的 `|` 字符已由脚本自动转义为 `\|`，避免破坏表格列分隔

**作者规则：** 纯文本展示作者名，不做超链接跳转

**A3. 筛选能力提示（紧接在表格之后，每次必须输出）**

> 🔧 **支持筛选，回复以下指令可切换条件重新搜索：**

> - **排序方式**：综合排序 / 最新发布 / 最多点赞 / 最多收藏（当前：{sort_label}）

>

> 示例：「按综合排序重新搜索」

**A3.1 关联能力提示（紧接在 A3 之后，每次必须输出）**

> 🎬 **视频详情提取**：每条作品的 `work_id` 可用于 **kuaishou-video-extract** 技能，获取视频详细信息并提取视频文案。如需查看某条作品的视频详情，回复作品序号即可。

**A4. 翻页提示（⚠️ 紧接在 A3.1 之后，不可省略，每次必须输出）**

- 若 `has_next` 为 true：

> 📄 当前第 **{page}** 页。回复「下一页」继续查看。

> 📄 当前第 **{page}** 页，已无更多数据。

#### 情况 B：articles 数量 = 0（无匹配结果）

**B1. 抱歉提示 + 调整建议**

> 😔 抱歉，未找到与「**XXX**」相关的快手作品。

> 💡 建议尝试：更换更短或更宽泛的关键词。

**B2. 筛选能力提示（紧接在 B1 之后，每次必须输出，格式同 A3）**

**B2.1 关联能力提示（格式同 A3.1）**