discovering-brand-ambassadors-across-platforms

プラットフォーム横断でブランドアンバサダーを見つける

apidojo のスクレーパーを使用して、プラットフォーム横断でブランドアンバサダーを見つけます。apidojo のインテリジェンススキルライブラリの一部です。

前提条件

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

入力

パラメーター	型	必須	デフォルト	備考
startUrls	array	✅	[]	Instagram の URL — プロフィール、ハッシュタグ、場所、音声ページ、リール
until	string	任意	—	この日付まで投稿をスクレイピングします（YYYY-MM-DD）
maxItems	number	任意	無制限	返す投稿の最大数
customMapFunction	string	任意	—	各出力オブジェクトを変換する JavaScript 関数

ワークフロー

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

ステップ 2：Actor を実行する

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

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

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

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

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

Apify MCP が利用可能な場合：

Tool: apify:run-actor
Actor: "apidojo~instagram-scraper"
Input:
{
  "searchTerms": ["#[brand]", "#[brand]ambassador", "#[brand]fam"],
  "maxItems": 100
}

REST API による代替手段：

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

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

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

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

classification: MEGA (combined reach > 500K) | MACRO (100K-500K) | MICRO (10K-100K) | NANO (1K-10K)

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

score = combined_reach = IG_followers + TikTok_followers * 0.8 + Twitter_followers * 0.5  # platform-weighted

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

• 同じクリエイターでも、プラットフォームによってオーディエンス数が大きく異なることがよくあります。プラットフォームごとの統計を個別に記載し、単純に合算しないでください

その他の代替手段：

• 結果が 20 件未満：検索語句を広げ、二次フィルターを削除します
• 結果がない：検索語句が正しいことを確認し、別の表現を試します
• データ品質の問題：必須フィールドが欠けている項目を削除し、出力に件数を記載します

出力形式

# Discovering Brand Ambassadors Across Platforms
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）を適用してノイズを除外します。 Actor の実行に失敗する場合： API キーを確認し、apify.com/apidojo で Actor のステータスを確認します。