People Finder

Encontra pessoas em uma empresa por cargo e senioridade e, em seguida, verifica cada e-mail de trabalho antes de retornar o contato.

GitHub

Documentação

Servidor MCP People Finder & Email Verifier

Servidor MCP para o ator People Finder & Email Verifier da Mamba Labs na Apify.

Forneça um domínio de empresa, nome ou URL do LinkedIn e ele retorna as pessoas dessa empresa que correspondem aos seus filtros de cargo, senioridade e departamento, cada uma como um registro de contato estruturado com um e-mail comercial verificado opcional.

Instalação

npx -y @mambalabsdev/mcp-people-finder

Claude Desktop

{
  "mcpServers": {
    "mamba-people-finder": {
      "command": "npx",
      "args": ["-y", "@mambalabsdev/mcp-people-finder"],
      "env": { "APIFY_TOKEN": "your-apify-token" }
    }
  }
}

Obtenha um token da Apify em console.apify.com/account/integrations.

Ferramenta

`find_people_and_emails`

Entrada	Tipo	Obrigatório	Observações
`domain`	string	não	Domínio puro, sem https:// ou barra final. Exemplo: stripe.com
`company_name`	string	não	Usado quando não há domínio disponível, ou como dica de desambiguação junto com um domínio.
`linkedin_company_url`	string	não	Exemplo: https://www.linkedin.com/company/stripe. Ignora a resolução interna da empresa quando fornecido.
`domains`	array	não	Lista opcional de domínios puros. Tem precedência sobre o campo de domínio único. Cada domínio é pesquisado de forma independente e cada linha de saída ecoa seu domínio de origem.
`targetCount`	integer	não	Número máximo de pessoas a retornar por empresa. A cobrança é por pessoa efetivamente retornada, portanto um número menor é um limite rígido de custo. Padrão: 5.
`jobTitles`	array	não	Correspondência de substring sem diferenciar maiúsculas/minúsculas contra o cargo atual da pessoa. Qualquer correspondência qualifica. Deixe vazio para não aplicar filtro de cargo. Exemplo: VP de Vendas, Head de Growth
`excludeJobTitles`	array	não	Correspondência de substring sem diferenciar maiúsculas/minúsculas. Uma pessoa que corresponda a qualquer um destes é descartada, mesmo que corresponda a um filtro de inclusão. Exemplo: estagiário, assistente, ex-funcionário
`seniority`	array	não	Filtra para estes níveis de senioridade normalizados. Deixe vazio para todos.
`departments`	array	não	Filtra para estes departamentos normalizados. Deixe vazio para todos.
`countries`	array	não	Códigos ISO 3166-1 alfa-2. Filtra para pessoas localizadas nesses países. Exemplo: US, GB, NL
`includeEmails`	boolean	não	Descobre um e-mail comercial para cada pessoa encontrada, usando suas chaves Icypeas e/ou Prospeo. Cobrado apenas quando um e-mail é efetivamente retornado. Desative para montar um mapa organizacional de forma econômica. Padrão: true.
`verifyEmails`	boolean	não	Verifica a entregabilidade de cada e-mail encontrado, escalando domínios catch-all para um segundo provedor para uma resposta definitiva. Requer uma chave Reoon e/ou BounceBan. Padrão: true.
`verifyPosition`	boolean	não	Verifica se a pessoa ainda ocupa o cargo retornado na empresa-alvo e relata a justificativa. Reduz e-mails devolvidos para pessoas que já saíram. Padrão: false.
`suppressLinkedInUrls`	array	não	URLs de perfis do LinkedIn a excluir dos resultados. Use para suprimir prospects já contatados ou atender solicitações de remoção de dados do titular.
`batchSize`	integer	não	Quantas empresas pesquisar simultaneamente no modo em lote. Padrão 5, máximo 10. Padrão: 5.
`skipCache`	boolean	não	Os resultados são armazenados em cache por 7 dias e reutilizados em consultas repetidas. Defina como true para forçar uma nova pesquisa. Padrão: false.
`serpApiKey`	string	não	Chave da API Serper.dev. Desbloqueia a camada de busca, que é a fonte de maior cobertura de URLs de perfis do LinkedIn. Sem ela, este ator recorre apenas à análise do site da empresa, que retorna muito menos pessoas. Obtenha uma chave em https://serper.dev. Você é cobrado pela Serper pelas buscas; este ator não aplica margem sobre elas.
`prospeoApiKey`	string	não	Segundo provedor no fluxo de e-mails. Usado apenas para pessoas que o primeiro provedor não conseguiu resolver. Obtenha uma chave em https://prospeo.io. Cobrado diretamente pela Prospeo; este ator não aplica margem.
`reoonApiKey`	string	não	Verificação primária de e-mail. Retorna o status de entregabilidade para cada endereço descoberto. Obtenha uma chave em https://emailverifier.reoon.com. Cobrado diretamente pela Reoon.
`bounceBanApiKey`	string	não	Resolução de catch-all. Usado apenas quando o verificador primário retorna catch-all ou arriscado, para determinar se aquele endereço específico existe. Obtenha uma chave em https://bounceban.com. Cobrado diretamente pela BounceBan.
`icypeasApiKey`	string	não	Opcional. Usado apenas na camada de fallback de banco de dados licenciado, que é executada quando o site da empresa e os resultados de busca pública não geram pessoas suficientes. Deixe vazio para pular essa camada completamente; a execução ainda é concluída com sucesso e relata qualquer deficiência no resumo.
`claudeApiKey`	string	não	Opcional. Usado apenas para classificar cargos que a tabela de regras integrada não consegue enquadrar em senioridade e departamento. Uma chamada em lote por execução, nunca por pessoa. Deixe vazio para deixar esses dois campos nulos nas linhas afetadas.

Cobrança

Você é cobrado por empresa pesquisada, por pessoa encontrada, por e-mail encontrado, por e-mail verificado, por cargo verificado e por consulta SERP, além de uma pequena taxa de início do ator. Um targetCount menor é um limite rígido de custo.

Os preços estão na página do ator na Apify. Executar este servidor consome créditos da Apify.

O que este servidor faz e não faz

É um cliente leve para o ator da Apify. Ele transmite sua entrada e retorna a saída do ator sem alterações. Todo comportamento descrito acima reside no ator, não aqui.

Erros são exibidos, nunca engolidos. Uma entrada inválida, um token inválido, um saldo esgotado, um timeout ou uma execução que retorne algo diferente de um conjunto de dados aparecem como um erro explícito da ferramenta, e não como um resultado vazio.

Fonte

O ator está na Apify Store. Este wrapper é licenciado sob MIT.

Desenvolvido pela Mamba Labs