mcp-bluesky-brand-presence-mapper

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

企業のドメインからBlueskyアカウントを特定し、フォロワー数、フォロー数、投稿数を正確に取得するMCPサーバーです。Apify上のMamba Labs Bluesky Brand Presence Mapperアクターをラップし、任意のMCPクライアントにClay対応のフラットなJSON行を返します。

内容

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

機能

企業のドメイン、またはすでにわかっている場合はBlueskyハンドルを指定すると、公開AT Protocol APIを通じてその企業の公式Blueskyアカウントを検索します。プロフィールURL、ハンドル、DID、正確なフォロワー数、フォロー数、投稿数、表示名、自己紹介、アカウント作成日を、フラットな1行のデータとして返します。

数値は丸めずに正確な値を返します。特定されたハンドルが企業のドメインそのものである場合、Blueskyは企業がDNSチェックに合格した後にのみそのハンドルを付与しています。そのため、この行ではプラットフォームが提供する最も強い本人確認の証拠としてその事実を示します。Blueskyアカウントを持たない企業にはnot_foundが返されます。これは失敗ではなく、実際によくある結果です。

検索処理はすべてApify上で実行されます。このパッケージは、アクターを呼び出して結果をそのまま返す薄いクライアントです。

このツールはアクターの実行を開始し、完了状態になるまでポーリングするため、実行時間が300秒を超えても途中で打ち切られません。実行時間は最大1,800秒です。それでも2分後に実行中の場合、呼び出しは待機を終了し、実行IDとApify Consoleへのリンクを返します。処理完了後、結果はそこで確認できます。実行が成功しなかった場合は、実行IDとステータスを含むエラーが返されます。

クイックスタート

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

Claude Desktopの設定に次の内容を追加します。

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

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

前提条件

• Node.js 18以降
• APIトークンを持つApifyアカウント

プロンプトの例

• 「theverge.com の Bluesky アカウントを見つけて、フォロワー数を教えてください。」
• 「shopify.com に Bluesky アカウントはありますか？ また、ハンドルはドメイン認証済みですか？」
• 「Bluesky のハンドル theverge.com を調べて、アカウントの作成日を教えてください。」
• 「Bluesky のアカウント検索を使わずに、npr.org の Bluesky での存在状況を調べてください。」

入力

• company_domain（任意）：shopify.com などの会社ドメインのみを指定します。これかハンドルのいずれかを指定してください。ドメインを指定するとアクターはすべての検出処理を実行し、ハンドルを指定するとそのまま取得処理に進みます。
• company_name（任意）：検索精度を高めます。また、検出したプロフィールとの照合に本人確認ゲートで使用されるため、指定すると誤一致を減らせます。
• handle（任意）：shopify.com、mamba.bsky.social、または DID などの Bluesky ハンドルです。指定すると検出処理を完全にスキップします。Bluesky でドメイン認証を行った会社は、ドメインのみをハンドルとして使用するため、company_domain と同じになることがよくあります。
• includeFollowerCounts（任意）：true（デフォルト）の場合、プロフィールを取得してカウントを抽出します。プロフィール URL の解決のみを行う場合は false に設定します。こちらのほうが低コストです。
• skipCache（任意）：false（デフォルト）の場合、検索が成功すると結果は7日間キャッシュされ、再利用されます。最新の結果を取得するには true に設定します。
• useActorSearch（任意）：true（デフォルト）で、ドメイン自体が認証済みハンドルでない場合、Bluesky 独自のアカウント検索を使用します。似た名前のアカウントと一致する可能性を避けるため、会社のホームページとドメインをハンドルとして使う方法のみに頼る場合は false に設定します。
• max_charge_usd（任意）：この実行の USD 建ての料金上限です。料金がこの金額を超える可能性のある項目の処理を開始する前に、アクターは停止します。指定しない場合は、Apify で設定された実行あたりの最大コストが適用されます。

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

出力

このツールは、会社ごとにアクターのフラットな JSON 行を返します。18個の snake_case フィールドがあり、ネストされたオブジェクトはありません。カウントを読む前に bluesky_status を確認してください。ok、not_found、not_extractable、blocked、identity_mismatch、auth_failed、skipped はそれぞれ異なる状態で、ラッパーによってまとめられることはありません。bluesky_discovery は、アカウントが見つかった経路を示します。domain_handle（最も確度が高い）から pattern_guess まであります。出力スキーマの全容については、Apify Store のページをご覧ください。

出力例

{
  "degraded": false,
  "degradation_reason": null,
  "company_domain": "theverge.com",
  "company_name": "The Verge",
  "bluesky_url": "https://bsky.app/profile/theverge.com",
  "bluesky_handle": "theverge.com",
  "bluesky_did": "did:plc:7exlcsle4mjfhu3wnhcgizz6",
  "bluesky_domain_verified": true,
  "bluesky_followers": 357220,
  "bluesky_following": 141,
  "bluesky_posts": 14584,
  "bluesky_followers_exact": true,
  "bluesky_display_name": "The Verge",
  "bluesky_bio": "The Verge covers the intersection of technology, science, art, and culture.",
  "bluesky_created_at": "2023-05-23T19:11:25.009Z",
  "bluesky_discovery": "domain_handle",
  "bluesky_status": "ok",
  "run_date": "2026-08-22T19:26:58.474Z"
}

機能

• 会社ドメインからブランドの Bluesky アカウントを特定
• 丸められていない正確なフォロワー数、フォロー数、投稿数
• ハンドルとともに安定した DID を返すため、アカウントを継続的に追跡可能
• DNS チェック後にのみ Bluesky が認めるドメイン認証ステータス
• アカウントの作成日を確認できるため、新しく開設されたものと既存のものを区別可能
• すべての行で検出経路を bluesky_discovery に報告
• 会社ごとに1行、18個のフラットな snake_case フィールド

料金

Apify の FREE プランでのイベントあたりの価格。ライブ料金記録に基づいています。Apify の有料プランでは、イベントあたりの料金がさらに安くなります。

イベント	価格（USD）
アクターの開始（apify-actor-start）	0.00005
会社の確認（company-checked）	0.0035
プロフィールの解決（profile-resolved）	0.003
フォロワー数の抽出（follower-count-extracted）	0.0025

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

このサーバーは薄いクライアントであり、検索ロジックは保持しません。入力と出力の詳細、料金、実行履歴については、Apify Store のページをご覧ください。

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

---

Mamba Labs GTM Suite

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

Mamba Labs が開発 | npm | Apify Store

ライセンス

MIT

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