mcpField
M
mcp-creator-profile-reader

mcp-creator-profile-reader

ローカル
github.com/mambalabsdevソーシャルメディア01 週間前に更新

mcp-creator-profile-reader について

mcp-creator-profile-readerは、Apify上のMamba Labs Influencer Profile Scraper actorを使うMCPサーバーです。指定したクリエイターの情報が必要なチーム向けで、ハンドルやプロフィールURLから7つのプラットフォームの公開プロフィールを読み取ります。検索機能はありません。

主な機能

  1. 01ハンドルやURLからプロフィールを取得
  2. 027つのクリエイタープラットフォームに対応
  3. 03フォロワー数、自己紹介、リンクを取得
  4. 04エンゲージメント率と認証状態を取得
  5. 05取得できない場合に状態と理由を返却

活用シーン

  1. 01キャンペーン候補の公開プロフィール確認
  2. 02ハンドル一覧からクリエイター指標を整理
  3. 03クリエイターの自己紹介からリンクを取得

MCP 対応

MCPサーバーとして、MCPクライアントにread_influencer_profilesツールを提供し、Apify上のMamba Labs Influencer Profile Scraper actorを呼び出します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"com-mambabuilt-mcp-creator-profile-reader": {
"command": "npx",
"args": [
"-y",
"@mambalabsdev/mcp-creator-profile-reader"
],
"env": {
"APIFY_TOKEN": "<APIFY_TOKEN>"
}
}
}
}
起動コマンドnpx -y @mambalabsdev/mcp-creator-profile-reader
設定が必要な環境変数
APIFY_TOKENシークレットApify API token from https://console.apify.com/account/integrations

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@mambalabsdev/mcp-creator-profile-reader1.2.0

ツール

1

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
handlesarrayいいえ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_onlybooleanいいえローンチ対象は米国のクリエイターです。country_guess が既知の米国以外の国を示す行は、その旨を記載したエラー行として返されます。国を示す情報がない行は保持されます。チェックを外すと、すべての国のクリエイターが保持されます。デフォルト:true。
platformsarrayいいえ@handle のみを指定した場合に検索するプラットフォームです。完全なプロフィール URL にはプラットフォーム情報が含まれるため、この設定は無視されます。この actor は検索を行いません。読み取り対象のクリエイターを渡してください。対応:TikTok、Instagram、YouTube、Pinterest、Twitch、Threads、ポッドキャスト。X、Facebook ページ、LinkedIn には対応していません。
batch_sizeintegerいいえ一度に取得する行数です。空欄の場合は、プラットフォームごとに実測されたデフォルト値を使用します。測定値は README に記載されています。値を大きくすると高速になりますが、実測値を超えると取得行数が減ります。
twitch_app_tokenstringいいえ任意。Twitch client id 用のアプリアクセストークン(client credentials フロー)です。Twitch の読み取りにのみ使用され、保存もログ記録もされません。
twitch_client_idstringいいえ任意。登録済みの独自 Twitch アプリの client id です。`twitch_app_token` と併用すると、Twitch の読み取りに公開 Web エンドポイントではなく公式 Helix API を使用します。Mamba Labs の認証情報ではありません。
escalate_on_blockbooleanいいえデフォルトで有効です。プロフィール取得結果がボット検出ページだった場合、住宅用プロキシ経由で 1 回再試行します。Instagram では、埋め込みデータとデータセンター API にプロフィール文、プロフィールリンク、フォロー数が含まれていない場合、住宅用ネットワーク経由でプロフィールページから読み取ります。ページを読み取れた場合は instagram-bio-fetch($0.010)が課金されます。チェックを外すと、このイベントの料金は発生しません。ブロックされたプロフィールは、ラベル付きのエラー行として返されます。Instagram の行の約半数ではプロフィール文とプロフィールリンクが空になります。デフォルト:true。
max_residential_readsintegerいいえ1回の実行で住宅プロキシ経由で読み取る Instagram プロフィールページ数の上限です。読み取り可能なページごとに instagram-bio-fetch が $0.01 課金されます。0 は上限なしを意味します。上限に達すると、後続の Instagram 行には埋め込みウィジェットとデータセンター API が返した内容のみが残り、error_reason は escalation_skipped となります。escalate_on_block が有効な場合にのみ適用されます。デフォルト:0。
contribute_to_shared_poolbooleanいいえデフォルトで有効です。この actor の全ユーザーが参照する共有クリエイター・エージェンシープールに、今回の実行で見つかった公開記録を提供します。これにより、後続の実行で今回見つかった情報を読み取れます。送信されるのは返された行にすでに含まれる公開データのみで、Apify アカウント、入力リスト、API キーは送信されません。データ提供は課金されません。false にすると、プールを読み取りますが書き込みません。デフォルト:true。

詳細

インフルエンサープロフィールスクレイパー MCP サーバー

Smithery Glama score MCP Registry npm version npm downloads license mcpservers.org

Creator Profile Reader MCP server

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 つのプラットフォームで、ハンドル名を指定してインフルエンサーのプロフィールを読み取ります。フォロワー数、エンゲージメント、自己紹介、自己紹介のリンクを取得します。

InputTypeRequiredNotes
handlesarrayno1 行につき 1 つ指定します。サポート対象のいずれかのプラットフォームのプロフィール URL(https://www.tiktok.com/@name、https://www.instagram.com/name/、https://www.youtube.com/@name、Pinterest、Twitch、Threads のプロフィール、または Apple Podcasts の番組)を指定します。
platformsarrayno@ハンドル名だけを指定した場合に検索するプラットフォームです。プロフィール URL を指定すると、その URL からプラットフォームが判別され、この項目は無視されます。このアクターは検索しません。読み取りたいクリエイターを指定してください。サポート対象:TikTok、Instagram、YouTube、。
us_onlybooleanno対象は米国のクリエイターです。country_guess が既知の米国以外の国を示す行は、その旨を示すエラー行として返されます。国を示す情報がない行はそのまま残ります。すべての国を対象にするには、チェックを外してください。デフォルトは true です。
escalate_on_blockbooleannoデフォルトで有効です。プロフィールの取得結果がボット検出ページだった場合、住宅用プロキシ経由で 1 回再試行します。Instagram では、該当時、プロフィールページから自己紹介、自己紹介のリンク、フォロー中の情報を住宅用プロキシ経由で読み取ります。デフォルトは true です。
max_residential_readsintegerno1 回の実行で住宅用プロキシ経由で読み取る Instagram のプロフィールページ数の上限です(読み取り可能なページごとに instagram-bio-fetch が課金されます)。0 は上限なしを意味します。escalate_on_block が有効な場合にのみ適用されます。デフォルトは 0 です。
batch_sizeintegerno一度に取得する行数です。空欄にすると、プラットフォームごとに計測されたデフォルト値が使われます。計測値は README に記載されています。値を大きくすると高速になりますが、計測値を超えると取得できる行数が減ります。
twitch_client_idstringno任意です。登録済みのご自身の Twitch アプリケーションのクライアント ID です。twitch_app_token と併用すると、Twitch の読み取りに公開ウェブエンドポイントではなく公式 Helix API が使われます。Mamba Labs の認証情報ではありません。
twitch_app_tokenstringno任意です。ご自身の Twitch クライアント ID のアプリアクセストークンです(クライアント認証情報フロー)。Twitch の読み取りにのみ使用され、保存もログへの記録もされません。
contribute_to_shared_poolbooleannoデフォルトで有効です。この実行で見つかった公開レコードを、すべてのユーザーがこのアクターから読み取る共有クリエイター・エージェンシープールに提供します。返される行にすでに含まれる公開データのみが送信され、提供に料金はかかりません。プールからの読み取りのみを行い、書き込みをしない場合は false に設定してください。デフォルトは true です。
max_charge_usdnumberno任意です。この実行の米ドル建て料金上限です。料金がこの金額を超える可能性のある項目を処理する前に、アクターは停止します。省略すると、Apify で設定された 1 回の実行あたりの最大料金が適用されます。

必須項目はありません。使用可能な入力がない状態で実行された場合、Influencer Profile Scraper は失敗する代わりに、row_status と error_reason を含む行を返します。このツールも同様に動作します。

料金

Influencer Profile Scraper は、Apify でイベントごとの従量課金制です。以下の料金は、FREE、BRONZE、SILVER、GOLD、PLATINUM、DIAMOND のすべてのティアで一律です。

EventCharged forPriceFires when
actor-startアクターの開始$0.0011 回の実行につき開始時に 1 回。実行にかかる基本料金です。
apify-actor-startApify アクターの開始課金対象外Apify の合成開始イベントです。このアクターでは代わりに独自の actor-start イベントに料金を設定しているため、apify-actor-start が追加で課金されることはありません。
profile-readプロフィールの読み取り$0.006公開プロフィールページが読み取られ、フォロワー数または自己紹介の少なくとも一方が取得できたプロフィール行ごとに 1 回。非公開、存在しない、またはブロックされたプロフィールは、説明付きのエラー行を返し、課金されません。
instagram-bio-fetchInstagram の自己紹介の取得$0.01Instagram のプロフィール行ごとに、自己紹介、自己紹介のリンク、フォロー中の情報が埋め込みウィジェットにもデータセンター 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 の名前を変更しても動作に影響しません。

スイート

アクターアクター IDMCP サーバー
インフルエンサー検索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 が開発しました。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。