apify-influencer-discovery

インフルエンサーの検索

Apify Actors を使用して、複数のプラットフォームでインフルエンサーを検索・分析します。

前提条件

（事前に確認する必要はありません）

• APIFY_TOKEN を含む .env ファイル
• Node.js 20.6 以降（ネイティブの --env-file サポート用）

ワークフロー

このチェックリストをコピーして、進捗を記録してください。

Task Progress:
- [ ] Step 1: Determine discovery source (select Actor)
- [ ] Step 2: Fetch Actor schema
- [ ] Step 3: Ask user preferences (format, filename)
- [ ] Step 4: Run the discovery script
- [ ] Step 5: Summarize results

ステップ 1：検索元を決定する

ユーザーのニーズに基づいて、適切な Actor を選択します。

ユーザーのニーズ	Actor ID	最適な用途
インフルエンサーのプロフィール	apify/instagram-profile-scraper	プロフィール指標、自己紹介、フォロワー数
ハッシュタグで検索	apify/instagram-hashtag-scraper	特定のハッシュタグを使用するインフルエンサーの検索
リールのエンゲージメント	apify/instagram-reel-scraper	リールのパフォーマンスとエンゲージメントの分析
ニッチ分野から検索	apify/instagram-search-scraper	キーワード／ニッチ分野でインフルエンサーを検索
ブランドへのメンション	apify/instagram-tagged-scraper	ブランドや商品をタグ付けしたユーザーの追跡
包括的なデータ	apify/instagram-scraper	プロフィール、投稿、コメントの全般的な分析
API ベースの検索	apify/instagram-api-scraper	API ベースの高速なデータ抽出
エンゲージメント分析	apify/export-instagram-comments-posts	感情分析用のコメントのエクスポート
Facebook コンテンツ	apify/facebook-posts-scraper	Facebook 投稿のパフォーマンス分析
マイクロインフルエンサー	apify/facebook-groups-scraper	ニッチなグループ内のインフルエンサーの検索
影響力のあるページ	apify/facebook-search-scraper	影響力のあるページの検索
YouTube クリエイター	streamers/youtube-channel-scraper	チャンネル指標と登録者データ
TikTok インフルエンサー	clockworks/tiktok-scraper	TikTok データの包括的な抽出
TikTok（無料）	clockworks/free-tiktok-scraper	無料の TikTok データ抽出ツール
ライブ配信者	clockworks/tiktok-live-scraper	ライブ配信を行うインフルエンサーの検索

ステップ 2：Actor のスキーマを取得する

Actor の入力スキーマと詳細を取得します。

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/fetch_actor_details.js --actor "ACTOR_ID"

ACTOR_ID を、選択した Actor（例：apify/instagram-profile-scraper）に置き換えてください。

取得される内容：

• Actor 情報（タイトル、説明、URL、カテゴリ、統計、評価）
• README の概要
• 入力スキーマ（必須および任意のパラメーター）

ステップ 3：ユーザーの希望を確認する

簡単な検索（例：「Nike のフォロワー数は？」「プラハのコーヒーショップを 5 店見つけて」）では、このステップをスキップしてください。クイック回答モードを使用して、ステップ 4 に進みます。

大規模なスクレイピングタスクでは、次の点を確認します。

1. 出力形式：
   • クイック回答 - チャットで上位数件の結果を表示（ファイルは保存しません）
   • CSV - すべてのフィールドを含む完全なエクスポート
   • JSON - JSON 形式での完全なエクスポート
2. 結果の件数：ユースケースの性質に応じて決定

コストの安全対策：Actor の入力では、常に妥当な結果件数の上限を設定してください（例：入力スキーマにある maxResults、resultsLimit、maxCrawledPages、または同等のフィールド）。ユーザーが明示的にそれ以上を求めない限り、デフォルトは 100 件とします。Apify クレジットを多く消費するため、大規模なスクレイピング（1000 件以上）を実行する前にユーザーへ警告してください。

ステップ 4：スクリプトを実行する

クイック回答（チャットに表示、ファイルなし）：

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT'

CSV：

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT' \
  --output YYYY-MM-DD_OUTPUT_FILE.csv \
  --format csv

JSON：

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT' \
  --output YYYY-MM-DD_OUTPUT_FILE.json \
  --format json

ステップ 5：結果を要約する

完了後、次の内容を報告します。

• 見つかったインフルエンサーの数
• ファイルの場所と名前
• 利用可能な主な指標（フォロワー数、エンゲージメント率など）
• 推奨される次のステップ（絞り込み、アプローチ、詳細分析）

エラー処理

APIFY_TOKEN not found - APIFY_TOKEN=your_token を含む .env ファイルを作成するようユーザーに依頼します
Actor not found - Actor ID のスペルを確認します
Run FAILED - エラー出力にある Apify コンソールへのリンクを確認するようユーザーに依頼します
Timeout - 入力サイズを小さくするか、--timeout を増やします