Social Intel MCP

Descubrimiento de influencers de Instagram para agentes de IA. Pago por llamada en USDC a través de x402 — sin claves API, sin suscripciones, sin registro.

socialintel.dev es una capa de datos para agentes de IA que ejecutan flujos de trabajo de alcance a influencers, investigación de marca e inteligencia de creadores. Este repositorio incluye un servidor MCP que expone los mismos datos a través del Protocolo de Contexto de Modelo (MCP), para que cualquier cliente compatible con MCP (Claude, Cursor, VS Code, Cline, …) pueda llamarlo de forma nativa.

📋 Tabla de contenidos

• 🚀 Inicio rápido — endpoint alojado

• 🔌 Clientes MCP

• 🛠️ Herramientas

• 💰 Flujo de pago (x402)

• 🎯 Casos de uso

• 🎛️ Configuración

• 🧪 Modo demo gratuito

• 🌐 Múltiples transportes

• 🔒 Privacidad y telemetría

• 🗺️ Relacionado

• 📄 Licencia

Related MCP server: aipaygen-mcp

🚀 Inicio rápido — endpoint alojado

Recomendado. Apunta cualquier cliente MCP que utilice HTTP/SSE o transporte transmitible directamente a nuestro servidor alojado:

https://socialintel.dev/mcp

Sin instalación, sin pip, sin Docker. El cliente x402 de tu agente gestiona el pago en cada tools/call.

Si tu cliente necesita un envoltorio stdio (Claude Desktop en versiones anteriores, algunos clientes CLI), consulta la sección Clientes MCP para configuraciones de uvx / pip install que hacen proxy de stdio → HTTPS.

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

Reinicia Claude Desktop. search_leads aparecerá en la lista de herramientas.

Cursor

Preferencias → MCP → añadir servidor:

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

VS Code (con GitHub Copilot o Continue)

.vscode/mcp.json en tu espacio de trabajo:

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

Cline (extensión de VS Code)

Cline detecta automáticamente los servidores MCP desde cline_mcp_settings.json. Añade el mismo bloque de servidor que en Claude Desktop arriba.

Cherry Studio / Zed / cualquier cliente compatible con MCP

Usa el comando stdio:

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

O apunta el cliente al endpoint HTTP alojado si admite MCP remoto: https://socialintel.dev/mcp

Instalación directa con pip

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

🛠️ Herramientas

search_leads

Busca influencers de Instagram por demografía, ubicación, palabra clave o categoría de negocio.

Cada resultado:

{
  "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 se completa cuando está disponible; es más frecuente en cuentas verificadas como empresa y menos en cuentas de creadores personales (realidad de la plataforma Instagram, no un filtro que apliquemos nosotros).

💰 Flujo de pago (x402)

Los pagos de los agentes siguen el protocolo x402: una respuesta de Pago Requerido 402 lleva requisitos de pago firmados; el cliente firma una transferencia USDC y reintenta; el servidor verifica + liquida a través de un facilitador y devuelve los resultados.

1. El agente llama a search_leads(category="Fitness", country="US").

2. El servidor responde HTTP 402 con metadatos extensions.bazaar y acepta bloques para Base (USDC) y Solana (USDC).

3. Si el cliente ejecuta una biblioteca de cliente x402 (x402-httpx, agentcash, el paquete TypeScript x402, etc.), firma una transferencia en cualquiera de las cadenas y reintenta.

4. Nuestro servidor verifica + liquida a través del facilitador CDP (principal — también nos cataloga en agentic.market) o el facilitador PayAI (alternativo). Los resultados se devuelven en la llamada reintentada.

Precios — transparentes por llamada, sin mínimos:

Fórmula: $0.50 + max(0, límite − 20) × $0.01.

La demo gratuita con demo=true omite el pago por completo; consulta Modo demo gratuito.

🎯 Casos de uso

Descubrimiento de micro-influencers para alcance de marca

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

Devuelve 50 micro-influencers de belleza en EE. UU., con correos electrónicos comerciales públicos cuando estén disponibles.

Búsqueda de creadores locales (nivel ciudad)

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

Creadores de comida en LA con más de 10K seguidores.

Fusión de palabra clave + demografía

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

Entrenadores personales mujeres en el Reino Unido, nivel de seguidores medio-alto.

Exploración gratuita antes de pagar

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

Devuelve 3 resultados de vista previa sin pago — perfecto para validar filtros antes de gastar.

🎛️ Configuración

🧪 Modo demo gratuito

Pasa demo=true en cualquier llamada a search_leads. Obtienes hasta 3 resultados de vista previa, sin necesidad de pago. La respuesta incluye un upgrade_message que apunta a la URL de pago para que tu agente pueda cambiar al modo de pago después de validar los filtros.

La demo tiene un límite de 5 solicitudes por IP por hora. Lee desde nuestra caché en lugar de la fuente de datos en vivo, por lo que el contenido refleja consultas recientes en lugar del estado de la plataforma en tiempo real.

🌐 Múltiples transportes

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

• HTTPS / transmitible — conecta directamente a https://socialintel.dev/mcp

• SSE — el endpoint alojado también sirve Server-Sent Events para clientes que lo prefieran

El endpoint alojado es la ruta más sencilla — instalación cero, definiciones de herramientas idénticas.

🔒 Privacidad y telemetría

Este servidor emite un evento anónimo por llamada de herramienta cuando POSTHOG_API_KEY está configurado:

• mcp_search_leads — incluye solo la forma del filtro (consulta, país, categoría, género, rango de seguidores, límite, bandera de demo) y el recuento de filas resultante. Sin nombres de usuario de perfil, sin correos electrónicos, sin direcciones de pagador.

Los eventos están desactivados por defecto (sin clave significa sin captura). Si habilitas la telemetría, puedes apuntarla a tu propio proyecto de PostHog — establece POSTHOG_API_KEY con tu propia clave y los eventos irán a tu instancia, no a la nuestra.

La telemetría a nivel de pago (liquidación x402, hashes de transacciones, ingresos) es capturada en el lado del servidor por socialintel.dev, no por este envoltorio MCP.

🗺️ Relacionado

• Sitio web: socialintel.dev

• Documentación de la API: socialintel.dev/docs

• Especificación OpenAPI: socialintel.dev/openapi.json

• Protocolo x402: x402.org

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

• Red Base (USDC): basescan.org

• Descubrimiento CDP Bazaar: agentic.market

• Protocolo de Contexto de Modelo: modelcontextprotocol.io

📄 Licencia

MIT — ver LICENSE.

🐛 Problemas

Informes de errores, solicitudes de funciones, preguntas sobre integración de agentes: github.com/socialintel/socialintel-mcp/issues