douyin-search-keywordlisted
Install: claude install-skill aiskillstore/marketplace
# 抖音搜索关键词技能 (Douyin Search Keyword)
## 1. 技能概述
### 1.1 核心定位
抖音公开内容智能搜索,精准检索视频/图文/用户数据,支持多维度排序与时间筛选,输出结构化JSON/Markdown,**助力短视频营销、竞品分析与热点追踪**。
### 1.2 核心能力
- 🔍 **抖音热门搜索**:精准检索视频/图文/用户数据
- 🎯 **多维度排序**:按点赞数、最新发布智能排序
- 📅 **时间筛选**:支持1天/7天/半年内数据精准筛选
- 📊 **互动数据**:提取点赞、评论、收藏、分享等核心指标
- 🛠️ **智能纠错**:自动清洗关键词,提升检索准确率
- 📦 **多格式输出**:JSON(程序处理)/Markdown(人工阅读)双格式
### 1.3 适用场景
| 场景 | 用户痛点 | 技能如何解决 |
| :------------: | :------------------: | :--------------------------------------: |
| **短视频营销** | 缺乏爆款视频创意灵感 | 一键获取“抖音热门”视频数据,分析热门趋势 |
| **竞品分析** | 难以追踪竞品内容策略 | 精准搜索竞品账号视频,分析互动数据 |
| **热点追踪** | 错过热点话题黄金期 | 实时搜索“抖音热门”话题,掌握最新动态 |
- 链接提取:直接获取视频下载地址和图文原始链接
### 1.4 技能特性
- **实时搜索**:获取最新的抖音公开内容
- **参数灵活**:支持排序、时间、数量、格式自定义
- **安全可靠**:仅采集公开数据,符合数据采集合规要求
- **易于集成**:支持 OpenClaw 环境和直接命令行调用
- **多维度数据**:返回视频、图文等多种类型内容
- **详细信息**:包含标题、发布人、互动数据等完整信息
### 1.5 技术原理
该技能通过调用抖音搜索API,实现关键词搜索功能。具体流程如下:
1. 接收用户输入的搜索关键词
2. 清洗关键词,移除特殊符号
3. 验证关键词格式
4. 调用API创建搜索任务
5. 轮询获取搜索结果
6. 格式化输出结果
7. 保存结果到本地文件
## 2. 快速调用指南
### 2.1 前置条件
- 安装Node.js 16+环境
- 配置环境变量 `GUAIKEI_API_TOKEN`(默认TOKEN仅用于体验,���有TOKEN需申请)
### 2.2 基础语法
```bash
# 语法:node scripts/search.js [关键词] [选项]
```
### 2.3 选项说明
| 选项 | 类型 | 可选值 | 默认值 | 说明 |
| --------- | ------ | -------------------- | ------ | ------------------------------------------------------- |
| --keyword | string | 2-50字符(无特殊符号) | 无 | 搜索关键词(必