douyin-search-keyword

Douyin Search Keyword Skill

1. Skill Overview

1.1 Core Positioning

Intelligent search of public Douyin content, precise retrieval of video/image-text/user data, supports multi-dimensional sorting and time filtering, outputs structured JSON/Markdown,helping with short video marketing, competitor analysis, and trend tracking。

1.2 Core Capabilities

🔍 Douyin Hot Search: precise retrieval of video/image-text/user data
🎯 Multi-dimensional Sorting: intelligent sorting by number of likes and latest publication
📅 Time Filtering: supports precise filtering of data within 1 day/7 days/half a year
📊 Interaction Data: extracts core metrics such as likes, comments, favorites, and shares
🛠️ Intelligent Error Correction: automatically cleans keywords to improve retrieval accuracy
📦 Multi-format Output: dual formats of JSON (for program processing)/Markdown (for manual reading)

1.3 Applicable Scenarios

Scenario	User Pain Point	How the Skill Solves It
Short Video Marketing	Lack of creative inspiration for viral videos	One-click access to "Douyin Hot" video data to analyze popular trends
Competitor Analysis	Difficult to track competitors' content strategies	Precisely search competitor account videos and analyze interaction data
Trend Tracking	Missing the golden period of trending topics	Search "Douyin Hot" topics in real time and grasp the latest developments

Link Extraction: directly obtain video download addresses and original image-text links

1.4 Skill Features

Real-time Search: obtain the latest public Douyin content
Flexible Parameters: supports customization of sorting, time, quantity, and format
Safe and Reliable: only collects public data, complying with data collection compliance requirements
Easy to Integrate: supports the OpenClaw environment and direct command-line invocation
Multi-dimensional Data: returns multiple types of content such as videos and image-text posts
Detailed Information: includes complete information such as title, publisher, and interaction data

1.5 Technical Principles

This skill implements keyword search by calling the Douyin Search API. The specific process is as follows:

Receive the search keyword entered by the user
Clean the keyword and remove special symbols
Validate the keyword format
Call the API to create a search task
Poll to obtain search results
Format the output results
Save the results to a local file

2. Quick Invocation Guide

2.1 Prerequisites

Install the Node.js 16+ environment
Configure the environment variable GUAIKEI_API_TOKEN(the default TOKEN is only for trial use; a private TOKEN must be applied for)

2.2 Basic Syntax

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

2.3 Option Description

Option	Type	Available Values	Default value	Description
--keyword	string	2-50 characters (no special symbols)	None	Search keyword (required)
--sort	number	0/1/2	0	Sort method (0 - Comprehensive / 1 - Most liked / 2 - Latest)
--time	number	0/1/7/180	0	Publish time range (0 - All / 1 - 1 day / 7 - 7 days / 180 - Half a year)
--limit	number	10-60	10	Number of returned results
--output	string	json/markdown	json	Output format
--help/-h	-	-	-	Show help information

2.4 Typical examples

# 示例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. Output data specification

3.1 JSON format (default)

{
  "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 format (for human reading)

Display search results in a structured list format, verysuitable for content creators to quickly browse and organize inspiration materials。

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

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

---

**共 20 条结果**

4. Notes

4.1 Compliance requirements

Only for collecting public Douyin data; crawling private/violating content is prohibited
Complies with OpenClaw security specifications and data collection compliance requirements

4.2 Risk control tips

The default TOKEN has call frequency limits; for production environments, it is recommended to use a private TOKEN
CDN links (videos/images) are temporary links; it is recommended to download and save them promptly
When keywords contain violating content, the skill will directly intercept and prompt