[Skill 名] douyin-search-keyword

抖音検索キーワードスキル (Douyin Search Keyword)

1. スキルの概要

1.1 コアな位置づけ

抖音の公開コンテンツをインテリジェントに検索し、動画/画像・テキスト/ユーザーデータを正確に取得します。多次元ソートと時間フィルタリングに対応し、構造化されたJSON/Markdownを出力することで、ショート動画マーケティング、競合分析、トレンド追跡を支援します。

1.2 コア機能

• 🔍 抖音人気検索: 動画/画像・テキスト/ユーザーデータを正確に取得
• 🎯 多次元ソート: いいね数、最新投稿でインテリジェントにソート
• 📅 時間フィルタリング: 1日/7日/半年以内のデータを正確にフィルタリング
• 📊 インタラクションデータ: いいね、コメント、お気に入り、シェアなどの主要指標を抽出
• 🛠️ インテリジェントな誤り訂正: キーワードを自動的にクリーンアップし、検索精度を向上
• 📦 複数形式出力: JSON（プログラム処理用）/Markdown（人間が読む用）の2形式

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 基本構文

# 構文：node scripts/search.js [キーワード] [オプション]

2.3 オプションの説明

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 件の結果**

4. 注意事項

4.1 コンプライアンス要件

• 抖音の公開データ収集のみに利用し、プライベート/違反コンテンツのスクレイピングは禁止
• OpenClaw のセキュリティ規範とデータ収集のコンプライアンス要件に準拠

4.2 リスク管理に関する注意

• デフォルトのTOKENには呼び出し頻度制限があります。本番環境ではプライベートTOKENの使用をお勧めします
• CDNリンク（動画/画像）は一時的なリンクですので、速やかにダウンロードして保存することをお勧めします
• キーワードに違反コンテンツが含まれている場合、スキルは直接ブロックして警告を表示します