---
name: douyin-scraper
description: 爬取抖音视频和文案数据。支持按关键词搜索视频、获取热榜、提取视频信息。当用户说"搜索一下XX视频"、"帮我找找XX"、"抖音上搜XX"等自然语言时使用此 skill。
version: 1.1.0
---

# 抖音爆款爬虫 Skill

## 何时使用

当用户的请求涉及以下意图时，使用此 skill：

- **搜索视频**：用户想搜索某类/某主题的抖音视频
- **看热榜**：用户想看抖音热门/热榜
- **找文案**：用户想找某类视频的文案/标题/描述
- **分析视频**：用户提供抖音链接想获取信息

## 自然语言 → 命令映射（关键）

收到自然语言请求后，提取关键词并执行对应的命令：

| 用户说的 | 提取关键词 | 执行命令 |
|---------|-----------|---------|
| 搜索一下海鲜视频 | 海鲜 | `python3 scripts/scraper.py search --keyword "海鲜" --limit 10` |
| 帮我找找海鲜售卖的视频文案 | 海鲜售卖 | `python3 scripts/scraper.py search --keyword "海鲜售卖" --limit 10` |
| 抖音上搜小龙虾 | 小龙虾 | `python3 scripts/scraper.py search --keyword "小龙虾" --limit 10` |
| 看看抖音热榜有什么 | (无) | `python3 scripts/scraper.py hot --limit 20` |
| 美食类热榜 | 美食 | `python3 scripts/scraper.py hot --category "美食" --limit 20` |
| 找10个海鲜视频 | 海鲜 | `python3 scripts/scraper.py search --keyword "海鲜" --limit 10` |

### 映射规则

1. **提取搜索词**：从用户请求中提取核心关键词（去掉"搜索"、"视频"、"帮我找"等功能词）
2. **搜索类请求** → `python3 scripts/scraper.py search --keyword "<关键词>" --limit <数量>`
3. **热榜类请求** → `python3 scripts/scraper.py hot --category "<分类>" --limit <数量>`（分类可选）
4. **默认数量**：未指定时搜索默认 10 条，热榜默认 20 条
5. **工作目录**：命令在 skill 根目录下执行（`cd ~/.openclaw/workspace/douyin-scraper`）

## 执行方式

所有命令在 skill 目录下执行：

```bash
cd ~/.openclaw/workspace/douyin-scraper && python3 scripts/scraper.py <command> [options]
```

### 搜索

```bash
python3 scripts/scraper.py search --keyword "海鲜" --limit 10
python3 scripts/scraper.py search --keyword "海鲜售卖" --limit 20 --output result.json
```

### 热榜

```bash
python3 scripts/scraper.py hot --limit 20
python3 scripts/scraper.py hot --category "美食" --limit 20
```

## 输出格式

结果以编号列表输出到 stdout，同时可选保存 JSON/CSV 文件。

每条结果包含：
- 标题、描述、作者
- 播放量、点赞数、评论数、分享数
- 视频链接、标签、发布时间

## 注意事项

- Playwright 已预装，浏览器已就绪
- 抖音页面可能需要登录或有人机验证，搜索结果可能受限
- 建议请求间隔 ≥ 2 秒
- 仅供学习研究使用