apify-influencer-discovery について
apify-influencer-discoveryは、Apify Actorsを使ってソーシャルメディアのクリエイターを探し、評価するスキルです。キャンペーン企画やアウトリーチ担当者がデータソースを選び、スキーマを確認して、候補一覧や件数を限定したエクスポートを作成できます。
主な機能
- 01プラットフォームや目的に応じたActor選択
- 02Actorの入出力スキーマ確認
- 03件数を限定したCSVまたはJSON出力
- 04クリエイター指標の要約
活用シーン
- 01ニッチやハッシュタグでクリエイターを検索
- 02クリエイターのエンゲージメント指標を比較
- 03キャンペーン企画用の候補一覧を作成
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/apify-influencer-discoveryを入力して読み込まれたか確認します。
同梱ファイルreference/scripts/run_actor.js
詳細
インフルエンサーの発見
Apify Actors を使用して、複数のプラットフォームでインフルエンサーを発見し、分析します。
使用する場面
- アウトリーチ、パートナーシップ、キャンペーンの計画に向けて、クリエイターやインフルエンサーを見つけたい場合。
- ソーシャルプラットフォームを横断して、信頼性、エンゲージメント、ニッチとの適合性、オーディエンスの指標を評価したい場合。
- Apify によるデータ抽出に加え、候補となる適切なインフルエンサーのリストや概要が必要な場合。
前提条件
有料実行の前に、前提条件を確認してください。
APIFY_TOKENを含む.envファイル- Node.js 20.6+（ネイティブの
--env-fileサポートに必要） - 選択した Actor とそのスキーマを確認するための、承認済み Apify コネクターまたは Console へのアクセス。付属のランナーは REST を直接使用します。
.envは追跡対象にせず、非公開にしてください。トークンはチャットやコマンド引数に貼り付けず、ローカルで設定してください。
ワークフロー
このチェックリストをコピーして、進捗を記録してください。
Task Progress:
- [ ] Step 1: Determine discovery source (select Actor)
- [ ] Step 2: Fetch Actor schema via an approved connector or Console
- [ ] 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 のスキーマを取得する
セッションで利用可能な認証済み Apify コネクター、またはその Console ページを使用して、現在の Actor の詳細と入力スキーマを確認してください。ツールを呼び出す前に、実際のツール名とパラメーターを確認してください。シェル置換を使って .env を解析したり、CLI のヘッダー引数としてトークンを渡したりしないでください。Actor の一覧は候補の確認用であり、利用可能性やスキーマが検証済みであることを示すものではありません。
以下が返されます。
- Actor の説明と README
- 必須および任意の入力パラメーター
- 出力フィールド（利用可能な場合）
ステップ 3：ユーザーの希望を確認する
実行する前に、次の点を尋ねてください。
- 出力形式：
- 簡易回答 - チャットに上位数件を表示（ファイルは保存しません）
- CSV - 返されたフィールドの和集合をエクスポート（件数上限あり）
- JSON - JSON 形式でエクスポート（件数上限あり）
- 結果の件数：ユースケースの性質に応じて決定
ステップ 4：スクリプトを実行する
簡易回答（チャットに表示、ファイルなし）：
node --env-file=.env "<resolved-skill-directory>/reference/scripts/run_actor.js" \
--actor "ACTOR_ID" \
--input 'JSON_INPUT'
CSV：
node --env-file=.env "<resolved-skill-directory>/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 "<resolved-skill-directory>/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 - .env を作成し、APIFY_TOKEN=your_token を設定するようユーザーに依頼します。
Connector unavailable - Console でスキーマを確認します。利用できないツールを呼び出したと主張してはいけません。
Actor not found - Actor ID のスペルを確認します。
Run FAILED - エラー出力内の Apify console リンクを確認するようユーザーに依頼します。
Timeout - ローカルのタイムアウトではリモート実行は中断されません。重複課金を避けるため、再試行する前に Console で表示された実行 ID を確認します。
実行の境界
実行を開始する前に、選択した Actor、許可された公開データの範囲、現在の入力スキーマ、結果の上限、料金がユーザーの依頼に沿っていることを確認します。データソースの利用規約とアクセス制御を尊重し、非公開グループのデータや不要な個人連絡先情報を収集しないでください。まず、Actor がサポートする小さな入力上限から始めます。--max-items はダウンロードする出力のみを制限します（デフォルトは 1000）。Actor の処理量や課金は制限しません。ヘルパーは、スキルを識別する User-Agent を Apify に送信します。コマンドのプレースホルダーに、インストール済みスキルのディレクトリを指定してください。出力ファイルには新しいパスを使用します。エクスポートでは、長い値や異種のフィールドが保持されます。簡潔な回答では、取得するレコードを最大 5 件にし、共有する前に個人情報のフィールドを最小限にするか、削除してください。
ランキングの前に、パートナーシップの概要と比較期間を定義します。安定したクリエイター ID を使って重複を除外し、指標の取得日、投稿サンプル、エンゲージメントの分母を記録します。公開されているフォロワー数や「いいね」数だけでは、オーディエンスの真正性、属性の構成、リーチ、コラボレーションの投資対効果を検証できません。不審な兆候は不確実なものとして示し、クリエイターが許可したファーストパーティの証拠を求めます。スクレイピングした比率だけを根拠に、人物を不正行為者だと非難してはいけません。センシティブな特性を推測したり、別途許可されたアウトリーチなしにクリエイターへ連絡したりしないでください。
制限事項
- タスクが上記の説明にある範囲に明確に当てはまる場合に限り、このスキルを使用してください。
- 出力を、環境固有の検証、テスト、専門家によるレビューの代わりとして扱わないでください。
- 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中断して確認を求めてください。