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 espera cambios antes del lanzamiento 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. Pregúntale a Claude cosas como "Encuentra 5 creadores de Instagram en fitness con 50k-500k seguidores."

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

Notas:

El conector alojado expone las 19 herramientas 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 → Apps → 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 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ñádelo a tu claude_desktop_config.json de Claude Desktop:

{
  "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ñádelo al .mcp.json de tu proyecto o al ~/.claude/settings.json global:

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

VS Code / Cursor

Añádelo 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 despliegues en contenedores.

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

Añádelo a tu claude_desktop_config.json de Claude Desktop:

{
  "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 de 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 configurarlo, reinicia tu cliente. El servidor aparecerá como "influencers-club".

Herramientas disponibles (29)

19 herramientas 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	Coste
`discover_creators`	Búsqueda semántica con IA y filtros (seguidores, engagement, ubicación, etc.)	0,01/creador
`discover_creators_to_file` (solo local)	Descubrimiento multipágina 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 audiencias entre 2-10 creadores	1 crédito

Enriquecimiento

Herramienta	Descripción	Coste
`enrich_by_handle`	Perfil completo enriquecido: email, datos demográficos, 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	Coste
`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	Coste
`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 (sondeo automático cada 35 s)	gratis
`download_batch_results`	Descarga los resultados del lote completado 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	Coste
`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 para descubrimiento

Herramienta	Descripción	Coste
`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 la audiencia	gratis
`get_audience_brand_names`	Nombres de marca de la audiencia	gratis
`get_audience_interests`	Categorías de interés de la audiencia	gratis
`get_audience_locations`	Ubicaciones geográficas de la audiencia	gratis

Cuenta

Herramienta	Descripción	Coste
`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 el perfil de un creador por handle:

"Dame el perfil completo de @cristiano en Instagram, incluidos los datos demográficos de la 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 audiencias:

"Compara la superposición de audiencias 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 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 audiencias	Instagram, TikTok, YouTube

Variables de entorno (instalación local)

Variable	Obligatoria	Valor por defecto	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. Establécelo en `0.0.0.0` dentro de Docker.
`UPLOAD_HOST`	No	localhost	Nombre de host para la URL de carga. Establécelo en 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 velocidad del lado del cliente

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 renovar la sesión 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 restablece o se añaden 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 ejecuta desde una terminal.
Local: la página de carga no es accesible — otro proceso puede estar usando el puerto 8090; establece UPLOAD_PORT en un puerto libre.
Cualquier otra cosa: abre un issue o escribe a gjorgji.p@influencers.club.

Política de privacidad

Este servidor MCP es un cliente ligero entre el asistente de IA conectado (p. ej. Claude o ChatGPT) y la API de Influencers Club. Las secciones siguientes describen lo que el propio servidor 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 la persona que usa el asistente de IA. Las únicas entradas que recibe son los argumentos de herramienta que envía el asistente (p. ej. un handle de creador o una ruta 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 que se escriben 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 establecidas 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, respuesta de API ni credencial.

Uso compartido 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 únicamente 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 duración de una única 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 sobre 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

Email: gjorgji.p@influencers.club
GitHub Issues: github.com/Influencers-Club/influencers-club-mcp/issues

Licencia

MIT