Social Intel MCP

AIエージェント向けのInstagramインフルエンサー検索ツール。x402 を介してUSDCでコールごとに支払います。APIキー、サブスクリプション、サインアップは不要です。

socialintel.dev は、インフルエンサーへのアウトリーチ、ブランド調査、クリエイターインテリジェンスのワークフローを実行するAIエージェントのためのデータレイヤーです。このリポジトリは、Model Context Protocol（MCP）を通じて同じデータを公開するMCPサーバーを提供しており、MCP互換クライアント（Claude、Cursor、VS Code、Clineなど）からネイティブに呼び出すことができます。

📋 目次

• 🚀 クイックスタート — ホスト型エンドポイント

• 🔌 MCPクライアント

• 🛠️ ツール

• 💰 支払いフロー (x402)

• 🎯 ユースケース

• 🎛️ 設定

• 🧪 無料デモモード

• 🌐 複数のトランスポート

• 🔒 プライバシーとテレメトリ

• 🗺️ 関連情報

• 📄 ライセンス

Related MCP server: aipaygen-mcp

🚀 クイックスタート — ホスト型エンドポイント

推奨。 HTTP/SSEまたはストリーミング可能なトランスポートをサポートするMCPクライアントを、当社のホスト型サーバーに直接向けてください：

https://socialintel.dev/mcp

インストール、pip、Dockerは不要です。エージェントのx402クライアントが各 tools/call での支払いを処理します。

クライアントがstdioラッパーを必要とする場合（古いバージョンのClaude Desktopや一部のCLIクライアントなど）、MCPクライアント セクションを参照して、stdioからHTTPSへプロキシする uvx / pip install の設定を確認してください。

🔌 MCPクライアント

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "socialintel": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/socialintel/socialintel-mcp",
        "socialintel-mcp"
      ],
      "env": {
        "SOCIAL_INTEL_API_URL": "https://socialintel.dev"
      }
    }
  }
}

Claude Desktopを再起動します。ツールリストに search_leads が表示されます。

Cursor

Preferences → MCP → add server:

{
  "socialintel": {
    "command": "uvx",
    "args": ["--from", "git+https://github.com/socialintel/socialintel-mcp", "socialintel-mcp"]
  }
}

VS Code (GitHub CopilotまたはContinueを使用)

ワークスペースの .vscode/mcp.json に以下を追加します：

{
  "servers": {
    "socialintel": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/socialintel/socialintel-mcp", "socialintel-mcp"]
    }
  }
}

Cline (VS Code拡張機能)

Clineは cline_mcp_settings.json からMCPサーバーを自動検出します。上記のClaude Desktopと同じサーバーブロックを追加してください。

Cherry Studio / Zed / その他のMCP互換クライアント

stdioコマンドを使用します：

uvx --from git+https://github.com/socialintel/socialintel-mcp socialintel-mcp

または、リモートMCPをサポートしている場合は、ホストされているHTTPエンドポイントを指定します：https://socialintel.dev/mcp

直接pipインストール

pip install git+https://github.com/socialintel/socialintel-mcp
SOCIAL_INTEL_API_URL=https://socialintel.dev socialintel-mcp

🛠️ ツール

search_leads

人口統計、場所、キーワード、またはビジネスカテゴリーでInstagramインフルエンサーを検索します。

各結果の内容：

{
  "username": "yoga_with_adriene",
  "full_name": "Adriene Mishler",
  "followers": 10500000,
  "category": "Fitness",
  "bio": "Yoga teacher & filmmaker from Austin TX",
  "public_email": "contact@adriene.com",
  "is_verified": true,
  "is_business": true,
  "gender": "woman"
}

public_email は利用可能な場合にのみ入力されます。ビジネス認証済みアカウントでは表示されやすく、個人のクリエイターアカウントでは表示されにくい傾向があります（これは適用するフィルターではなく、Instagramプラットフォームの仕様です）。

💰 支払いフロー (x402)

エージェントの支払いは x402プロトコル に従います。402 Payment Requiredレスポンスに署名済みの支払い要件が含まれ、クライアントがUSDC送金に署名して再試行し、サーバーが検証・決済して結果を返します。

1. エージェントが search_leads(category="Fitness", country="US") を呼び出します。

2. サーバーが extensions.bazaar メタデータを含む HTTP 402 を返し、Base (USDC) および Solana (USDC) のブロックを受け入れます。

3. クライアントがx402クライアントライブラリ（x402-httpx, agentcash, TypeScriptの x402 パッケージなど）を実行している場合、いずれかのチェーンで送金に署名し、再試行します。

4. サーバーは CDPファシリテーター（プライマリ — agentic.market にも掲載）または PayAIファシリテーター（フォールバック）を介して検証・決済を行います。再試行された呼び出しで結果が返されます。

料金 — コールごとの透明な価格設定、最低料金なし：

計算式: $0.50 + max(0, limit − 20) × $0.01。

demo=true を使用した無料デモでは支払いが完全にスキップされます。無料デモモード を参照してください。

🎯 ユースケース

ブランドアウトリーチのためのマイクロインフルエンサー発見

search_leads(
    category="Beauty",
    country="US",
    min_followers=15000,
    max_followers=200000,
    limit=50,
)

米国の美容系マイクロインフルエンサー50名を、公開ビジネスメールがある場合はそれを含めて返します。

ローカルクリエイターのソーシング（都市レベル）

search_leads(
    city="Los Angeles",
    category="Food & Beverage",
    min_followers=10000,
    limit=20,
)

フォロワー1万人以上のLAのフードクリエイター。

キーワードと人口統計の融合

search_leads(
    query="personal trainer",
    gender="female",
    country="United Kingdom",
    min_followers=50000,
    max_followers=500000,
)

英国の女性パーソナルトレーナー、中〜大規模フォロワー層。

支払い前の無料探索

search_leads(category="Travel", country="Germany", demo=True)

支払いを伴わずに3件のプレビュー結果を返します。支出前にフィルターを検証するのに最適です。

🎛️ 設定

🧪 無料デモモード

search_leads の呼び出しに demo=true を渡します。最大3件のプレビュー結果を無料で取得できます。レスポンスには有料URLへのリンクを含む upgrade_message が含まれており、フィルターを検証した後にエージェントが有料モードに切り替えることができます。

デモはIPあたり1時間5リクエストまでに制限されています。ライブデータソースではなくキャッシュから読み取られるため、コンテンツはライブのプラットフォーム状態ではなく、最近のクエリを反映しています。

🌐 複数のトランスポート

• stdio (デフォルト) — uvx --from git+... socialintel-mcp

• HTTPS / ストリーミング可能 — https://socialintel.dev/mcp に直接接続

• SSE — ホスト型エンドポイントは、SSEを好むクライアント向けにServer-Sent Eventsも提供します

ホスト型エンドポイントが最もシンプルな方法です。インストール不要で、ツール定義も同一です。

🔒 プライバシーとテレメトリ

このサーバーは、POSTHOG_API_KEY が設定されている場合、ツール呼び出しごとに1つの匿名イベントを送信します：

• mcp_search_leads — フィルターの形状（クエリ、国、カテゴリー、性別、フォロワー範囲、制限数、デモフラグ）と結果の行数のみが含まれます。プロフィールのユーザー名、メールアドレス、支払者のアドレスは含まれません。

イベントは デフォルトでオフ です（キーがない場合はキャプチャされません）。テレメトリを有効にする場合は、独自のPostHogプロジェクトを指定できます。POSTHOG_API_KEY を独自のキーに設定すると、イベントは当社のインスタンスではなく、お客様のインスタンスに送信されます。

支払いレベルのテレメトリ（x402決済、トランザクションハッシュ、収益）は、このMCPラッパーではなく、socialintel.devによってサーバー側でキャプチャされます。

🗺️ 関連情報

• ウェブサイト: socialintel.dev

• APIドキュメント: socialintel.dev/docs

• OpenAPI仕様: socialintel.dev/openapi.json

• x402プロトコル: x402.org

• agentcash (x402 CLI/SDK): github.com/merit-systems/agentcash

• Baseネットワーク (USDC): basescan.org

• CDP Bazaar発見: agentic.market

• Model Context Protocol: modelcontextprotocol.io

📄 ライセンス

MIT — LICENSE を参照してください。

🐛 問題

バグ報告、機能リクエスト、エージェント統合に関する質問： github.com/socialintel/socialintel-mcp/issues