mcp-brand-sponsor-finder

ブランドスポンサー検索 MCP サーバー

過去90日間に特定のニッチでクリエイターに報酬を支払ったブランドを、それぞれの掲載を裏付ける公開情報とともに見つけます。ブランドごとに1行で、最近度スコアを表示し、各掲載については証拠へのリンク、日付、プロモーションコードを1行で表示します。

内容

• できること
• クイックスタート
• 前提条件
• プロンプトの例
• ツール
• 入力
• 料金
• ご自身のキー
• アクターの完全なドキュメント
• ライセンス

できること

• 公開されているYouTube動画の説明（チャンネルフィード、または独自のYouTube Data APIキーを使用）、ポッドキャストの番組ノート、ニュースレターの配信、イベントのスポンサー掲載ページから、スポンサー表記、プロモーションコード、スポンサー枠を読み取ります。
• 短縮リンクやアフィリエイトのリダイレクトをたどってブランド独自のドメインを特定し、すべての掲載をブランドドメインごとに1行にまとめます。
• 検出したブランドについて、募集中のパートナーシップ求人（Greenhouse、Lever、Ashby）と、クリエイターまたはアフィリエイトプログラムのページを確認し、ブランドの公開連絡先として扱います。
• 指定した日付範囲内の掲載のみを、証拠へのリンクとともに返します。Instagram、TikTok、Meta Ad Libraryは読み取りません。

すべての処理はApify上で実行されます。このパッケージは、アクターの実行を開始して完了を待ち、データセットの行を返す薄いクライアントです。

行数の上限とページ分割

1回の実行で数百行が返されることがあります（健康・フィットネス分野を30日間検索した場合、633行、テキスト約0.8 MB）。これはエージェントのコンテキストに収まりません。そのため、各呼び出しで返される行数は最大max_rowsです。指定がない場合は50行で、上限は200行です。

1. 最初の呼び出しで実行を開始し、最初のページを返します。最初のコンテンツブロックは行のJSON配列です。2番目のブロックはページ分割情報で、run_id、total_rows、rows_returned、next_cursorが含まれます。
2. 次のページを取得するには、next_cursorをcursorに設定し、ほかの値は指定せずに、再度find_brand_sponsorsを呼び出します。ページサイズを変更するには、max_rowsを追加します。
3. next_cursorがnullになるまで繰り返します。

カーソルを使った呼び出しでは、実行は開始されません。最初の実行ですでに書き込まれた次のページの行を読み取るため、同じ行に二重で課金されることはありません。カーソルは、Apifyがその実行のデータセットを保持している限り有効です。

クイックスタート

Node.js 18以降と、APIトークンを持つApifyアカウントが必要です。

次の設定をClaude Desktopの設定ファイル（claude_desktop_config.json）、Cursor、または任意のMCPクライアントに追加します。

{
  "mcpServers": {
    "mamba-brand-sponsor-finder": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-brand-sponsor-finder"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

クライアントを再起動すると、find_brand_sponsorsツールが表示されます。

前提条件

• Node.js 18 以降。
• console.apify.com/account/integrations から Apify API トークンを取得し、APIFY_TOKEN として設定します。サーバーはトークンなしでもツールを一覧表示しますが、呼び出しにはトークンが必要です。

プロンプトの例

• 「過去 90 日間に健康・フィットネス系のクリエイターをスポンサーしたブランドを見つけてください。」
• 「今月、美容系の YouTuber に報酬を支払ったブランドはどれですか？ブランドの行のみを表示してください。」
• 「プロモーションコード付きで、ポッドキャストやニュースレターをスポンサーしているコーヒーブランドを一覧表示してください。」

ツール

find_brand_sponsors。ツールは 1 つです。引数の例：

{
  "niche": "health and fitness",
  "window_days": "90"
}

入力

購入者向けのアクター入力はすべてそのまま使用し、ページング設定を2つ追加します。省略した入力にはアクター独自のデフォルト値が適用されます。数値とブール値は文字列として送信されます。

入力	型	説明
niche	string	オーディエンスのニッチ分野です。たとえば「健康とフィットネス」「美容とスキンケア」「食品と飲料」などです。チャンネル、番組、ニュースレターの検索に使用され、すべての行に含まれます。この3つのニッチ分野では、Mamba Labs が以前に調査したソースのリストも検索対象になります（use_niche_presets で無効にできます）
audience_keywords	string	任意。オーディエンスに関する検索語を追加します。1行に1つ、またはカンマ区切りで指定します。例：「筋力トレーニング」。それぞれの語によって、ポッドキャスト、ニュースレター、（API キーがある場合は）YouTube チャンネルの検索範囲が広がります。最大20個です。テキストフィールドのため、Clay の列をそのままマッピングできます
window_days	string	過去 N 日間の情報のみを対象にします。整数で指定します。デフォルトは90、上限は365です。Clay で使用できるよう、テキストとして送信されます。デフォルトは90です
sources	string	任意。実行するソースをカンマ区切りで指定します。指定できる値は youtube、podcast、event、newsletter、job_post、program です。空の場合はすべて実行します。job_post と program は、ほかのソースで見つかったブランドを確認します
seed_sources	string	任意。最初に調査する YouTube チャンネルの URL または @ハンドル、ポッドキャストの RSS フィード URL、ニュースレターの URL を、1行に1つ、またはカンマ区切りで指定します。それぞれのソースは、ソースごとの上限を超えていても調査されます
event_calendar	string	任意。スポンサーまたはパートナーのページを調査するイベントを、オブジェクトの JSON リスト（例：[{"name": "...", "url": "sponsor page URL", "date": "YYYY-MM-DD", "city": "...", "audience": "...", "size": "..."}]）、またはスポンサーのページ URL を1行に1つ指定します。url は必須で、ほかの項目は任意です。期間内の日付が指定されたイベントでは日付付きの行が返され、日付未指定または開催予定のイベントでは日付なしの行が返されます
use_niche_presets	string	true または false。デフォルトは true です。健康とフィットネス、美容とスキンケア、食品と飲料については、Mamba Labs が以前に調査したチャンネル、番組、ニュースレター、イベントページも調査します。デフォルトは true です
include_brands	string	true または false。デフォルトは true です。ブランドのドメインごとに1行を返し、検出回数、最終確認日、ソース、クリエイターまたはイベント、連絡先、最新度スコアが含まれます。デフォルトは true です
include_sightings	string	true または false。デフォルトは true です。検出情報ごとに1行を返し、根拠となるリンク、日付、プロモーションコード、掲載タイプ、提案の切り口が含まれます。デフォルトは true です
max_channels	string	1回の実行で調査する YouTube チャンネル数です。整数で指定します。デフォルトは20、上限は100です。Clay で使用できるよう、テキストとして送信されます。デフォルトは20です
max_videos_per_channel	string	チャンネルごとに調査する最新のアップロード数です（公開フィードには15件が保持されます）。整数で指定します。デフォルトは15、上限は50です。Clay で使用できるよう、テキストとして送信されます。デフォルトは15です
max_podcasts	string	1回の実行で調査するポッドキャスト番組数です。整数で指定します。デフォルトは15、上限は100です。Clay で使用できるよう、テキストとして送信されます。デフォルトは15です
max_episodes_per_podcast	string	番組ごとに調査する最新エピソード数です。整数で指定します。デフォルトは8、上限は30です。Clay で使用できるよう、テキストとして送信されます。デフォルトは8です
max_newsletters	string	1回の実行で調査するニュースレター数です。整数で指定します。デフォルトは8、上限は50です。Clay で使用できるよう、テキストとして送信されます。デフォルトは8です
max_issues_per_newsletter	string	ニュースレターごとに調査する最新号の数です。整数で指定します。デフォルトは8、上限は30です。Clay で使用できるよう、テキストとして送信されます。デフォルトは8です
max_brands_to_check	string	検出回数の多い順に、求人ページとプログラムページを確認するブランド数です。整数で指定します。デフォルトは25、上限は200です。Clay で使用できるよう、テキストとして送信されます。デフォルトは25です
max_charge_usd	string	任意。実行料金がこの金額を超える前に実行を停止します
max_rows	string	ラッパー設定であり、アクターには送信されません。呼び出しごとに返す行数です。整数で指定します。デフォルトは50、上限は200です
cursor	string	ラッパー設定であり、アクターには送信されません。前回の呼び出しで返された next_cursor です。実行は開始せず、その実行の次のページの行を返します

料金

Apify ではイベントごとに課金され、Apify アカウントに請求されます。価格は米ドルです。

イベント	Free プラン	Bronze	Silver	Gold
brand-row：1 行として返されるブランド。ドメイン、目撃件数、最終確認日、ソース、広告費を支払ったクリエイターまたはイベント、公開連絡先、最近度スコアを含みます	$0.02	$0.019	$0.018	$0.017
sighting-row：1 行として返される公開掲載情報。ブランド、ソース、クリエイターまたはイベント、日付、証拠リンク、プロモーションコード、掲載タイプ、提案の切り口を含みます	$0.005	$0.00475	$0.0045	$0.00425
apify-actor-start：実行開始ごと	$0.002	$0.002	$0.002	$0.002

無料行：結果がない実行では理由を示す無料行が 1 行書き込まれ、拒否された入力では、error_reason が input_invalid: で始まる無料行が 1 行書き込まれます。

キー

キーは不要です。ご自身の YouTube Data API キーは任意です。このサーバーの環境で YOUTUBE_API_KEY を設定すると、youtube_api_key としてアクターに渡されるため、キーが会話に含まれることはありません。このキーを使うと、アクターはニッチ分野のチャンネルを YouTube で検索し、各チャンネルのアップロード動画を最大 50 件読み込みます。

アクターの詳細なドキュメント

apify.com/mambalabs/brand-sponsor-finder

ライセンス

MIT。詳細は LICENSE をご覧ください。