Social Intel MCP

Поиск инфлюенсеров в Instagram для ИИ-агентов. Оплата за вызов в USDC через x402 — без API-ключей, подписок и регистрации.

socialintel.dev — это слой данных для ИИ-агентов, выполняющих задачи по поиску инфлюенсеров, исследованию брендов и аналитике авторов контента. Этот репозиторий содержит MCP-сервер, который предоставляет те же данные через протокол Model Context Protocol, чтобы любой MCP-совместимый клиент (Claude, Cursor, VS Code, Cline и др.) мог вызывать их напрямую.

📋 Содержание

• 🚀 Быстрый старт — хостинг-эндпоинт

• 🔌 MCP-клиенты

• 🛠️ Инструменты

• 💰 Процесс оплаты (x402)

• 🎯 Варианты использования

• 🎛️ Конфигурация

• 🧪 Бесплатный демо-режим

• 🌐 Несколько протоколов передачи

• 🔒 Конфиденциальность и телеметрия

• 🗺️ Ссылки

• 📄 Лицензия

Related MCP server: aipaygen-mcp

🚀 Быстрый старт — хостинг-эндпоинт

Рекомендуется. Укажите любому MCP-клиенту, поддерживающему HTTP/SSE или потоковую передачу, наш хостинг-сервер:

https://socialintel.dev/mcp

Никакой установки, pip или Docker. Ваш x402-клиент агента обрабатывает оплату при каждом tools/call.

Если вашему клиенту требуется stdio-обертка (Claude Desktop старых версий, некоторые CLI-клиенты), см. раздел MCP-клиенты для настройки uvx / pip install, которые проксируют stdio → HTTPS.

🔌 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 автоматически обнаруживает MCP-серверы из cline_mcp_settings.json. Добавьте тот же блок сервера, что и для Claude Desktop выше.

Cherry Studio / Zed / любой MCP-совместимый клиент

Используйте команду stdio:

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

Или укажите клиенту хостинг-эндпоинт HTTP, если он поддерживает удаленные MCP: 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. Сервер отвечает HTTP 402 с метаданными extensions.bazaar и принимает блоки для Base (USDC) и Solana (USDC).

3. Если клиент использует библиотеку x402 (x402-httpx, agentcash, пакет TypeScript x402 и т.д.), он подписывает перевод в одной из сетей и повторяет запрос.

4. Наш сервер проверяет и подтверждает транзакцию через CDP facilitator (основной — также каталогизирует нас на agentic.market) или PayAI facilitator (резервный). Результаты возвращаются в повторном вызове.

Ценообразование — прозрачно за каждый вызов, без минимальных сумм:

Формула: $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 микро-инфлюенсеров в сфере красоты в США с публичными бизнес-email, если они доступны.

Поиск локальных авторов (на уровне города)

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

Фуд-блогеры в Лос-Анджелесе с 10K+ подписчиков.

Сочетание ключевых слов и демографии

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 результата для ознакомления без оплаты — идеально для проверки фильтров перед тратой средств.

🎛️ Конфигурация

🧪 Бесплатный демо-режим

Передайте demo=true в любом вызове search_leads. Вы получите до 3 результатов для ознакомления без оплаты. Ответ включает upgrade_message со ссылкой на платную версию, чтобы ваш агент мог переключиться на платный режим после проверки фильтров.

Демо-режим ограничен 5 запросами с одного IP в час. Он считывает данные из нашего кэша, а не из источника в реальном времени, поэтому контент отражает недавние запросы, а не текущее состояние платформы.

🌐 Несколько протоколов передачи

• stdio (по умолчанию) — uvx --from git+... socialintel-mcp

• HTTPS / потоковая передача — подключение напрямую к https://socialintel.dev/mcp

• SSE — хостинг-эндпоинт также поддерживает Server-Sent Events для клиентов, которые предпочитают этот метод

Хостинг-эндпоинт — самый простой путь: нулевая установка, идентичные определения инструментов.

🔒 Конфиденциальность и телеметрия

Этот сервер отправляет одно анонимное событие при вызове инструмента, если задан POSTHOG_API_KEY:

• mcp_search_leads — включает только параметры фильтра (запрос, страна, категория, пол, диапазон подписчиков, лимит, флаг демо) и количество полученных строк. Никаких имен пользователей, email-адресов или адресов плательщиков.

События отключены по умолчанию (нет ключа — нет сбора данных). Если вы включите телеметрию, вы можете направить её на свой проект PostHog — установите POSTHOG_API_KEY на свой собственный ключ, и события будут отправляться в ваш экземпляр, а не в наш.

Телеметрия уровня платежей (расчеты x402, хеши транзакций, доход) фиксируется на стороне сервера socialintel.dev, а не этой MCP-оберткой.

🗺️ Ссылки

• Сайт: 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