Social Intel MCP

Instagram-Influencer-Suche für KI-Agenten. Bezahlen Sie pro Aufruf in USDC via x402 — keine API-Keys, keine Abonnements, keine Registrierung.

socialintel.dev ist eine Datenschicht für KI-Agenten, welche Influencer-Outreach, Markenrecherche und Creator-Intelligence-Workflows durchführen. Dieses Repository stellt einen MCP-Server bereit, der dieselben Daten über das Model Context Protocol verfügbar macht, sodass jeder MCP-kompatible Client (Claude, Cursor, VS Code, Cline, …) ihn nativ aufrufen kann.

📋 Inhaltsverzeichnis

• 🚀 Schnellstart — gehosteter Endpunkt

• 🔌 MCP-Clients

• 🛠️ Tools

• 💰 Zahlungsablauf (x402)

• 🎯 Anwendungsfälle

• 🎛️ Konfiguration

• 🧪 Kostenloser Demo-Modus

• 🌐 Mehrere Transporte

• 🔒 Datenschutz & Telemetrie

• 🗺️ Verwandtes

• 📄 Lizenz

Related MCP server: aipaygen-mcp

🚀 Schnellstart — gehosteter Endpunkt

Empfohlen. Verbinden Sie jeden MCP-Client, der HTTP/SSE oder streamfähige Transporte unterstützt, direkt mit unserem gehosteten Server:

https://socialintel.dev/mcp

Keine Installation, kein pip, kein Docker. Der x402-Client Ihres Agenten wickelt die Zahlung bei jedem tools/call ab.

Falls Ihr Client einen stdio-Wrapper benötigt (Claude Desktop in älteren Versionen, einige CLI-Clients), finden Sie im Abschnitt MCP-Clients Anleitungen für uvx / pip install, die stdio → HTTPS proxien.

🔌 MCP-Clients

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

Starten Sie Claude Desktop neu. search_leads erscheint in der Tool-Liste.

Cursor

Einstellungen → MCP → Server hinzufügen:

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

VS Code (mit GitHub Copilot oder Continue)

.vscode/mcp.json in Ihrem Workspace:

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

Cline (VS Code Erweiterung)

Cline erkennt MCP-Server automatisch aus der cline_mcp_settings.json. Fügen Sie denselben Server-Block wie oben für Claude Desktop hinzu.

Cherry Studio / Zed / jeder MCP-kompatible Client

Verwenden Sie den stdio-Befehl:

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

Oder verbinden Sie den Client mit dem gehosteten HTTP-Endpunkt, falls dieser Remote-MCPs unterstützt: https://socialintel.dev/mcp

Direkte pip-Installation

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

🛠️ Tools

search_leads

Suchen Sie Instagram-Influencer nach Demografie, Standort, Keyword oder Geschäftskategorie.

Jedes Ergebnis:

{
  "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 wird dort ausgefüllt, wo verfügbar — häufiger bei geschäftlich verifizierten Konten, seltener bei persönlichen Creator-Konten (Realität der Instagram-Plattform, kein von uns angewandter Filter).

💰 Zahlungsablauf (x402)

Agentenzahlungen folgen dem x402-Protokoll: Eine 402 Payment Required-Antwort enthält signierte Zahlungsanforderungen; der Client signiert eine USDC-Überweisung und wiederholt den Aufruf; der Server verifiziert + begleicht über einen Facilitator und liefert die Ergebnisse.

1. Der Agent ruft search_leads(category="Fitness", country="US") auf.

2. Der Server antwortet mit HTTP 402 inklusive extensions.bazaar-Metadaten und akzeptiert Zahlungen für Base (USDC) und Solana (USDC).

3. Wenn der Client eine x402-Client-Bibliothek verwendet (x402-httpx, agentcash, das TypeScript x402-Paket, etc.), signiert er eine Überweisung auf einer der Chains und wiederholt den Aufruf.

4. Unser Server verifiziert + begleicht über den CDP-Facilitator (primär — listet uns auch auf agentic.market) oder den PayAI-Facilitator (Fallback). Die Ergebnisse werden beim wiederholten Aufruf zurückgegeben.

Preise — transparent pro Aufruf, keine Mindestbeträge:

Formel: $0.50 + max(0, limit − 20) × $0.01.

Die kostenlose Demo mit demo=true überspringt die Zahlung vollständig; siehe Kostenloser Demo-Modus.

🎯 Anwendungsfälle

Mikro-Influencer-Suche für Marken-Outreach

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

Liefert 50 Beauty-Mikro-Influencer in den USA, mit öffentlichen geschäftlichen E-Mails, sofern verfügbar.

Lokale Creator-Suche (auf Stadtebene)

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

Food-Creator aus LA mit 10K+ Followern.

Kombination aus Keyword + Demografie

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

Weibliche Personal Trainer in Großbritannien, mittlerer bis großer Follower-Bereich.

Kostenlose Erkundung vor der Zahlung

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

Liefert 3 Vorschauergebnisse ohne Zahlung — perfekt, um Filter zu validieren, bevor Geld ausgegeben wird.

🎛️ Konfiguration

🧪 Kostenloser Demo-Modus

Übergeben Sie demo=true bei jedem search_leads-Aufruf. Sie erhalten bis zu 3 Vorschauergebnisse, keine Zahlung erforderlich. Die Antwort enthält eine upgrade_message mit dem Link zur kostenpflichtigen URL, damit Ihr Agent nach Validierung der Filter in den kostenpflichtigen Modus wechseln kann.

Die Demo ist auf 5 Anfragen pro IP pro Stunde begrenzt. Sie liest aus unserem Cache statt aus der Live-Datenquelle, daher spiegeln die Inhalte eher aktuelle Abfragen wider als den Live-Status der Plattform.

🌐 Mehrere Transporte

• stdio (Standard) — uvx --from git+... socialintel-mcp

• HTTPS / streamfähig — verbinden Sie sich direkt mit https://socialintel.dev/mcp

• SSE — der gehostete Endpunkt bietet auch Server-Sent Events für Clients, die dies bevorzugen

Der gehostete Endpunkt ist der einfachste Weg — keine Installation, identische Tool-Definitionen.

🔒 Datenschutz & Telemetrie

Dieser Server sendet ein anonymes Ereignis pro Tool-Aufruf, wenn POSTHOG_API_KEY gesetzt ist:

• mcp_search_leads — enthält nur die Filterstruktur (Query, Land, Kategorie, Geschlecht, Follower-Bereich, Limit, Demo-Flag) und die Anzahl der Ergebniszeilen. Keine Profil-Benutzernamen, keine E-Mails, keine Zahler-Adressen.

Ereignisse sind standardmäßig deaktiviert (kein Key bedeutet keine Erfassung). Wenn Sie Telemetrie aktivieren, können Sie diese auf Ihr eigenes PostHog-Projekt richten — setzen Sie POSTHOG_API_KEY auf Ihren eigenen Key, und die Ereignisse gehen an Ihre Instanz, nicht an unsere.

Zahlungsbezogene Telemetrie (x402-Begleichung, Transaktions-Hashes, Umsatz) wird serverseitig von socialintel.dev erfasst, nicht von diesem MCP-Wrapper.

🗺️ Verwandtes

• Website: socialintel.dev

• API-Dokumentation: socialintel.dev/docs

• OpenAPI-Spezifikation: socialintel.dev/openapi.json

• x402-Protokoll: x402.org

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

• Base Network (USDC): basescan.org

• CDP Bazaar Discovery: agentic.market

• Model Context Protocol: modelcontextprotocol.io

📄 Lizenz

MIT — siehe LICENSE.

🐛 Probleme

Fehlerberichte, Funktionsanfragen, Fragen zur Agenten-Integration: github.com/socialintel/socialintel-mcp/issues