mcp-x-brand-presence-mapper

X Twitter ブランドプレゼンスマッパー MCP サーバー

企業ドメインから、その企業の X（Twitter）ハンドル、プロフィール URL、フォロワー指標を特定する MCP サーバーです。Apify 上の Mamba Labs X Twitter Brand Presence Mapper アクターをラップし、MCP クライアントに Clay 対応のフラットな JSON 行を返します。

内容

• 機能
• クイックスタート
• 前提条件
• プロンプトの例
• 入力
• 出力
• 出力例
• 機能
• 料金
• アクターの完全なドキュメント
• Mamba Labs GTM Suite
• ライセンス

機能

企業ドメインを指定すると、その企業の公式 X ハンドルとプロフィール URL が返されます。X から取得できる場合は、フォロワー数、フォロー数、投稿数、認証状況、プロフィール、アカウント作成日も返します。企業ごとにフラットな行が 1 つ返されます。

初期設定のまま、キーなしで実行できます。X は公開ルートに対して厳しいレート制限を設けているため、大量のバッチでは、一部の行でハンドルと URL は入力されても、件数は not_extractable として表示されることがあります。独自の X API ベアラートークンを指定すればこの制限がなくなり、どのようなバッチサイズでも完全な指標が返されます。キーはツールのロックを解除するのではなく、機能の有効性を高めます。

推測されたハンドルが本人確認に失敗した場合、企業のハンドルとして返すのではなく、identity_mismatch として報告されます。検索はすべて Apify 上で実行されます。このパッケージは、アクターを呼び出して結果を変更せずに返す薄いクライアントです。

クイックスタート

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

Claude Desktop の設定に以下を追加します。

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

https://console.apify.com/account/integrations でトークンを取得して貼り付け、Claude Desktop を再起動してください。map_x_brand_presence ツールが利用可能になります。

前提条件

• Node.js 18 以降
• API トークンを持つ Apify アカウント
• 任意：大量のバッチで完全な指標を取得したい場合は、developer.x.com で無料で作成できる独自の X API v2 ベアラートークン

プロンプトの例

• 「shopify.com の X アカウントを調べて、フォロワー数を教えてください。」
• 「stripe.com の X ハンドルは何ですか？また、アカウントはいつ作成されましたか？」
• 「フォロワー数を取得せずに、figma.com の X プロフィール URL を特定してください。」
• 「Shopify の X ハンドルを調べて、プロフィールと投稿数を返してください。」

入力

• company_domain（任意）：shopify.com のような、会社のドメインのみを指定します。これを指定するか、ハンドルを指定してください。ドメインを指定するとアクターは完全な検出を実行し、ハンドルを指定すると取得処理に直接進みます。
• company_name（任意）：検索精度が向上します。また、検出されたプロフィールが該当するかどうかをアイデンティティゲートが確認する際に使われるため、指定すると誤一致を減らせます。
• handle（任意）：先頭の @ の有無を問わず、Shopify のような X ハンドルを指定します。指定すると検出をスキップし、取得処理に直接進みます。
• includeFollowerCounts（任意）：true の場合（デフォルト）、プロフィールページを取得して数値を抽出します。プロフィール URL の解決のみを行うには false に設定してください。こちらのほうが低コストで、プロキシも不要です。
• skipCache（任意）：false の場合（デフォルト）、成功した検索結果は7日間キャッシュされ、再利用されます。最新の情報を取得するには true に設定してください。
• xApiBearerToken（任意）：独自の X API v2 ベアラートークンを指定します。developer.x.com で無料で作成できます。トークンがなくても、このツールはハンドル、プロフィール URL、フォロワー数を解決しますが、X は公開ルートにレート制限を設けているため、大規模なバッチでは一部の行が数値ではなく not_extractable を返します。トークンは実行時にのみ使用され、保存も他の実行との共有もされません。
• max_charge_usd（任意）：この呼び出しの USD 建ての支出上限です。実行がこの金額を超える料金が発生する前にアクターが停止し、すでに課金されたすべての行は保持されます。

company_domain または handle のいずれかを指定してください。

出力

このツールは、会社ごとのフラットな JSON 行を返します。フィールドは snake_case 形式の18個で、ネストされたオブジェクトはありません。まず x_status を確認してください。ok、not_found、not_extractable、identity_mismatch はそれぞれ異なる結果であり、ラッパーがこれらをひとまとめにすることはありません。x_fetch_route は数値の取得に使われたルートを示し、x_discovery はハンドルの検出方法を示します。出力スキーマの全容は Apify Store ページを参照してください。

出力例

{
  "degraded": false,
  "degradation_reason": null,
  "company_domain": "shopify.com",
  "company_name": "Shopify",
  "x_url": "https://x.com/Shopify",
  "x_handle": "Shopify",
  "x_followers": 452243,
  "x_followers_exact": true,
  "x_following": 3423,
  "x_tweet_count": 37167,
  "x_verified": false,
  "x_display_name": "Shopify",
  "x_bio": "The entrepreneurship company",
  "x_created_at": "2008-11-03T18:33:14.000Z",
  "x_fetch_route": "syndication",
  "x_discovery": "homepage_sameas",
  "x_status": "ok",
  "run_date": "2026-08-22T19:23:45.055Z"
}

機能

• 会社のドメインを起点に、公式 X ハンドルとプロフィール URL を解決します
• フォロワー数、フォロー数、投稿数に加え、認証ステータスも取得します
• アカウント作成日、自己紹介、表示名を取得します
• キーなしで実行でき、大規模利用向けに独自の X API キーも使用できます
• ホームページの sameAs マークアップを使って、ドメインを起点にまず検出します
• 各行の取得ルートを x_fetch_route で報告します
• 会社ごとに1行、フラットな snake_case 形式のフィールドを18個返します

料金

Apify のイベントごとに課金され、料金はお客様自身の Apify アカウントに請求されます。以下はライブの料金記録に基づく価格です（2026-10-16 時点）。

イベント	イベントごとの料金（USD）	発生条件
apify-actor-start	$0.00005	アクターの実行開始時に課金されます。課金されるイベント数はアクターのメモリ量に応じて決まります（1 GB あたり1イベント、最低1イベント）。
company-checked	Free プランでは $0.0035、上位の Apify プランでは最大 $0.00245	検出カスケードが完了し、劣化していない行が生成された会社ごとに1回発生します。X アカウントが見つかったかどうかは問いません。劣化した行では検出が行われないため、このイベントは発生しません。
profile-resolved	Free プランでは $0.003、上位の Apify プランでは最大 $0.0021	候補となる X URL がアイデンティティゲートを通過した会社ごとに1回発生します。数値が入力された時点ではなく、検証処理に対して発生します。ハンドルの解決は X が数値を提供したかどうかにかかわらず成功するため、キーなしモードでアクターに課金されるイベントはこれです。
follower-count-extracted	Free プランでは $0.0025、上位の Apify プランでは最大 $0.00175	どちらのルートからであっても、数値のフォロワー数を実際に読み取れた会社ごとに1回発生します。レート制限された行では発生せず、数値の取得に対する課金もありません。not_extractable という文字列に対してイベントを発生させて課金することを避けるための仕様です。

現在の料金はアクターの Apify ページで確認できます。このサーバーを実行すると Apify クレジットを消費します。

アクターの完全なドキュメント

このサーバーは薄いクライアントであり、ルックアップのロジックは保持していません。入力と出力の完全なリファレンス、料金、実行履歴については、Apify Store のページをご覧ください。

https://apify.com/mambalabs/x-brand-presence-mapper

---

Mamba Labs GTM Suite

このサーバーは、Mamba Labs GTM Suite の MCP サーバーの1つです。このスイート内の各アクターは、ドメインまたは企業を入力として受け取り、単一のフラットな行を返すため、データの形を整え直さなくても同じ Clay テーブルに積み重ねられます。このサーバーの背後で動作するアクターは X Twitter Brand Presence Mapper で、変更不可能な Apify アクター ID は oLOgadhHUkNAyDA3w です。

Mamba Labs が開発 | npm | Apify Store

ライセンス

MIT

Mamba Labs が開発。https://apify.com/mambalabs