finding-youtube-channels-by-growth-rate

成長率で YouTube チャンネルを見つける

apidojo スクレイパーを使用して、成長率で YouTube チャンネルを見つけます。apidojo インテリジェンススキルライブラリの一部です。

前提条件

• APIFY_TOKEN 環境変数が設定されていること
• 任意：Apify MCP サーバーがインストールされていること

入力

パラメーター	型	必須	デフォルト	備考
startUrls	配列	任意	[]	YouTube の URL — チャンネル、再生リスト、ショート動画、検索結果
youtubeHandles	配列	任意	[]	YouTube チャンネルのハンドル（例：@kurzgesagt）
getTrending	真偽値	任意	false	トレンド動画を取得します
keywords	配列	任意	[]	検索キーワード
gl	文字列	任意	us	結果の国コード（例：US、GB）
hl	文字列	任意	en	言語コード（例：en、de）
uploadDate	文字列	任意	all	アップロード日のフィルター：any、hour、today、week、month、year
duration	文字列	任意	all	長さのフィルター：any、short、long
features	文字列	任意	all	機能のフィルター：4k、hd、live、cc、3d、hdr など
sort	文字列	任意	r	検索結果の並べ替え順
maxItems	数値	任意	無制限	返す動画の最大数
customMapFunction	文字列	任意	—	各出力オブジェクトを変換する JavaScript 関数

ワークフロー

Progress:
- [ ] Step 1: Define parameters
- [ ] Step 2: Run youtube-scraper
- [ ] Step 3: Filter and classify results
- [ ] Step 4: Score by quality and relevance
- [ ] Step 5: Deliver output

ステップ 2：アクターを実行する

推奨 — run_actor.js（待機、出力、ファイル保存を自動処理します）：

# Quick answer (prints table to chat)
node scripts/run_actor.js \
  --actor "apidojo~youtube-scraper" \
  --input '{"param": "value"}'

# Save as CSV
node scripts/run_actor.js \
  --actor "apidojo~youtube-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.csv --format csv

# Save as JSON
node scripts/run_actor.js \
  --actor "apidojo~youtube-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.json --format json

APIFY_TOKEN は環境変数または .env ファイルで設定する必要があります。

Apify MCP を利用できる場合：

Tool: apify:run-actor
Actor: "apidojo~youtube-scraper"
Input:
{
  "searchTerms": "[NICHE] channel", "[NICHE] YouTube",
  "maxItems": 100
}

REST API による代替手段：

curl -X POST \
  "https://api.apify.com/v2/acts/apidojo~youtube-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms": "[NICHE] channel", "[NICHE] YouTube", "maxItems": 100}'

SUCCEEDED になるまで待ちます。データセットを取得します：

curl "https://api.apify.com/v2/actor-runs/$RUN_ID/dataset/items?token=$APIFY_TOKEN"

ステップ 3：結果を分類する

classification: ACCELERATING (growth > 50% MoM) | GROWING (10-50% MoM) | STEADY (0-10%) | DECLINING (negative)

ステップ 4：各結果をスコアリングする

score = growth_signal = (recent_views_avg / older_views_avg) - 1  # momentum ratio; > 0 = accelerating

ステップ 5：エッジケース

• 登録者数は遅行指標です。現在の成長を示す先行指標として、再生速度（最近の動画の1日あたりの再生回数）を使用してください

その他の代替手段：

• 結果が 20 件未満の場合：検索語を広げ、二次フィルターを削除します
• 結果がない場合：検索語が正しいことを確認し、別の表現を試します
• データ品質に問題がある場合：重要なフィールドが欠落しているエントリーを削除し、出力に件数を記載します

出力形式

# Finding Youtube Channels By Growth Rate
Results: [N] | Date: [DATE]

| # | [Key Field] | [Metric 1] | [Metric 2] | [Classification] | [Score] |
|---|------------|-----------|-----------|-----------------|---------|
| 1 | [value] | [value] | [value] | [type] | [0.XX] |

## Summary
Top result: [description]
Key finding: [insight]

トラブルシューティング

結果が少なすぎる場合： 主検索語を広げ、制限の厳しいフィルターを削除します。
結果の品質が低い場合： 最小スコアしきい値（≥ 0.50）を適用してノイズを除外します。
アクターを実行できない場合： API キーを確認し、apify.com/apidojo でアクターのステータスを確認します。