New Hire Finder

Encontre pessoas que começaram uma função correspondente em uma empresa dentro de um período de retrospectiva.

Documentação

Servidor MCP New Hire Finder

Um servidor MCP para o ator New Hire Finder da Mamba Labs na Apify. Encontre as pessoas que começaram um cargo em uma empresa nos últimos meses. Informe o domínio da empresa, os cargos que você vende e uma janela de tempo. Obtenha uma linha plana por pessoa: nome, URL do perfil, cargo, mês de início, cargo anterior, tipo de movimentação (nova contratação ou promoção interna) e a fonte que as encontrou.

O que ele faz

Encontre pessoas que começaram um cargo correspondente aos seus cargos em uma empresa dentro de uma janela de tempo. Informe company_domain (ou company_domains), target_titles e lookback_months. Retorna uma linha JSON plana e pronta para Clay por pessoa, com nome, URL do perfil, cargo, mês de início, cargo anterior, tipo de movimentação (nova contratação, promoção interna ou apenas anúncio) e fonte, além de uma linha de resumo por empresa que informa se alguém foi encontrado ou por que nada pôde ser pesquisado. Executa com suas próprias chaves Prospeo, Serper, SerpApi ou Exa passadas como entradas, e em uma lista de pessoas que você envia; nunca acessa o LinkedIn e não possui chave própria. Uma execução que não é bem-sucedida é retornada como erro com seu ID de execução. Somente leitura; requer um APIFY_TOKEN e consome créditos da Apify por chamada.

Todo o trabalho é executado na Apify. Este pacote é um cliente leve que inicia a execução do ator, aguarda e devolve as linhas do conjunto de dados.

Início rápido

Você precisa do Node.js 18 ou mais recente e de uma conta Apify com um token de API.

Adicione isto à sua configuração do Claude Desktop (claude_desktop_config.json), Cursor ou qualquer cliente MCP:

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

Reinicie o cliente. A ferramenta find_new_hires aparece.

Pré-requisitos

Node.js 18 ou mais recente.
Um token de API da Apify em console.apify.com/account/integrations, definido como APIFY_TOKEN. O servidor lista sua ferramenta sem token; uma chamada precisa de um.

Exemplos de prompts

"Quem entrou na example.com em um cargo de marketing nos últimos 6 meses?"
"Encontre novos líderes de conteúdo nessas 10 empresas desde junho."

Ferramenta

find_new_hires. Uma ferramenta. Exemplo de argumentos:

{
  "company_domain": "example.com",
  "target_titles": [
    "marketing"
  ],
  "lookback_months": "6"
}

Entradas

Todas as entradas voltadas ao comprador do ator ao vivo, inalteradas. Entradas omitidas assumem os padrões do próprio ator.

Entrada	Tipo	Obrigatória	Descrição
`company_domain`	string	não	Um domínio de empresa, por exemplo zapier.com. Use esta ou Domínios de empresa (em lote); ambos são mesclados.
`company_domains`	array	não	Uma lista de domínios de empresa. Cada empresa recebe sua própria linha de resumo.
`company_name`	string	não	Opcional, apenas para execuções de empresa única. Deixe vazio e o nome é lido da página inicial.
`target_titles`	array	não	Frases de cargo para correspondência, por exemplo marketing, head of content, editor. Um cargo corresponde quando contém cada palavra de uma frase como palavra inteira. Também enviado ao Prospeo e à pesquisa web como filtro de cargo.
`seniority`	array	não	Opcional. Mantenha apenas estes níveis de senioridade.
`departments`	array	não	Opcional. Mantenha apenas estes departamentos.
`exclude_titles`	array	não	Opcional. Remova qualquer cargo que contenha uma destas frases, por exemplo intern.
`expand_title_synonyms`	boolean	não	Também corresponde a uma lista curta de sinônimos (marketing também corresponde a growth, brand, demand generation). Desativado por padrão, porque cada linha é cobrada.
`lookback_months`	string	não	Quantos meses de calendário para trás olhar, incluindo o mês atual. 1 a 24, padrão 6. 6 em outubro significa maio a outubro. Digitado como texto para que o Clay possa enviá-lo.
`move_types`	array	não	Quais movimentações retornar e cobrar. new_hire é uma pessoa que veio de outro empregador. promotion é um novo cargo no mesmo empregador. unknown é um anúncio de contratação sem histórico de trabalho. Padrão apenas new_hire.
`include_year_only`	boolean	não	Também retorna pessoas cujo início é conhecido apenas pelo ano e pode cair dentro da janela. Elas são cobradas como qualquer linha. Desativado por padrão.
`people`	array	não	Pessoas que você já possui, com históricos de cargos. Cada item: person_name, company_domain, profile_url (opcional) e roles, uma lista de {title, company_name, start (AAAA-MM), end (AAAA-MM ou null)}. As mesmas regras de janela, cargo e movimentação são aplicadas a elas, sem chamada de provedor.
`sources`	array	não	Rotas a executar. Padrão todas. buyer_data é sua lista de pessoas; prospeo e web_search são executados apenas com sua chave; news, newsroom e team_pages são gratuitos.
`prospeo_api_key`	string	não	Sua própria chave Prospeo. Fornece o histórico de trabalho por trás do mês de início e do tipo de movimentação. Um crédito Prospeo por página de pesquisa de 25 pessoas e um por enriquecimento de pessoa, cobrado pelo Prospeo a você. Nunca armazenada. Sua própria chave, enviada como entrada de execução; nunca armazenada pelo ator.
`web_search_provider`	string	não	Qual de suas chaves de pesquisa usar. auto pega a primeira chave presente: Serper, depois SerpApi, depois Exa.
`serper_api_key`	string	não	Sua própria chave Serper.dev para pesquisa web. Uma pesquisa por empresa por padrão. Os resultados de pesquisa não trazem data de início, então são datados com sua chave Prospeo ou contados como sem data. Sua própria chave, enviada como entrada de execução; nunca armazenada pelo ator.
`serpapi_api_key`	string	não	Sua própria chave SerpApi para pesquisa web. Um fornecedor diferente do Serper. Sua própria chave, enviada como entrada de execução; nunca armazenada pelo ator.
`exa_api_key`	string	não	Sua própria chave Exa. A pesquisa de pessoas do Exa retorna históricos de trabalho com meses de início, então seus resultados não precisam de enriquecimento. Sua própria chave, enviada como entrada de execução; nunca armazenada pelo ator.
`max_people_per_company`	string	não	Número máximo de linhas de pessoas a retornar por empresa, começando pelos inícios mais recentes. 1 a 100, padrão 25.
`max_search_queries_per_company`	string	não	Consultas de pesquisa web por empresa com sua chave. 1 a 4, padrão 1.
`max_enrich_per_company`	string	não	Chamadas de enriquecimento Prospeo por empresa para datar pessoas encontradas por pesquisa web, manchetes e páginas de equipe. 0 a 25, padrão 5.
`max_prospeo_pages_per_company`	string	não	Páginas de pesquisa Prospeo de 25 pessoas por empresa. 1 a 4, padrão 1.
`max_charge_usd`	number	não	Opcional. A execução para antes de qualquer cobrança que levaria esta execução além deste valor e mantém todas as linhas já pagas. Deixe vazio para depender apenas do custo máximo por execução definido na Apify, que a execução também respeita.
`skip_cache`	boolean	não	Pesquisar novamente mesmo quando a mesma empresa e filtros foram executados nos últimos 7 dias. Um resultado em cache é retornado gratuitamente.

Preços

Pague por evento na Apify, cobrado na sua conta Apify. Preços em USD.

Evento	Plano gratuito	Bronze	Prata	Ouro
`new_hire_found`, por pessoa retornada	$0,085	$0,08075	$0,0765	$0,07225
`apify-actor-start`, por início de execução	$0,001	$0,001	$0,001	$0,001

Suas chaves

O ator não possui chave de provedor própria. Cada chave de provedor paga é sua, passada como entrada e armazenada pela Apify como entrada secreta. Sem uma chave, o ator pula essa etapa e informa isso na execução.

Documentação completa do ator

apify.com/mambalabs/new-hire-finder

Licença

MIT. Consulte LICENSE.