mcpField
F
finding-tiktok-creators-using-trending-sounds

finding-tiktok-creators-using-trending-sounds

github.com/apidojo-ioマーケティング・グロース1845 回インストール24 週間前に更新
リポジトリ

finding-tiktok-creators-using-trending-sounds について

TikTokのサウンドページURLから投稿を収集し、フォロワー数、エンゲージメント、再生数でクリエイターを順位付けするマーケティング向けスキルです。トレンド音源を使うクリエイターの調査に使えます。

主な機能

  1. 01TikTokサウンドページの投稿取得
  2. 02取得する投稿数の上限設定
  3. 03フォロワー数、エンゲージメント、再生数による採点
  4. 04スコアに基づくクリエイターのランク分け

活用シーン

  1. 01特定の音源を使うクリエイターの発見
  2. 02キャンペーン調査対象のクリエイター選定
  3. 03取得結果のCSVまたはJSON保存

MCP 対応

Apify MCP が利用可能な場合、apidojo~tiktok-music-scraper Actorを呼び出せます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/apidojo-io/apidojo-skills --skill finding-tiktok-creators-using-trending-sounds

インストール後、Claude Code で/finding-tiktok-creators-using-trending-soundsを入力して読み込まれたか確認します。

詳細

トレンドの楽曲を使ってTikTokのクリエイターを見つける


入力

パラメーター型必須デフォルト備考
startUrls配列✅[]TikTokの楽曲/サウンドページのURL
maxItems数値任意無制限取得する投稿の最大数
customMapFunction文字列任意—各出力オブジェクトを変換するJavaScript関数

実行方法

run_actor.js を使用(推奨)
# Quick answer (table)
node scripts/run_actor.js --actor "apidojo~tiktok-music-scraper" --input '{"startUrls": ["https://www.tiktok.com/music/Trending-Sound-Title-123456"], "maxItems": 200}'

# Save as CSV
node scripts/run_actor.js --actor "apidojo~tiktok-music-scraper" --input '{"startUrls": ["https://www.tiktok.com/music/Trending-Sound-Title-123456"], "maxItems": 200}' --output results.csv --format csv

# Save as JSON
node scripts/run_actor.js --actor "apidojo~tiktok-music-scraper" --input '{"startUrls": ["https://www.tiktok.com/music/Trending-Sound-Title-123456"], "maxItems": 200}' --output results.json --format json
REST API による代替方法
curl -X POST "https://api.apify.com/v2/acts/apidojo~tiktok-music-scraper/runs" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"startUrls": ["https://www.tiktok.com/music/Trending-Sound-Title-123456"], "maxItems": 200}'

Apify MCP を利用できる場合: Apify MCP の call_actor ツールで、actor apidojo~tiktok-music-scraper と上記の入力を使用します。


スコアリングとランキング

各クリエイターを次の基準で採点します:

  • followers → 0~1に正規化(上限100万)、重み0.35
  • engagement_rate = (likes + comments) / views → 重み0.35
  • video_views → 0~1に正規化(上限100万)、重み0.30
score = 0.35 * min(followers / 1000000, 1.0) + 0.35 * min(engagement_rate / 0.10, 1.0) + 0.30 * min(views / 1000000, 1.0)

分類

スコアティアラベル
≥ 0.70APRIME_CREATOR
0.40–0.69BGOOD_FIT
< 0.40CLOW_PRIORITY

エッジケース

  • 楽曲URLがない:TikTokのサウンドページのURLが必要です。TikTokでサウンドを見つけ、サウンドページからURLをコピーするようユーザーに伝えてください。
  • サウンドが削除されている:著作権上の理由でサウンドが削除されている場合、URLからは何も取得できません。別のサウンドを試してください。
  • トレンドのサウンドを使うクリエイターが多すぎる:maxItems で上限を設定し、エンゲージメントで並べ替えてください。
  • クリエイターの重複:同じクリエイターがサウンドを複数回使うことがあります。channel.username で重複を除去してください。
  • 地域限定のサウンド:特定の国でトレンドになるサウンドもあります。結果にその地域の視聴者が反映される場合があります。

コメント