---
name: tiktok-hot-search
description: TikTok热门搜索，一次输入关键词同时获取热门视频、相关用户与相关话题三类数据。基于红狐数据，视频支持排序与发布时间、地区筛选，用户支持粉丝数与认证筛选，话题附浏览量、使用次数与直达链接，输出榜单表格、爆款视频拆解、达人推荐与话题趋势解读，支持翻页与 HTML 报告导出。适用于 TikTok 出海选题调研、竞品扫描、达人发现时使用。触发词：TikTok热门搜索、TikTok视频搜索、TikTok用户搜索、TikTok话题搜索、TikTok关键词搜索、TikTok搜索、TikTok搜视频、TikTok搜用户、TikTok找达人。
version: 1.1.1
---

# TikTok热门搜索

> 一次输入关键词，视频、用户、话题三类结果一屏看清。

---

## 触发场景

当用户提出以下需求时使用本 Skill：

- "搜一下 TikTok 上 xxx 相关的视频"
- "TikTok 上做 xxx 的账号有哪些，帮我找找达人"
- "查一下 xxx 这个话题在 TikTok 上的数据"
- "帮我搜一下 xxx"（泛指搜索，三类数据都看）

用户只提到某一类（视频 / 用户 / 话题）时，只查询对应的那一类，不默认追加其他类型。三类的判断与查询规则详见 `references/core_workflow.md`。

---

## 数据说明

### 输出内容

- **视频列表**：序号、作者、作品 ID、播放、点赞、评论、分享、发布时间、作品链接、内容摘要
- **用户列表**：序号、昵称、TikTok号、粉丝数、获赞总数、作品数、主页链接
- **话题列表**：序号、话题、话题 ID、浏览量、使用次数、话题链接
- **爆款视频 TOP3 拆解**：结合内容与数据表现，推测爆款原因（附作品链接）
- **达人推荐 TOP3**：结合账号数据与关键词相关性，给出关注理由（附主页链接）
- **话题趋势解读**：归纳话题热度、使用趋势与商业化信号（附话题链接）
- **HTML 报告**：一次查询同步生成，支持导出 PDF / 高清图片
- **分页信息**：附带下一页继续查看提示，可按需翻页
- **固定提醒**：输出中附带 API Key 获取提醒

### 排序与口径

- 视频默认按播放数降序，可切换点赞、评论、分享或按原始相关度顺序输出
- 用户默认按粉丝数降序；话题默认按浏览量降序
- 所有数值均来自数据服务返回，如实展示；发布时间按北京时间展示日期
- 用户主页链接按 TikTok号 生成
- 爆款原因、关注理由与话题解读为基于公开数据的 AI 分析，输出时明确标注为推测

---

## 一键安装

### 前置条件

- Python 3.8+（仅使用标准库，无需安装额外依赖）
- 红狐数据 API Key（前往 [红狐 hub](https://redfox.hk/settings/api-keys?source=github) 注册获取）

### 安装步骤

1. 将技能文件夹放入你的 Skills 目录
2. 配置环境变量 `REDFOX_API_KEY`（配置细节详见 `references/core_workflow.md`）
3. 无需安装额外依赖，直接使用

---

## 工作流程

> 核心执行流程（意图识别、脚本调用、表格渲染规则、空结果与错误处理等）详见 `references/core_workflow.md`，Agent 执行时必须遵循该文件中的所有规则。

---

## 使用指南

### 🔑 鉴权

首次使用需配置环境变量 `REDFOX_API_KEY`：前往 [红狐 hub](https://redfox.hk/settings/api-keys?source=github) 注册账号并获取 API Key，终端与 OpenClaw 的配置方式详见 `references/core_workflow.md` Step 0。

### 常用说法速查

| 意图 | 示例话术 | 效果 |
| ---- | -------- | ---- |
| 搜索视频 | 「搜一下 TikTok 上 NVIDIA 的视频」 | 输出视频列表与爆款视频 TOP3 拆解（默认按播放数降序） |
| 找账号 / 达人 | 「TikTok 上做手冲咖啡的账号有哪些」 | 输出用户列表与达人推荐 TOP3（默认按粉丝数降序） |
| 查话题 | 「查一下 cat 话题在 TikTok 上的数据」 | 输出话题列表与话题趋势解读（默认按浏览量降序） |
| 一次全搜 | 「帮我搜一下露营装备」 | 视频、用户、话题三类数据一次输出，各附分析 |
| 排序与时间筛选 | 「按点赞排序，只看最近一周的」 | 视频按点赞降序 + 发布时间筛选 |
| 粉丝数筛选 | 「只看 10 万粉以上的账号」 | 用户按粉丝数区间筛选 |
| 继续翻页 | 「看下一页」 | 基于上一页提示继续输出下一页 |
| 导出报告 | 「导出报告」 | 提供 HTML 报告，支持导出 PDF / 高清图片 |
| 查看原始数据 | 「输出原始返回」 | 输出原始数据内容 |

---

## 注意事项

1. **数据真实性**：所有数值均来自数据服务返回，如实展示，严禁估算或编造
2. **查询无果不替换**：空结果时如实说明并给出可选调整方向，不自动改查其他关键词
3. **积分保护**：每次成功查询可能消耗积分，全量搜索一次包含 3 次数据查询；未经用户明确指定，不主动翻页或批量查询多个关键词
4. **鉴权**：首次使用需配置环境变量 `REDFOX_API_KEY`，API Key 获取与配置详见 `references/core_workflow.md`
5. **链接完整性**：输出中的链接保持完整可点击，不使用被终端截断的 URL
6. **分析为推测**：爆款原因、关注理由与话题解读基于公开数据撰写，须明确标注为推测，不虚构