apify-influencer-brand-collabs

インフルエンサーとブランドのコラボレーション

Metaの広告ライブラリに対してApify Actorを4つ連携させ、Instagramのブランドコンテンツのパートナーシップを表示します。実運用されている influencer-brand-collabs ミニツールから要点をまとめています。

使用する場面

• 「今四半期、Nikeは誰に宣伝を依頼しましたか？」
• 「@bellahadid はどのブランドのスポンサー投稿をしていますか？」
• アカウントのブランドコンテンツの履歴を監査する
• 競合他社のインフルエンサー一覧を作成する

使用しない場面： オーガニックなメンションやタグ（ハッシュタグ／メンションのスクレイパーを使用）、TikTokやYouTubeのコラボレーション（別のプラットフォーム）、一般的な競合広告（Meta広告ライブラリに直接クエリ）。

収集する入力

1. InstagramのハンドルまたはURL — @adidas または https://www.instagram.com/adidas/
2. 遡る期間 — 日数。デフォルトは90日
3. 追加情報取得の切り替え（それぞれコストと時間が増加します）：
   • コンテンツインサイト — コラボレーションごとの「いいね！」、コメント、再生数
   • プロフィール情報の追加取得 — 相手側のフォロワー数、自己紹介、認証状況

方向（ブランドかクリエイターか）は実測して判定します。ユーザーに尋ねないでください。

パイプライン

#	Actor	目的	必須
1	apify/instagram-profile-scraper	対象のFacebook fbid を特定する	✓
2	apify/brand-collaboration-scraper	Meta広告ライブラリからブランドコンテンツの投稿を取得する	✓
3	apify/instagram-post-scraper + apify/instagram-reel-scraper	エンゲージメント指標	任意
4	apify/instagram-profile-scraper（再度実行）	結果側のパートナー情報を追加取得する	任意

それぞれを mcp__claude_ai_Apify__call-actor 経由で呼び出します。これらを初めて実行する場合や、正確な入力スキーマを確認したい場合は、まず mcp__claude_ai_Apify__fetch-actor-details を使用してください。

ステップ1 — 対象を特定する

// actor: apify/instagram-profile-scraper
{ "usernames": ["adidas"] }

最初の項目から fbid を取得します。fbid がない場合、広告ライブラリにクエリできないため、処理を中止してユーザーに伝えてください。 最もよくある原因は非公開アカウントです。

ステップ2 — Meta広告ライブラリのURLを作成する

https://www.facebook.com/ads/library/branded_content/?id={fbid}&query={username}&target=instagram&start_date={YYYY-MM-DD}&end_date={YYYY-MM-DD}

日付範囲には遡る期間を設定します（デフォルトは90日間で、終了日は今日です）。

ステップ3 — コラボレーションを取得する

// actor: apify/brand-collaboration-scraper
{ "startUrls": ["<ad library url>"], "resultsLimit": 10 }

スキーマは固定です。すべての項目に creator（常にインフルエンサー側）と brandPartners[0]（常にブランド側）があります。これらのフィールドから方向を推測しないでください。

ステップ4 — 実測して方向を判定する

結果の各側で、対象のユーザー名が何回出現するかを数えます。

• 対象が creator 側により多く出現する → 対象はインフルエンサーです。結果はブランドです
• 対象が brandPartners 側により多く出現する → 対象はブランドです。結果はクリエイターです

⚠️ 方向の推測に isBusinessAccount を使わないでください。信頼できないためです。たとえば @fifaworldcup はビジネスアカウントですが、自身のブランドコンテンツのクリエイターとして表示されます。

ステップ5 —（任意）コンテンツ指標

コラボレーションのURLを種類ごとに分けます。

• /reel/... → リールスクレイパー
• /p/... または /tv/... → 投稿スクレイパー

// actor: apify/instagram-post-scraper
{ "username": ["<post urls>"], "resultsLimit": 1, "dataDetailLevel": "basicData" }

// actor: apify/instagram-reel-scraper
{ "username": ["<reel urls>"], "resultsLimit": 1 }

URL内のショートコードを使ってコラボレーションと照合します：/(p|reel|tv)/([A-Za-z0-9_-]+)。

エンゲージメントの計算式： likesCount + commentsCount + (videoViewCount ?? videoPlayCount ?? 0)。

2つのスクレイパーは独立しているため、並列で実行します。

ステップ6 —（任意）結果側の情報を追加取得する

対象ではない側から、重複しないユーザー名を集めます。その後、次のようにします。

// actor: apify/instagram-profile-scraper
{ "usernames": [<unique result-side usernames>] }

ユーザーが実際に知りたい側だけ、追加情報を取得してください。入力されたハンドルはすでに判明しています。

表示する内容

集計後、次の情報を表示します。

• 主要な件数： コラボレーションの合計数、重複しないパートナー数、合計エンゲージメント（指標を追加取得した場合）
• エンゲージメント上位5件のコラボレーション — コンテンツインサイトを有効にした場合のみ有意です
• コンテンツタイプの内訳： 投稿とリール。通常、リールのエンゲージメントが大半を占めます
• 日付範囲全体の週間タイムライン — 急増はキャンペーン開始の兆候です
• パートナーごとのカード（プロフィール情報を追加取得した場合）：ハンドル、氏名、フォロワー数、認証状況、カテゴリ、今回の実行でのコラボレーション数、平均エンゲージメント

「誰が」に関する質問には、パートナー一覧だけで十分です。指標が重要なのは「どれが最も良かったか」に関する質問だけです。

URL の解析

ハンドルを抽出する前に、Instagram の _u/ および _n/ ディープリンクプレフィックスを削除します。

/instagram\.com\/(?:_u\/|_n\/)?([A-Za-z0-9_.]+)/i

以下のスラッグはユーザー名ではありません。スキップしてください。 explore、reels、stories、direct、accounts、about、p、reel、tv、tags、 locations、_u、_n。

注意点

• ターゲットが非公開 → プロフィールスクレーパーは fbid を返しません。早めに処理を中断し、明確なメッセージを表示してください。
• 結果がない → 次の順に試してください。日付範囲を広げる、ハンドルを再確認する（_u/ を削除）、そのアカウントが実際にブランドコンテンツを投稿していることを確認する。Meta がインデックスするのは、ブランドコンテンツに分類した広告のみです。
• エンゲージメントがすべてゼロ → ユーザーがコンテンツの拡充をスキップしています。有効にして再実行することを提案してください。
• 出力の方向性が誤っているように見える → 実測数を再確認してください。isBusinessAccount を鵜呑みにしないでください。
• 指標のないブランドコラボも、「誰が」という質問には回答として有効です。エンリッチメントを条件にワークフロー全体を止めないでください。

コストと所要時間

4 アクターをすべて実行する場合：約 3～5 分、Apify の計算コストは数セントです。おおよその目安：

エンリッチメント	実行するアクター	おおよその時間
なし	2	1～2 分
+ コンテンツ	3～4	2～4 分
+ プロフィール	+1	+30～60 秒

ユーザーがパートナーの一覧だけを必要としている場合は、どちらの切り替えもスキップしてください。

参照実装

このスキルの元になった本番用ルート： mini-tools-main/src/app/api/tools/influencer-brand-collabs/route.ts — 完全な変換ロジック、エラー処理、および各スクレーパーの出力を簡潔にした表示形式が含まれています。