Agent skill

tiktok-scraper

Apify の clockworks~tiktok-scraper を使って TikTok トレンドを検索する

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/tiktok-scraper

Metadata

Additional technical details for this skill

openclaw 
{
    "os": [
        "linux"
    ],
    "emoji": "\ud83d\udcf1"
}

SKILL.md

tiktok-scraper

trend-hunter が TikTok トレンドを収集するために使うスキル。Apify Actor clockworks~tiktok-scraper を API 経由で実行する。

必須 env

キー 説明
APIFY_API_TOKEN Apify API トークン（~/.openclaw/.env に設定）

使い方

1. Actor を実行（POST）

bash
curl -s -X POST \
  "https://api.apify.com/v2/acts/clockworks~tiktok-scraper/runs?token=${APIFY_API_TOKEN}" \
  -H 'Content-Type: application/json' \
  -d '{
    "searchQueries": ["meditation", "習慣", "mindfulness"],
    "resultsPerPage": 20,
    "shouldDownloadVideos": false,
    "shouldDownloadCovers": false
  }'

レスポンスから data.id（run ID）を取得。

2. 結果を取得（GET）

実行完了を待ってから（数十秒〜数分）:

bash
curl -s "https://api.apify.com/v2/actor-runs/${RUN_ID}/dataset/items?token=${APIFY_API_TOKEN}"

3. 実行ステータス確認

bash
curl -s "https://api.apify.com/v2/actor-runs/${RUN_ID}?token=${APIFY_API_TOKEN}"

data.status が SUCCEEDED になるまでポーリング（10秒間隔、最大 5 分）。

代替: 同期実行（小規模検索向け）

少量の検索なら同期で結果を直接取得:

bash
curl -s -X POST \
  "https://api.apify.com/v2/acts/clockworks~tiktok-scraper/run-sync-get-dataset-items?token=${APIFY_API_TOKEN}" \
  -H 'Content-Type: application/json' \
  -d '{
    "searchQueries": ["meditation anxiety"],
    "resultsPerPage": 10,
    "shouldDownloadVideos": false,
    "shouldDownloadCovers": false
  }'

レスポンスから使うフィールド

フィールド 説明
text 動画のキャプション
diggCount いいね数
shareCount シェア数
playCount 再生数
commentCount コメント数
createTimeISO 投稿日時
webVideoUrl 動画 URL
authorMeta.name 投稿者名
hashtags ハッシュタグ配列

trend-hunter での使い方

trend-hunter は上記 API を呼び、playCount や diggCount が高い動画のキャプション・ハッシュタグをトレンド候補として trends/YYYY-MM-DD.json に書く。

Slack 報告

【絶対】 実行結果・要約は Slack #metrics（チャンネル ID: C091G3PKHL2）に投稿する。成功でも失敗でも必ず投稿する。投稿しないことは許されない。

禁止事項

  • 動画のダウンロードはしない（shouldDownloadVideos: false）
  • Apify クレジットの無駄遣いを避けるため、resultsPerPage は 20 以下にする

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results