Social Intel MCP

AI 에이전트를 위한 인스타그램 인플루언서 검색 도구입니다. x402를 통해 USDC로 호출당 결제하며, API 키, 구독, 가입이 필요 없습니다.

socialintel.dev는 인플루언서 아웃리치, 브랜드 조사, 크리에이터 인텔리전스 워크플로우를 실행하는 AI 에이전트를 위한 데이터 계층입니다. 이 저장소는 MCP(Model Context Protocol)를 통해 동일한 데이터를 노출하는 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 클라이언트)를 필요로 하는 경우, stdio를 HTTPS로 프록시하는 uvx / pip install 설정은 MCP 클라이언트 섹션을 참조하세요.

🔌 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 → 서버 추가:

{
  "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

인구 통계, 위치, 키워드 또는 비즈니스 카테고리별로 인스타그램 인플루언서를 검색합니다.

각 결과 항목:

{
  "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은 사용 가능한 경우 채워집니다. 비즈니스 인증 계정일수록 높고, 개인 크리에이터 계정일수록 낮습니다(당사가 적용하는 필터가 아닌 인스타그램 플랫폼의 현실입니다).

💰 결제 흐름 (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 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명을 검색하며, 가능한 경우 공개 비즈니스 이메일을 포함합니다.

지역 크리에이터 소싱 (도시 단위)

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당 시간당 5회 요청으로 제한됩니다. 실시간 데이터 소스가 아닌 캐시에서 읽어오므로, 콘텐츠는 실시간 플랫폼 상태가 아닌 최근 쿼리를 반영합니다.

🌐 다중 전송

• stdio (기본값) — uvx --from git+... socialintel-mcp

• HTTPS / 스트리밍 — https://socialintel.dev/mcp에 직접 연결

• SSE — 호스팅 엔드포인트는 이를 선호하는 클라이언트를 위해 Server-Sent Events도 제공합니다.

호스팅 엔드포인트가 가장 간단한 경로입니다. 설치가 필요 없고 도구 정의가 동일합니다.

🔒 개인정보 보호 및 텔레메트리

이 서버는 POSTHOG_API_KEY가 설정된 경우 도구 호출당 하나의 익명 이벤트를 전송합니다:

• 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