Influencers Club Creator Marketing MCP

MCP para acessar o maior banco de dados de descoberta e enriquecimento de influenciadores do mundo

Documentação

Servidor MCP do Influencers Club

Beta — Este projeto está em desenvolvimento ativo. Funciona e pode ser testado, mas espere mudanças antes do lançamento estável.

Servidor MCP para a API do Influencers Club — enriquecimento de criadores, descoberta, análise de audiência, dados de conteúdo, operações em lote e gerenciamento de conta.

Duas formas de usar:

	Melhor para
Conector hospedado (claude.ai, ChatGPT)	Sem instalação — conecte-se uma vez com sua conta do Influencers Club
Instalação local (stdio)	Claude Desktop / Claude Code / IDEs, além de ferramentas locais de arquivo (exportação CSV, upload em lote)

Uso com claude.ai (Conector Hospedado)

O servidor hospedado roda em https://mcp-dashboard.influencers.club/mcp e faz login com OAuth — sem necessidade de copiar chave de API.

No Claude, abra Configurações → Conectores → Adicionar conector personalizado (ou encontre Influencers Club no diretório de conectores).
Insira a URL: https://mcp-dashboard.influencers.club/mcp
Clique em Conectar — você será redirecionado ao painel do Influencers Club para entrar e aprovar o acesso.
Pronto. Pergunte ao Claude coisas como "Encontre 5 criadores de Instagram na área de fitness com 50k-500k seguidores."

Requisitos: uma conta Influencers Club com créditos de API. As ferramentas de descoberta e enriquecimento consomem créditos (os custos estão listados em cada ferramenta e nas tabelas abaixo); as ferramentas de dicionário/consulta são gratuitas.

Observações:

O conector hospedado expõe as 19 ferramentas de API. As ferramentas de arquivo e lote (exportação CSV, enriquecimento CSV em massa) precisam de um sistema de arquivos local e estão disponíveis apenas na instalação local.
Conexão expirada / erros 401: desconecte e reconecte o conector para reautenticar.
Erros de "créditos insuficientes": recarregue no painel; as chamadas continuarão falhando até que o saldo fique positivo.

Uso com ChatGPT (Modo Desenvolvedor)

O mesmo servidor hospedado funciona como conector do ChatGPT:

No ChatGPT, ative Configurações → Apps → Configurações avançadas → Modo desenvolvedor (disponível nos planos Plus, Pro, Business, Enterprise e Edu).
Adicione um novo conector com a URL: https://mcp-dashboard.influencers.club/mcp
Clique em Conectar — você será redirecionado ao painel do Influencers Club para entrar e aprovar o acesso.
Pronto. As mesmas 19 ferramentas de API estão disponíveis; os requisitos de crédito e as observações da seção do claude.ai se aplicam sem alterações.

Instalação Local (stdio)

Pré-requisitos

Python 3.10+ ou Docker Desktop
Uma chave de API do Influencers Club

Início Rápido (pip)

pip install influencers-club-mcp

Ou instale a partir do código-fonte:

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

Em seguida, adicione ao claude_desktop_config.json do seu Claude Desktop:

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

Reinicie o Claude Desktop — o servidor aparecerá como "influencers-club". É isso.

Para onde vão os arquivos? Por padrão, os CSVs exportados e os uploads são salvos em exports/ e imports/ dentro da pasta do repositório clonado. Nenhuma configuração extra é necessária.

Para usar um local personalizado, adicione estas variáveis de ambiente:
"EXPORT_HOST_DIR": "/your/custom/exports",
"IMPORT_HOST_DIR": "/your/custom/imports",
"OUTPUT_DIR": "/your/custom/exports",
"IMPORTS_DIR": "/your/custom/imports"

Claude Code

Adicione ao .mcp.json do seu projeto ou ao ~/.claude/settings.json global:

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

VS Code / Cursor

Adicione ao .vscode/mcp.json no seu projeto:

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

Docker (Avançado)

Use Docker se quiser isolamento do sistema de arquivos ou preferir implantações em contêineres.

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

Adicione ao claude_desktop_config.json do seu 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"
      ]
    }
  }
}

Observação: Substitua /path/to/exports e /path/to/imports pelos caminhos reais da sua máquina. O caminho aparece 4 vezes — atualize todos.

Exemplos por sistema operacional:

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

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

Após configurar, reinicie seu cliente. O servidor aparecerá como "influencers-club".

Ferramentas Disponíveis (29)

19 ferramentas de API estão disponíveis em todos os lugares (conector hospedado e local). As ferramentas marcadas como somente local precisam do sistema de arquivos local, portanto existem apenas em instalações stdio.

Descoberta de Criadores

Ferramenta	Descrição	Custo
`discover_creators`	Busca semântica com IA e filtros (seguidores, engajamento, localização, etc.)	0.01/criador
`discover_creators_to_file` (somente local)	Descoberta em várias páginas com exportação CSV para disco	0.01/criador
`find_similar_creators`	Encontre criadores semelhantes a um criador de referência	0.01/criador
`audience_overlap`	Compare a sobreposição de audiência entre 2 a 10 criadores	1 crédito

Enriquecimento

Ferramenta	Descrição	Custo
`enrich_by_handle`	Perfil completo enriquecido: e-mail, dados demográficos, audiência, renda, parcerias com marcas	1 crédito
`enrich_by_handle_raw`	Dados básicos do perfil: bio, seguidores, status de verificação	0.03 créditos
`enrich_by_email`	Encontre perfis de criadores a partir de um e-mail	0.05 créditos
`connected_socials`	Descubra todas as contas sociais vinculadas a um criador	0.5 créditos

Dados de Conteúdo

Ferramenta	Descrição	Custo
`get_creator_posts`	Busque postagens recentes com métricas de engajamento (IG, TikTok, YouTube)	0.15 créditos
`get_post_details`	Análise profunda de conteúdo (comentários, transcrição, áudio)	0.03 créditos

Enriquecimento em Lote (somente local)

Ferramenta	Descrição	Custo
`create_batch_enrichment`	Envie CSV com até 10.000 handles/e-mails para processamento em massa	varia
`get_batch_status`	Verifique o progresso do job em lote (verificação automática a cada 35s)	grátis
`download_batch_results`	Baixe os resultados do lote concluído como CSV	grátis
`resume_batch`	Retome um lote pausado após adicionar créditos	grátis

Gerenciamento de Arquivos (somente local)

Ferramenta	Descrição	Custo
`get_upload_url`	Obtenha a URL da página de upload no navegador para arquivos CSV em lote	grátis
`wait_for_upload`	Detecção automática quando um arquivo foi enviado	grátis
`list_import_files`	Liste arquivos CSV enviados prontos para enriquecimento	grátis
`list_export_files`	Liste arquivos de resultados exportados	grátis
`setup_export_path`	Configure onde os arquivos exportados são salvos	grátis

Dados de Referência da Descoberta

Ferramenta	Descrição	Custo
`get_languages`	Idiomas disponíveis para filtragem	grátis
`get_locations`	Localizações disponíveis por plataforma	grátis
`get_brands`	Identificadores de marca disponíveis	grátis
`get_youtube_topics`	Tópicos do YouTube disponíveis	grátis
`get_games`	Jogos do Twitch disponíveis	grátis
`get_audience_brand_categories`	Categorias de marca da audiência	grátis
`get_audience_brand_names`	Nomes de marcas da audiência	grátis
`get_audience_interests`	Categorias de interesse da audiência	grátis
`get_audience_locations`	Localizações geográficas da audiência	grátis

Conta

Ferramenta	Descrição	Custo
`check_credits`	Verifique o saldo de créditos da conta	grátis

Exemplos de Uso

Encontre influenciadores de fitness no Instagram:

"Encontre 5 criadores de Instagram com 50k-500k seguidores que postam sobre fitness e tenham taxa de engajamento acima de 3%."

Enriqueça o perfil de um criador pelo handle:

"Me dê o perfil completo de @cristiano no Instagram, incluindo dados demográficos da audiência."

Encontre criadores semelhantes para escalar campanhas:

"Gosto do criador @MrBeast no YouTube. Encontre 10 criadores semelhantes com pelo menos 100k seguidores."

Compare a sobreposição de audiência:

"Compare a sobreposição de audiência entre @nike, @adidas e @puma no Instagram."

Obtenha as postagens recentes de um criador:

"Mostre as postagens mais recentes de @garyvee no TikTok com métricas de engajamento."

Encontre todas as contas sociais vinculadas:

"Quais outras contas de redes sociais @cristiano tem vinculadas ao Instagram?"

Verifique seus créditos de API restantes:

"Quantos créditos ainda tenho?"

Plataformas Suportadas

Capacidade	Plataformas
Enriquecimento	Instagram, TikTok, YouTube, OnlyFans, X/Twitter, Twitch, LinkedIn (somente modo bruto)
Descoberta	Instagram, TikTok, YouTube, OnlyFans, X/Twitter, Twitch
Dados de Conteúdo	Instagram, TikTok, YouTube
Sobreposição de Audiência	Instagram, TikTok, YouTube

Variáveis de Ambiente (instalação local)

Variável	Obrigatória	Padrão	Descrição
`INFLUENCERS_CLUB_API_KEY`	Sim	—	Sua chave de API do Influencers Club
`UPLOAD_PORT`	Não	8090	Porta para a página de upload no navegador
`UPLOAD_BIND`	Não	127.0.0.1	Endereço de bind. Defina como `0.0.0.0` dentro do Docker.
`UPLOAD_HOST`	Não	localhost	Hostname para a URL de upload. Defina como seu IP se o Docker rodar remotamente.
`EXPORT_HOST_DIR`	Não	—	Caminho do host para arquivos exportados
`IMPORT_HOST_DIR`	Não	—	Caminho do host para arquivos enviados
`MAX_CALLS_PER_MINUTE`	Não	300	Limite de taxa no lado do cliente

Solução de Problemas

O conector hospedado mostra "desconectado" ou as ferramentas retornam 401 — remova e adicione novamente o conector (ou clique em Reconectar) para atualizar a sessão OAuth.
Erros mencionando créditos ou limites — verifique seu saldo com check_credits ou no painel; as chamadas falham até que o limite seja redefinido ou créditos sejam adicionados.
Local: o servidor não aparece no Claude Desktop — verifique se o JSON de configuração é válido e reinicie o aplicativo; confirme que influencers-club-mcp roda a partir de um terminal.
Local: página de upload inacessível — outro processo pode estar usando a porta 8090; defina UPLOAD_PORT para uma porta livre.
Qualquer outra coisa: abra uma issue ou envie um e-mail para gjorgji.p@influencers.club.

Política de Privacidade

Este servidor MCP é um cliente leve entre o assistente de IA conectado (ex.: Claude ou ChatGPT) e a API do Influencers Club. As seções abaixo descrevem o que o próprio servidor faz com seus dados; as práticas completas de dados da plataforma Influencers Club são regidas pela Política de Privacidade do Influencers Club.

Dados que coletamos. Nenhum. O servidor não coleta, persiste ou transmite informações pessoalmente identificáveis sobre o usuário humano do assistente de IA. As únicas entradas que recebe são os argumentos de ferramenta que o assistente envia (ex.: um handle de criador ou um caminho de CSV) e o bearer token usado para autenticar na API do Influencers Club.

Como os dados são usados. Os argumentos de ferramenta são encaminhados diretamente à API do Influencers Club para executar a operação solicitada (descoberta, enriquecimento, processamento em lote, etc.). As respostas são retornadas ao assistente. O servidor não realiza análises, criação de perfis ou treinamento de modelos com esses dados.

Armazenamento. O servidor não mantém banco de dados. Os únicos dados gravados em disco são: (a) exportações/importações CSV que o usuário cria explicitamente pelas ferramentas de arquivo, gravadas em diretórios locais controlados pelo usuário (exports/, imports/ ou caminhos definidos por EXPORT_HOST_DIR / IMPORT_HOST_DIR); (b) um pequeno arquivo .ic_config.json que armazena o caminho de exportação escolhido. Nenhum conteúdo de conversa, resposta de API ou credencial é persistido.

Compartilhamento com terceiros. O servidor se comunica com exatamente um terceiro: a API do Influencers Club. Nenhum dado é enviado a qualquer outro endpoint, serviço de análise ou provedor de telemetria. O bearer token é transmitido apenas à API do Influencers Club via HTTPS e é removido de qualquer mensagem de erro retornada ao assistente.

Retenção. O servidor não retém nada em processo além da duração de uma única chamada de ferramenta, com exceção dos arquivos CSV controlados pelo usuário descritos acima, que o usuário pode excluir a qualquer momento. Os bearer tokens são lidos de variáveis de ambiente (ou, no modo hospedado/HTTP, da requisição autenticada) e nunca são gravados em disco.

Contato. Perguntas sobre privacidade e solicitações de exclusão de dados: gjorgji.p@influencers.club. Divulgações de segurança também podem ser registradas via GitHub Issues.

Suporte

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

Licença

MIT