Influencers Club Creator Marketing MCP

MCP para acceder a la base de datos más grande del mundo de descubrimiento y enriquecimiento de influencers.

Documentación

Servidor MCP de Influencers Club

Beta — Este proyecto está en desarrollo activo. Funciona y se puede probar, pero se esperan cambios antes de la versión estable.

Servidor MCP para la API de Influencers Club — enriquecimiento de creadores, descubrimiento, análisis de audiencia, datos de contenido, operaciones por lotes y gestión de cuentas.

Dos formas de usarlo:

	Mejor para
Conector alojado (claude.ai, ChatGPT)	Sin instalación — conéctate una vez con tu cuenta de Influencers Club
Instalación local (stdio)	Claude Desktop / Claude Code / IDEs, además de herramientas de archivos locales (exportación CSV, carga por lotes)

Uso con claude.ai (Conector alojado)

El servidor alojado se ejecuta en https://mcp-dashboard.influencers.club/mcp y te identifica con OAuth — sin necesidad de copiar una clave API.

En Claude, abre Configuración → Conectores → Añadir conector personalizado (o busca Influencers Club en el directorio de conectores).
Introduce la URL: https://mcp-dashboard.influencers.club/mcp
Haz clic en Conectar — serás redirigido al panel de Influencers Club para iniciar sesión y aprobar el acceso.
Listo. Pregunta a Claude cosas como "Encuentra 5 creadores de Instagram en fitness con 50k-500k seguidores."

Requisitos: una cuenta de Influencers Club con créditos de API. Las herramientas de descubrimiento y enriquecimiento consumen créditos (los costos están listados en cada herramienta y en las tablas siguientes); las herramientas de diccionario/consulta son gratuitas.

Notas:

El conector alojado expone las 19 herramientas de API. Las herramientas de archivos y lotes (exportación CSV, enriquecimiento CSV masivo) necesitan un sistema de archivos local y solo están disponibles en la instalación local.
Conexión caducada / errores 401: desconecta y vuelve a conectar el conector para reautenticarte.
Errores de "créditos insuficientes": recarga en el panel; las llamadas seguirán fallando hasta que el saldo sea positivo.

Uso con ChatGPT (Modo desarrollador)

El mismo servidor alojado funciona como conector de ChatGPT:

En ChatGPT, activa Configuración → Aplicaciones → Configuración avanzada → Modo desarrollador (disponible en los planes Plus, Pro, Business, Enterprise y Edu).
Añade un nuevo conector con la URL: https://mcp-dashboard.influencers.club/mcp
Haz clic en Conectar — serás redirigido al panel de Influencers Club para iniciar sesión y aprobar el acceso.
Listo. Las mismas 19 herramientas de API están disponibles; los requisitos de créditos y las notas de la sección de claude.ai se aplican sin cambios.

Instalación local (stdio)

Requisitos previos

Python 3.10+ o Docker Desktop
Una clave API de Influencers Club

Inicio rápido (pip)

pip install influencers-club-mcp

O instala desde el código fuente:

git clone https://github.com/Influencers-Club/influencers-club-mcp.git
cd influencers-club-mcp
pip install -e .

Luego añade a tu Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "influencers-club": {
      "command": "influencers-club-mcp",
      "env": {
        "INFLUENCERS_CLUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

Reinicia Claude Desktop — el servidor aparecerá como "influencers-club". Eso es todo.

¿Dónde van los archivos? Por defecto, los CSV exportados y las cargas se guardan en exports/ y imports/ dentro de la carpeta del repositorio clonado. No se necesita configuración adicional.

Para usar una ubicación personalizada, añade estas variables de entorno:
"EXPORT_HOST_DIR": "/your/custom/exports",
"IMPORT_HOST_DIR": "/your/custom/imports",
"OUTPUT_DIR": "/your/custom/exports",
"IMPORTS_DIR": "/your/custom/imports"

Claude Code

Añade a .mcp.json de tu proyecto o a ~/.claude/settings.json global:

{
  "mcpServers": {
    "influencers-club": {
      "command": "influencers-club-mcp",
      "env": {
        "INFLUENCERS_CLUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

VS Code / Cursor

Añade a .vscode/mcp.json en tu proyecto:

{
  "servers": {
    "influencers-club": {
      "command": "influencers-club-mcp",
      "env": {
        "INFLUENCERS_CLUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

Docker (Avanzado)

Usa Docker si quieres aislamiento del sistema de archivos o prefieres implementaciones en contenedores.

git clone https://github.com/Influencers-Club/influencers-club-mcp.git
cd influencers-club-mcp
docker build -t influencers-club-mcp .

Añade a tu Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "influencers-club": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-p", "127.0.0.1:8090:8090",
        "-e", "INFLUENCERS_CLUB_API_KEY=your_api_key_here",
        "-e", "UPLOAD_PORT=8090",
        "-e", "UPLOAD_BIND=0.0.0.0",
        "-v", "/path/to/exports:/exports",
        "-v", "/path/to/imports:/imports",
        "-e", "EXPORT_HOST_DIR=/path/to/exports",
        "-e", "IMPORT_HOST_DIR=/path/to/imports",
        "influencers-club-mcp"
      ]
    }
  }
}

Nota: Reemplaza /path/to/exports y /path/to/imports con rutas reales en tu máquina. La ruta aparece 4 veces — actualízalas todas.

Ejemplos por sistema operativo:

macOS/Linux: /Users/john/influencers-club-mcp/exports

Windows: C:\\Users\\John\\Desktop\\influencers-club-mcp\\exports (usa dobles barras invertidas)

Después de configurar, reinicia tu cliente. El servidor aparecerá como "influencers-club".

Herramientas disponibles (29)

19 herramientas de API están disponibles en todas partes (conector alojado y local). Las herramientas marcadas como solo local necesitan el sistema de archivos local, por lo que solo existen en instalaciones stdio.

Descubrimiento de creadores

Herramienta	Descripción	Costo
`discover_creators`	Búsqueda semántica con IA con filtros (seguidores, engagement, ubicación, etc.)	0.01/creador
`discover_creators_to_file` (solo local)	Descubrimiento de varias páginas con exportación CSV a disco	0.01/creador
`find_similar_creators`	Encuentra creadores similares a un creador semilla	0.01/creador
`audience_overlap`	Compara la superposición de audiencia entre 2-10 creadores	1 crédito

Enriquecimiento

Herramienta	Descripción	Costo
`enrich_by_handle`	Perfil completo enriquecido: email, demografía, audiencia, ingresos, acuerdos de marca	1 crédito
`enrich_by_handle_raw`	Datos básicos del perfil: bio, seguidores, estado de verificación	0.03 créditos
`enrich_by_email`	Encuentra perfiles de creadores a partir de un email	0.05 créditos
`connected_socials`	Descubre todas las cuentas sociales vinculadas de un creador	0.5 créditos

Datos de contenido

Herramienta	Descripción	Costo
`get_creator_posts`	Obtén publicaciones recientes con métricas de engagement (IG, TikTok, YouTube)	0.15 créditos
`get_post_details`	Análisis profundo de contenido (comentarios, transcripción, audio)	0.03 créditos

Enriquecimiento por lotes (solo local)

Herramienta	Descripción	Costo
`create_batch_enrichment`	Sube un CSV de hasta 10,000 handles/emails para procesamiento masivo	varía
`get_batch_status`	Comprueba el progreso del trabajo por lotes (auto-consulta cada 35s)	gratis
`download_batch_results`	Descarga los resultados completos del lote como CSV	gratis
`resume_batch`	Reanuda un lote en pausa después de añadir créditos	gratis

Gestión de archivos (solo local)

Herramienta	Descripción	Costo
`get_upload_url`	Obtén la URL de la página de carga del navegador para archivos CSV por lotes	gratis
`wait_for_upload`	Detecta automáticamente cuando se ha subido un archivo	gratis
`list_import_files`	Lista los archivos CSV subidos listos para enriquecimiento	gratis
`list_export_files`	Lista los archivos de resultados exportados	gratis
`setup_export_path`	Configura dónde se guardan los archivos exportados	gratis

Datos de referencia de descubrimiento

Herramienta	Descripción	Costo
`get_languages`	Idiomas disponibles para filtrar	gratis
`get_locations`	Ubicaciones disponibles por plataforma	gratis
`get_brands`	Identificadores de marca disponibles	gratis
`get_youtube_topics`	Temas de YouTube disponibles	gratis
`get_games`	Juegos de Twitch disponibles	gratis
`get_audience_brand_categories`	Categorías de marca de audiencia	gratis
`get_audience_brand_names`	Nombres de marca de audiencia	gratis
`get_audience_interests`	Categorías de interés de audiencia	gratis
`get_audience_locations`	Ubicaciones geográficas de audiencia	gratis

Cuenta

Herramienta	Descripción	Costo
`check_credits`	Comprueba el saldo de créditos de la cuenta	gratis

Ejemplos de uso

Encuentra influencers de fitness en Instagram:

"Encuentra 5 creadores de Instagram con 50k-500k seguidores que publiquen sobre fitness y tengan una tasa de engagement superior al 3%."

Enriquece un perfil de creador por handle:

"Dame el perfil completo de @cristiano en Instagram, incluyendo demografía de audiencia."

Encuentra creadores similares para escalar campañas:

"Me gusta el creador @MrBeast en YouTube. Encuentra 10 creadores similares con al menos 100k seguidores."

Compara la superposición de audiencia:

"Compara la superposición de audiencia entre @nike, @adidas y @puma en Instagram."

Obtén las publicaciones recientes de un creador:

"Muéstrame las últimas publicaciones de @garyvee en TikTok con métricas de engagement."

Encuentra todas las cuentas sociales conectadas:

"¿Qué otras cuentas de redes sociales tiene @cristiano vinculadas a su Instagram?"

Comprueba tus créditos de API restantes:

"¿Cuántos créditos me quedan?"

Plataformas compatibles

Capacidad	Plataformas
Enriquecimiento	Instagram, TikTok, YouTube, OnlyFans, X/Twitter, Twitch, LinkedIn (solo modo raw)
Descubrimiento	Instagram, TikTok, YouTube, OnlyFans, X/Twitter, Twitch
Datos de contenido	Instagram, TikTok, YouTube
Superposición de audiencia	Instagram, TikTok, YouTube

Variables de entorno (instalación local)

Variable	Requerida	Predeterminado	Descripción
`INFLUENCERS_CLUB_API_KEY`	Sí	—	Tu clave API de Influencers Club
`UPLOAD_PORT`	No	8090	Puerto para la página de carga del navegador
`UPLOAD_BIND`	No	127.0.0.1	Dirección de enlace. Configúrala a `0.0.0.0` dentro de Docker.
`UPLOAD_HOST`	No	localhost	Nombre de host para la URL de carga. Configúralo a tu IP si Docker se ejecuta de forma remota.
`EXPORT_HOST_DIR`	No	—	Ruta del host para archivos exportados
`IMPORT_HOST_DIR`	No	—	Ruta del host para archivos subidos
`MAX_CALLS_PER_MINUTE`	No	300	Límite de tasa del lado del cliente
`LOG_LEVEL`	No	INFO	Verbosidad de registro en stderr: `DEBUG`, `INFO`, `WARNING`, `ERROR` o `CRITICAL`

Solución de problemas

El conector alojado muestra "desconectado" o las herramientas devuelven 401 — elimina y vuelve a añadir el conector (o haz clic en Reconnect) para actualizar la sesión de OAuth.
Errores que mencionan créditos o límites — comprueba tu saldo con check_credits o en el panel; las llamadas fallan hasta que el límite se restablezca o se añadan créditos.
Local: el servidor no aparece en Claude Desktop — verifica que el JSON de configuración sea válido y reinicia la aplicación; comprueba que influencers-club-mcp se ejecute desde una terminal.
Local: la página de carga no es accesible — otro proceso puede estar usando el puerto 8090; configura UPLOAD_PORT a un puerto libre.
Cualquier otra cosa: abre un issue o envía un correo a gjorgji.p@influencers.club.

Política de privacidad

Este servidor MCP es un cliente delgado entre el asistente de IA conectado (por ejemplo, Claude o ChatGPT) y la API de Influencers Club. Las secciones siguientes describen lo que el servidor en sí hace con tus datos; las prácticas completas de datos de la plataforma Influencers Club se rigen por la Política de privacidad de Influencers Club.

Datos que recopilamos. Ninguno. El servidor no recopila, persiste ni transmite información personal identificable sobre el humano que usa el asistente de IA. Las únicas entradas que recibe son los argumentos de herramienta que el asistente envía (por ejemplo, un handle de creador o una ruta de CSV) y el token de portador utilizado para autenticarse contra la API de Influencers Club.

Cómo se usan los datos. Los argumentos de herramienta se reenvían directamente a la API de Influencers Club para cumplir la operación solicitada (descubrimiento, enriquecimiento, procesamiento por lotes, etc.). Las respuestas se devuelven al asistente. El servidor no realiza análisis, perfiles ni entrenamiento de modelos con estos datos.

Almacenamiento. El servidor no mantiene ninguna base de datos. Los únicos datos escritos en disco son: (a) exportaciones/importaciones CSV que el usuario crea explícitamente mediante las herramientas de archivos, escritas en directorios locales que el usuario controla (exports/, imports/, o rutas configuradas por EXPORT_HOST_DIR / IMPORT_HOST_DIR); (b) un pequeño archivo .ic_config.json que almacena la ruta de exportación elegida. No se persiste ningún contenido de conversación, respuestas de API ni credenciales.

Intercambio con terceros. El servidor se comunica con exactamente un tercero: la API de Influencers Club. No se envían datos a ningún otro endpoint, servicio de análisis o proveedor de telemetría. El token de portador se transmite solo a la API de Influencers Club a través de HTTPS y se redacta de cualquier mensaje de error devuelto al asistente.

Retención. El servidor no retiene nada en proceso más allá de la vida de una sola llamada de herramienta, con la excepción de los archivos CSV controlados por el usuario descritos anteriormente, que el usuario puede eliminar en cualquier momento. Los tokens de portador se leen de las variables de entorno (o, en modo alojado/HTTP, de la solicitud autenticada) y nunca se escriben en disco.

Contacto. Preguntas de privacidad y solicitudes de eliminación de datos: gjorgji.p@influencers.club. Las divulgaciones de seguridad también pueden presentarse a través de GitHub Issues.

Soporte

Correo electrónico: gjorgji.p@influencers.club
GitHub Issues: github.com/Influencers-Club/influencers-club-mcp/issues

Licencia

MIT