mcp-talent-agency-lookup

インフルエンサー人材エージェンシー検索 MCP サーバー

Apify 上の Mamba Labs インフルエンサー人材エージェンシー検索アクター用の MCP サーバーです。

クリエイターのハンドルを入力すると、それぞれを担当する人材エージェンシーが出力されます。または、エージェンシーを入力すると、その公開クリエイター名簿が出力されます。

インストール

npx -y @mambalabsdev/mcp-talent-agency-lookup

Claude Desktop

{
  "mcpServers": {
    "mamba-talent-agency-lookup": {
      "command": "npx",
      "args": ["-y", "@mambalabsdev/mcp-talent-agency-lookup"],
      "env": { "APIFY_TOKEN": "your-apify-token" }
    }
  }
}

Apify トークンは、console.apify.com/account/integrationsで取得できます。

ツール

ツール	方向	入力
lookup_agency_for_creator	クリエイターからエージェンシー：クリエイターごとに、その担当エージェンシーを示す1行	handles、platforms、escalate_on_block、batch_size、contribute_to_shared_pool
list_agency_roster	エージェンシーから名簿：エージェンシーの公開名簿に掲載されたクリエイターごとに1行	agency_domains、agency_names、render_unreadable_pages、contribute_to_shared_pool
lookup_influencer_talent_agency	1回の呼び出しで両方の方向に対応し、すべてのアクター入力を使用	以下のすべての入力

3つのツールはいずれも同じアクターを呼び出すため、以下の料金はすべてに適用されます。片方の方向だけが必要な場合は、2つの方向別ツールを選ぶとより簡単です。既存の呼び出し元との互換性を保つため、統合ツールも引き続き提供しています。

入力

入力	型	必須	備考
handles	array	いいえ	1 行につき 1 件です。サポートされているプラットフォーム上のプロフィール URL（https://www.tiktok.com/@name、https://www.instagram.com/name/、https://www.youtube.com/@name、Pinterest、Twitch、Threads のプロフィール、Apple Podcasts の番組ページ、または Spotify の番組）、または platform:@handle（tiktok:@name）を指定します。@handle のみを指定する場合は platforms が必要で、指定された各プラットフォームで検索されます。単一のエントリは単独実行、リストは一括実行になります。取得前に重複は削除されます。
platforms	array	いいえ	@handle のみを指定した場合に検索するプラットフォームです。完全なプロフィール URL にはプラットフォーム情報が含まれるため、この設定は無視されます。このアクターは検索を行いません。読み取りたいクリエイターを指定してください。対応しているのは TikTok、Instagram、YouTube、Pinterest、Twitch、Threads、ポッドキャストです。X、Facebook ページ、LinkedIn には対応していません。
agency_domains	array	いいえ	エージェンシーのロースターを取得します。1 行につきドメインを 1 つ指定します（例：viralnation.com）。エージェンシーが公開しているロースターに掲載されたクリエイターごとに 1 行を返します。
agency_names	array	いいえ	ドメインがわからない場合に、名前でエージェンシーのロースターを取得します。リスト内の名前と完全一致または部分一致で照合します。
render_unreadable_pages	boolean	いいえ	デフォルトではオフです。一部のエージェンシーのロースターページは、ブラウザーでタレント一覧を生成するため、通常の取得では空のシェルが返され、ロースターが空として読み取られることがあります。これをオンにすると、ヘッドレスブラウザーでページをレンダリングし、レンダリング後のページからロースターを読み取ります。ブラウザーの計算コストをまかなうため、レンダリングしたページごとに課金されます（イベント browser-render）。また、レンダリング後に読み取り可能なページが返された場合にのみ課金されます。ボット対策のチャレンジが返されたページはブロックとして記録され、レンダリングされません。デフォルトは false です。
escalate_on_block	boolean	いいえ	デフォルトではオンです。プロフィールの取得でボット検出ページが返された場合、住宅用プロキシ経由で 1 回再試行します。Instagram では、埋め込みデータとデータセンター API にプロフィール文、プロフィールリンク、フォロー中の情報が含まれていない場合、住宅用プロキシ経由でプロフィールページからこれらを読み取ります。読み取り可能なページが返された場合は instagram-bio-fetch（$0.010）が課金されます。この設定をオフにすると、このイベントによる課金は発生しません。その場合、ブロックされたプロフィールはエラーであることを示す行を返し、Instagram の行の約半数ではプロフィール文とプロフィールリンクが空のままになります。デフォルトは true です。
batch_size	integer	いいえ	一度に取得する行数です。プラットフォームごとに測定されたデフォルト値を使用するには、空欄のままにしてください。測定値はアクターの READMEに記載されています。値を大きくすると高速になりますが、測定値を超えると取得できない行が発生します。
contribute_to_shared_pool	boolean	いいえ	デフォルトではオンです。この実行で見つかった公開レコードは、アクターの全ユーザーが読み取れるクリエイターとエージェンシーの共有プールに追加され、後続の実行で今回のデータを読み取れるようになります。送信されるのは、すでに自分の出力行に含まれている公開データのみです。Apify アカウントの情報、入力リスト、API キー、個人のメモは送信されません。データの提供に課金はありません。オフにしても、実行では共有プールを読み取りますが、データは書き込みません。デフォルト：true。
max_charge_usd	number	いいえ	この呼び出しに対する任意の支出上限（米ドル）です。この金額を超える課金が発生する前にアクターが停止し、それまでに課金されたすべての行が保持されます。

必須項目はありませんが、handles、agency_domains、agency_names がすべて未指定の場合は検索対象がなく、実行はその旨を示すメッセージとともに失敗します。

料金

Influencer Talent Agency Lookup は、Apify の従量課金制です。以下の料金はすべて、FREE、BRONZE、SILVER、GOLD、PLATINUM、DIAMOND の各ティアで一律です。

イベント	課金対象	料金	発生タイミング
actor-start	Actor の起動	$0.001	1 回の実行につき 1 回、起動時に発生します。実行にかかる基本コストをカバーします。
agency-lookup	エージェンシーの検索	$0.008	タレントエージェンシーの検索で返された行ごとに 1 回、どちらの方向（クリエイターからエージェンシー、またはエージェンシーから所属クリエイター）でも発生します。
browser-render	ブラウザーでのレンダリング	$0.004	通常の取得で空のシェルが返されたため、ヘッドレスブラウザーでエージェンシーの所属者一覧ページをレンダリングし、レンダリング後に読み取り可能なページが返された場合に限り、ページごとに 1 回発生します。render_unreadable_pages がオンの場合のみ発生します。
instagram-bio-fetch	Instagram プロフィール情報の取得	$0.01	Instagram プロフィールの行ごとに 1 回、住宅用プロキシ経由でプロフィールページから自己紹介、自己紹介のリンク、フォロー中のアカウント数を読み取り、読み取り可能なデータが返された場合に発生します。escalate_on_block がオンの場合のみ発生します。

Apify が従量課金制のアクターにデフォルトで追加する起動イベント apify-actor-start は、このアクターの料金設定には含まれていません。実行の基本コストは、上記のアクター独自の actor-start イベントを通じて、実行ごとに 1 回、$0.001 で課金されます。そのため、実行の起動に対して二重に課金されることはありません。

出力の読み方

すべての行には agency_match_method が含まれます。値は email_domain_exact、email_domain_parent、public_roster、bio_wording、no_match のいずれかです。no_match の行には、試したメールドメインが error_reason に記載されます。また、すべての行には row_status と error_reason も含まれるため、アクターが読み取れなかったクリエイターやエージェンシーも、一覧から抜け落ちるのではなく、その理由を示す行として返されます。テーブルに読み込む前に row_status でフィルターしてください。

データの網羅性は、仕組み上、限定的です。アクター公開時点で同梱リストには、13 の公開ディレクトリを元にした 143 のエージェンシーと 557 人の所属クリエイターが登録されており、共有プールを通じて増加します。

このアクターが共有する情報

この実行で見つかったレコードは、すべてのユーザーが読み取る共有クリエイター・エージェンシープールに追加されます。ある実行で見つかった情報は、次の実行で読み取ることができます。

このアクターは、ほかの情報を読み取る前にプールを読み取ります。プールにアクセスできない場合は、ビルドに同梱されたエージェンシーリストにフォールバックするため、プールが原因で実行が失敗することはありません。

切り替えには contribute_to_shared_pool を使います。これはブール型の入力で、デフォルトでオンです。オフにしても実行はプールを読み取りますが、プールには何も書き込みません。

このアクターが追加する情報。 実行中に読み取ったエージェンシーの行と所属者の行です。エージェンシー名、ドメイン、公開連絡先、国、分類、所属者一覧の URL と、プラットフォームおよびハンドルを含むクリエイターごとの所属者行が含まれます。

公開情報のみで、すでに自身の出力に含まれている情報です。 プールに書き込まれる各フィールドは、この実行が返したもので、プラットフォームまたはクリエイターがログインなしで誰でも閲覧できるページから読み取った情報です。Apify アカウント、入力リスト、API キー、自身のメモから情報が送信されることはありません。追加によってプール内の情報が削除されることはありません。

追加情報に付与されるラベル。 アクター ID、実行 ID、アクターのビルドに発行されたプールキー、および呼び出し元の IP アドレスのハッシュです。ハッシュはレート制限にのみ使用されます。Apify アカウントとユーザー ID は記録されません。

追加は無料です。 プールへの書き込みに対するイベント課金はありません。プールにアクセスできない場合、実行は通常どおり完了し、行は破棄され、その旨が実行ログに記録されます。

Actor

Actor ID は zCuX4Mgyg6JvXgGzd です。ラッパーは Store のスラッグではなく、この不変の ID でアクターを呼び出すため、Store の名前を変更しても動作に影響しません。

スイート

アクター	アクター ID	MCP サーバー
インフルエンサー検索	tpkedmloIIWtXx6sg	@mambalabsdev/mcp-creator-finder
インフルエンサーのプロフィールスクレイパー	EqEnklDVMIcB1V499	@mambalabsdev/mcp-creator-profile-reader
プロフィールリンクスクレイパーとニュースレター検出ツール	OorucdheTIgu7RFzK	@mambalabsdev/mcp-link-in-bio-newsletter-checker
インフルエンサー変更モニター	d2VVgahNL6UmcLkhg	@mambalabsdev/mcp-creator-change-monitor
インフルエンサーリードリスト作成ツール	KnmByszcv135yM30G	@mambalabsdev/mcp-creator-lead-list-all-in-one
インフルエンサー人材事務所検索	zCuX4Mgyg6JvXgGzd	@mambalabsdev/mcp-talent-agency-lookup

Mamba Labs が開発しました。