mcp-creator-profile-reader について
mcp-creator-profile-readerは、Apify上のMamba Labs Influencer Profile Scraper actorを使うMCPサーバーです。指定したクリエイターの情報が必要なチーム向けで、ハンドルやプロフィールURLから7つのプラットフォームの公開プロフィールを読み取ります。検索機能はありません。
主な機能
- 01ハンドルやURLからプロフィールを取得
- 027つのクリエイタープラットフォームに対応
- 03フォロワー数、自己紹介、リンクを取得
- 04エンゲージメント率と認証状態を取得
- 05取得できない場合に状態と理由を返却
活用シーン
- 01キャンペーン候補の公開プロフィール確認
- 02ハンドル一覧からクリエイター指標を整理
- 03クリエイターの自己紹介からリンクを取得
MCP 対応
MCPサーバーとして、MCPクライアントにread_influencer_profilesツールを提供し、Apify上のMamba Labs Influencer Profile Scraper actorを呼び出します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
1掲載時のツール一覧 · 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` が必要で、指定した各プラットフォームで検索されます。1 件なら単独実行、複数件なら一括処理されます。取得前に重複は削除されます。 |
| us_only | boolean | いいえ | ローンチ対象は米国のクリエイターです。country_guess が既知の米国以外の国を示す行は、その旨を記載したエラー行として返されます。国を示す情報がない行は保持されます。チェックを外すと、すべての国のクリエイターが保持されます。デフォルト:true。 |
| platforms | array | いいえ | @handle のみを指定した場合に検索するプラットフォームです。完全なプロフィール URL にはプラットフォーム情報が含まれるため、この設定は無視されます。この actor は検索を行いません。読み取り対象のクリエイターを渡してください。対応:TikTok、Instagram、YouTube、Pinterest、Twitch、Threads、ポッドキャスト。X、Facebook ページ、LinkedIn には対応していません。 |
| batch_size | integer | いいえ | 一度に取得する行数です。空欄の場合は、プラットフォームごとに実測されたデフォルト値を使用します。測定値は README に記載されています。値を大きくすると高速になりますが、実測値を超えると取得行数が減ります。 |
| twitch_app_token | string | いいえ | 任意。Twitch client id 用のアプリアクセストークン(client credentials フロー)です。Twitch の読み取りにのみ使用され、保存もログ記録もされません。 |
| twitch_client_id | string | いいえ | 任意。登録済みの独自 Twitch アプリの client id です。`twitch_app_token` と併用すると、Twitch の読み取りに公開 Web エンドポイントではなく公式 Helix API を使用します。Mamba Labs の認証情報ではありません。 |
| escalate_on_block | boolean | いいえ | デフォルトで有効です。プロフィール取得結果がボット検出ページだった場合、住宅用プロキシ経由で 1 回再試行します。Instagram では、埋め込みデータとデータセンター API にプロフィール文、プロフィールリンク、フォロー数が含まれていない場合、住宅用ネットワーク経由でプロフィールページから読み取ります。ページを読み取れた場合は instagram-bio-fetch($0.010)が課金されます。チェックを外すと、このイベントの料金は発生しません。ブロックされたプロフィールは、ラベル付きのエラー行として返されます。Instagram の行の約半数ではプロフィール文とプロフィールリンクが空になります。デフォルト:true。 |
| max_residential_reads | integer | いいえ | 1回の実行で住宅プロキシ経由で読み取る Instagram プロフィールページ数の上限です。読み取り可能なページごとに instagram-bio-fetch が $0.01 課金されます。0 は上限なしを意味します。上限に達すると、後続の Instagram 行には埋め込みウィジェットとデータセンター API が返した内容のみが残り、error_reason は escalation_skipped となります。escalate_on_block が有効な場合にのみ適用されます。デフォルト:0。 |
| contribute_to_shared_pool | boolean | いいえ | デフォルトで有効です。この actor の全ユーザーが参照する共有クリエイター・エージェンシープールに、今回の実行で見つかった公開記録を提供します。これにより、後続の実行で今回見つかった情報を読み取れます。送信されるのは返された行にすでに含まれる公開データのみで、Apify アカウント、入力リスト、API キーは送信されません。データ提供は課金されません。false にすると、プールを読み取りますが書き込みません。デフォルト:true。 |
詳細
インフルエンサープロフィールスクレイパー MCP サーバー
Apify 上の Mamba Labs のインフルエンサープロフィールスクレイパーアクター用の MCP サーバーです。
クリエイターのハンドル名またはプロフィール URL を入力すると、クリエイターごとに 1 行のプロフィールデータが出力されます。
インストール
npx -y @mambalabsdev/mcp-creator-profile-reader
Claude Desktop
{
"mcpServers": {
"mamba-creator-profile-reader": {
"command": "npx",
"args": ["-y", "@mambalabsdev/mcp-creator-profile-reader"],
"env": { "APIFY_TOKEN": "your-apify-token" }
}
}
}
console.apify.com/account/integrationsで Apify トークンを取得してください。
ツール
read_influencer_profiles
7 つのプラットフォームで、ハンドル名を指定してインフルエンサーのプロフィールを読み取ります。フォロワー数、エンゲージメント、自己紹介、自己紹介のリンクを取得します。
| Input | Type | Required | Notes |
|---|---|---|---|
handles | array | no | 1 行につき 1 つ指定します。サポート対象のいずれかのプラットフォームのプロフィール URL(https://www.tiktok.com/@name、https://www.instagram.com/name/、https://www.youtube.com/@name、Pinterest、Twitch、Threads のプロフィール、または Apple Podcasts の番組)を指定します。 |
platforms | array | no | @ハンドル名だけを指定した場合に検索するプラットフォームです。プロフィール URL を指定すると、その URL からプラットフォームが判別され、この項目は無視されます。このアクターは検索しません。読み取りたいクリエイターを指定してください。サポート対象:TikTok、Instagram、YouTube、。 |
us_only | boolean | no | 対象は米国のクリエイターです。country_guess が既知の米国以外の国を示す行は、その旨を示すエラー行として返されます。国を示す情報がない行はそのまま残ります。すべての国を対象にするには、チェックを外してください。デフォルトは true です。 |
escalate_on_block | boolean | no | デフォルトで有効です。プロフィールの取得結果がボット検出ページだった場合、住宅用プロキシ経由で 1 回再試行します。Instagram では、該当時、プロフィールページから自己紹介、自己紹介のリンク、フォロー中の情報を住宅用プロキシ経由で読み取ります。デフォルトは true です。 |
max_residential_reads | integer | no | 1 回の実行で住宅用プロキシ経由で読み取る Instagram のプロフィールページ数の上限です(読み取り可能なページごとに instagram-bio-fetch が課金されます)。0 は上限なしを意味します。escalate_on_block が有効な場合にのみ適用されます。デフォルトは 0 です。 |
batch_size | integer | no | 一度に取得する行数です。空欄にすると、プラットフォームごとに計測されたデフォルト値が使われます。計測値は README に記載されています。値を大きくすると高速になりますが、計測値を超えると取得できる行数が減ります。 |
twitch_client_id | string | no | 任意です。登録済みのご自身の Twitch アプリケーションのクライアント ID です。twitch_app_token と併用すると、Twitch の読み取りに公開ウェブエンドポイントではなく公式 Helix API が使われます。Mamba Labs の認証情報ではありません。 |
twitch_app_token | string | no | 任意です。ご自身の Twitch クライアント ID のアプリアクセストークンです(クライアント認証情報フロー)。Twitch の読み取りにのみ使用され、保存もログへの記録もされません。 |
contribute_to_shared_pool | boolean | no | デフォルトで有効です。この実行で見つかった公開レコードを、すべてのユーザーがこのアクターから読み取る共有クリエイター・エージェンシープールに提供します。返される行にすでに含まれる公開データのみが送信され、提供に料金はかかりません。プールからの読み取りのみを行い、書き込みをしない場合は false に設定してください。デフォルトは true です。 |
max_charge_usd | number | no | 任意です。この実行の米ドル建て料金上限です。料金がこの金額を超える可能性のある項目を処理する前に、アクターは停止します。省略すると、Apify で設定された 1 回の実行あたりの最大料金が適用されます。 |
必須項目はありません。使用可能な入力がない状態で実行された場合、Influencer Profile Scraper は失敗する代わりに、row_status と error_reason を含む行を返します。このツールも同様に動作します。
料金
Influencer Profile Scraper は、Apify でイベントごとの従量課金制です。以下の料金は、FREE、BRONZE、SILVER、GOLD、PLATINUM、DIAMOND のすべてのティアで一律です。
| Event | Charged for | Price | Fires when |
|---|---|---|---|
actor-start | アクターの開始 | $0.001 | 1 回の実行につき開始時に 1 回。実行にかかる基本料金です。 |
apify-actor-start | Apify アクターの開始 | 課金対象外 | Apify の合成開始イベントです。このアクターでは代わりに独自の actor-start イベントに料金を設定しているため、apify-actor-start が追加で課金されることはありません。 |
profile-read | プロフィールの読み取り | $0.006 | 公開プロフィールページが読み取られ、フォロワー数または自己紹介の少なくとも一方が取得できたプロフィール行ごとに 1 回。非公開、存在しない、またはブロックされたプロフィールは、説明付きのエラー行を返し、課金されません。 |
instagram-bio-fetch | Instagram の自己紹介の取得 | $0.01 | Instagram のプロフィール行ごとに、自己紹介、自己紹介のリンク、フォロー中の情報が埋め込みウィジェットにもデータセンター API にもなく、プロフィールページを住宅用プロキシ経由で読み取って正常に取得できた場合に 1 回。escalate_on_block が有効な場合のみ適用されます。埋め込みウィジェットまたはデータセンター経由の読み取り、他のプラットフォーム、ブロックされたページ、エラー行では課金されません。 |
出力の読み方
各行には row_status と error_reason が含まれます。アクターが読み取れなかったクリエイターは、リストから抜け落ちるのではなく、理由を示す行として返されるため、データの欠落を推測する必要はありません。テーブルを読み込む前に row_status でフィルタリングしてください。
このアクターが共有する内容
実行によって見つかったレコードは、すべてのユーザーが読み取れる共有クリエイター・エージェンシープールに追加されます。ある実行で見つかった情報は、次の実行で読み取れます。
切り替え設定は contribute_to_shared_pool です。デフォルトでオンになっています。false に設定すると、実行は引き続きプールを読み取りますが、プールへの書き込みは行いません。
このアクターが共有する内容。 読み取った各クリエイターのプロフィール行です。プラットフォーム、ハンドル、表示名、フォロワー数、自己紹介、自己紹介のリンク、公開されているビジネス用メールアドレス、エンゲージメント率、認証済みフラグ、読み取り日が含まれます。
お客様自身の出力にすでに含まれている公開データのみ。 プールに書き込まれる各フィールドは、この実行が返したものであり、ログインしなくても誰でも閲覧できる、プラットフォームまたはクリエイターが公開しているページから読み取ったものです。お客様の Apify アカウント、入力リスト、API キー、個人的なメモから情報が送信されることはありません。共有によってプール内の情報が削除されることはありません。
共有データに付与されるラベル。 アクター ID、実行 ID、アクターのビルドに発行されたプールキー、レート制限のためだけに使用される呼び出し元 IP アドレスのハッシュです。お客様の Apify アカウントとユーザー ID は記録されません。
共有は無料です。 プールへの書き込みに料金は発生しません。プールに接続できない場合も実行は通常どおり完了し、行は破棄され、その旨が実行ログに記録されます。
アクター
アクター ID は EqEnklDVMIcB1V499 です。ラッパーは 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 が開発しました。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。