kuaishou-searchlisted
Install: claude install-skill redfox-data/redfox-community
# 快手作品搜索
## 📝 简介
输入关键词就能搜到快手热门作品(广域库),支持按排序方式多维度筛选,作品标题、作者、播放数、点赞数、评论数、收藏数一览无余,点一下链接就能跳转看详情,还可关联提取视频详情和文案。
## ✨ 功能特性
| 功能模块 | 能力描述 | 核心价值 |
|---------|---------|----------|
| 关键词搜索 | 输入关键词搜索快手热门作品(广域库) | 精准发现目标赛道的内容 |
| 多维排序 | 综合/最新/最多点赞/最多收藏 | 按不同维度发现优质内容 |
| 分页浏览 | 每页展示50��结果,支持多页翻看 | 不遗漏任何一条内容 |
| 视频详情提取 | 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 | 任意字符串 | 搜索关键词