Marketplace douyin-search-keyword

抖音公开内容智能搜索，精准检索视频/图文/用户数据，支持多维度排序与时间筛选，输出结构化JSON/Markdown，助力短视频营销、竞品分析与热点追踪。

install

source · Clone the upstream repo

git clone https://github.com/aiskillstore/marketplace

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/aiskillstore/marketplace "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/um-why/douyin-search-keyword" ~/.claude/skills/aiskillstore-marketplace-douyin-search-keyword && rm -rf "$T"

manifest: skills/um-why/douyin-search-keyword/SKILL.md

source content

抖音搜索关键词技能 (Douyin Search Keyword)

1. 技能概述

1.1 核心定位

抖音公开内容智能搜索，精准检索视频/图文/用户数据，支持多维度排序与时间筛选，输出结构化JSON/Markdown，助力短视频营销、竞品分析与热点追踪。

1.2 核心能力

🔍 抖音热门搜索：精准检索视频/图文/用户数据
🎯 多维度排序：按点赞数、最新发布智能排序
📅 时间筛选：支持1天/7天/半年内数据精准筛选
📊 互动数据：提取点赞、评论、收藏、分享等核心指标
🛠️ 智能纠错：自动清洗关键词，提升检索准确率
📦 多格式输出：JSON（程序处理）/Markdown（人工阅读）双格式

1.3 适用场景

场景	用户痛点	技能如何解决
短视频营销	缺乏爆款视频创意灵感	一键获取“抖音热门”视频数据，分析热门趋势
竞品分析	难以追踪竞品内容策略	精准搜索竞品账号视频，分析互动数据
热点追踪	错过热点话题黄金期	实时搜索“抖音热门”话题，掌握最新动态

链接提取：直接获取视频下载地址和图文原始链接

1.4 技能特性

实时搜索：获取最新的抖音公开内容
参数灵活：支持排序、时间、数量、格式自定义
安全可靠：仅采集公开数据，符合数据采集合规要求
易于集成：支持 OpenClaw 环境和直接命令行调用
多维度数据：返回视频、图文等多种类型内容
详细信息：包含标题、发布人、互动数据等完整信息

1.5 技术原理

该技能通过调用抖音搜索API，实现关键词搜索功能。具体流程如下：

接收用户输入的搜索关键词
清洗关键词，移除特殊符号
验证关键词格式
调用API创建搜索任务
轮询获取搜索结果
格式化输出结果
保存结果到本地文件

2. 快速调用指南

2.1 前置条件

安装Node.js 16+环境
配置环境变量
```
GUAIKEI_API_TOKEN
```
（默认TOKEN仅用于体验，私有TOKEN需申请）

2.2 基础语法

# 语法：node scripts/search.js [关键词] [选项]

2.3 选项说明

选项	类型	可选值	默认值	说明
--keyword	string	2-50字符(无特殊符号)	无	搜索关键词（必传）
--sort	number	0/1/2	0	排序方式（0 - 综合 / 1 - 最多点赞 / 2 - 最新）
--time	number	0/1/7/180	0	发布时间范围（0 - 全部 / 1-1 天 / 7-7 天 / 180 - 半年）
--limit	number	10-60	10	返回结果数量
--output	string	json/markdown	json	输出格式
--help/-h	-	-	-	显示帮助信息

2.4 典型示例

# 示例1：基础搜索(JSON格式)
node scripts/search.js AI
# 示例2：带空格的关键词
node scripts/search.js "AI 教程"
# 示例3：自定义排序(最多点赞)
node scripts/search.js AI --sort 1
# 示例4：自定义发布时间(半年)
node scripts/search.js "AI 模型" --time 180
# 示例5：自定义返回结果数量(20条)
node scripts/search.js AI --limit 20
# 示例6：自定义输出格式(Markdown)
node scripts/search.js "AI 教程" --output markdown
# 示例7：复杂搜索(最新+近半年+20条结果+JSON格式)
node scripts/search.js --keyword "AI 教程" --sort 2 --time 180 --limit 20

3. 输出数据规范

3.1 JSON格式(默认)

{
  "status": "success",
  "keyword": "AI 教程",
  "message": "搜索任务完成",
  "sort": 0,
  "time": 0,
  "limit": 20,
  "output_format": "json",
  "total": 18,
  "timestamp": "2026/3/29 09:05:51",
  "results": [
    {
      "aweme_id": "7622261059679800627",
      "desc": "#刘慈欣称AI不可能完全代替人类作者  科幻作家谈#AI快速发展对科幻产业影响几何",
      "create_time": 1774695958,
      "author_uid": "98524606968",
      "author_nickname": "央视财经",
      "author_avatar": "https://...",
      "author_sec_uid": "MS4wLjABAAAAt6AsGhjrHeoxZNkceYg2J0FWvrWKzEaTAvF44-sPYco",
      "comment_count": 4,
      "digg_count": 356,
      "share_count": 6,
      "collect_count": 17,
      "share_url": "https://www.iesdouyin.com/share/video/...",
      "dynamic_cover": ["https://...", "https://..."],
      "play_addr": "https://...",
      "play_uri": "v0200fg10000d73r95fog65tmhj30190",
      "music_id": "7622261065841150756",
      "music_title": "@央视财经创作的原声",
      "music_author": "央视财经",
      "tags": [
        "刘慈欣称AI不可能完全代替人类作者",
        "AI快速发展对科幻产业影响几何"
      ],
      "url": "https://www.douyin.com/video/xxx",
      "author_url": "https://www.douyin.com/user/xxx",
      "create_time_str": "2026/3/28 19:05:58"
    }
  ]
}

3.2 Markdown格式(人工阅读)

以结构化列表形式展示搜索结果，非常适合内容创作者快速浏览和整理灵感素材。

## **抖音综合搜索结果**: AI 教程

**1 .** 刘慈欣称AI不可能完全代替人类作者 科幻作家谈#AI快速发展对科幻产业影响几何
**发布人**: 央视财经
**发布时间**: 2026/3/28 19:05:58
**链接**: https://www.douyin.com/video/xxx
**封面**: https://...
**视频**: https://...
**点赞**: 364 **评论**: 4 **收藏**: 18 **分享**: 7

---

**共 20 条结果**