SKILL.md for douyin-video-search

描述

一个功能强大的抖音视频搜索技能，它通过调用 **TikHub 官方 API** 来获取搜索结果。该技能支持通过关键词进行搜索，并提供了丰富的参数选项，包括分页、多种排序方式（综合、最多点赞、最新发布）以及发布时间和视频时长的筛选。

这是一个核心的、原子化的搜索工具，可以被其他上层技能（如 visual-benchmark-finder）调用，以实现更复杂的业务逻辑。

配置

本技能需要一个有效的 TikHub API Token 才能工作。请在您的 ~/.openclaw/config.json 文件中添加以下配置项。该 Token 可与 douyin-downloader 等其他 TikHub 系技能共用。

{
  "tikhub_api_token": "YOUR_TIKHUB_API_TOKEN"
}

> 您可以在 [TikHub 官网](https://user.tikhub.io/register) 注册免费获取 Token。

如何使用

该技能的核心脚本 (scripts/douyin_search.py) 是一个功能完善的命令行工具，可以直接调用，也可以被其他技能通过 exec 工具调用。

参数

* **keyword**（必填）：搜索的关键词。

* **--cursor**：分页游标，第一页默认为 0。

* **--sort**：排序方式。

* 0：综合（默认）

* 1：最多点赞

* 2：最新发布

* **--publish**：发布时间。

* 0：不限（默认）

* 1：最近一天

* 7：最近一周

* 180：最近半年

* **--duration**：视频时长。

* 0：不限（默认）

* 0-1：1分钟内

* 1-5：1-5分钟

* 5-10000：5分钟以上

* **--raw**：如果提供此参数，将输出原始的 JSON 数据而不是格式化后的文本。

示例调用

**简单搜索：**

& "F:\python 3.10\python.exe" "C:\Users\EDY\.openclaw\skills\douyin-video-search\scripts\douyin_search.py" "美食"

**带参数的高级搜索：**

& "F:\python 3.10\python.exe" "C:\Users\EDY\.openclaw\skills\douyin-video-search\scripts\douyin_search.py" "旅行" --sort "2" --publish "7"