New Hire Finder

Encuentra personas que comenzaron un rol coincidente en una empresa dentro de un período de retroceso.

Documentación

Servidor MCP New Hire Finder

Un servidor MCP para el actor New Hire Finder de Mamba Labs en Apify. Encuentra a las personas que comenzaron un puesto en una empresa en los últimos meses. Proporciona un dominio de empresa, los títulos a los que vendes y una ventana de tiempo hacia atrás. Obtén una fila plana por persona: nombre, URL de perfil, título, mes de inicio, puesto anterior, tipo de movimiento (nueva contratación o promoción interna) y la fuente que los encontró.

Qué hace

Encuentra personas que comenzaron un puesto que coincida con tus títulos en una empresa dentro de una ventana de tiempo hacia atrás. Proporciona company_domain (o company_domains), target_titles y lookback_months. Devuelve una fila JSON plana y lista para Clay por persona con nombre, URL de perfil, título, mes de inicio, puesto anterior, tipo de movimiento (nueva contratación, promoción interna o solo anuncio) y fuente, más una fila de resumen por empresa que indica si se encontró a alguien o por qué no se pudo buscar. Se ejecuta con tus propias claves de Prospeo, Serper, SerpApi o Exa pasadas como entradas, y en una lista de personas que envíes; nunca consulta LinkedIn y no posee ninguna clave propia. Una ejecución que no tiene éxito se devuelve como un error con su ID de ejecución. Solo lectura; requiere un APIFY_TOKEN y consume créditos de Apify por llamada.

Todo el trabajo se ejecuta en Apify. Este paquete es un cliente ligero que inicia la ejecución del actor, espera a que termine y devuelve las filas del conjunto de datos.

Inicio rápido

Necesitas Node.js 18 o más reciente y una cuenta de Apify con un token de API.

Agrega esto a tu configuración de Claude Desktop (claude_desktop_config.json), Cursor o cualquier cliente MCP:

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

Reinicia el cliente. Aparece la herramienta find_new_hires.

Requisitos previos

Node.js 18 o más reciente.
Un token de API de Apify desde console.apify.com/account/integrations, configurado como APIFY_TOKEN. El servidor muestra su herramienta sin token; una llamada necesita uno.

Ejemplos de indicaciones

"¿Quién se unió a example.com en un puesto de marketing en los últimos 6 meses?"
"Encuentra nuevos jefes de contenido en estas 10 empresas desde junio."

Herramienta

find_new_hires. Una herramienta. Ejemplo de argumentos:

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

Entradas

Cada entrada orientada al comprador del actor en vivo, sin cambios. Las entradas omitidas toman los valores predeterminados del propio actor.

Entrada	Tipo	Obligatoria	Descripción
`company_domain`	string	no	Un dominio de empresa, por ejemplo zapier.com. Usa esto o Dominios de empresa (lote); ambos se combinan.
`company_domains`	array	no	Una lista de dominios de empresa. Cada empresa recibe su propia fila de resumen.
`company_name`	string	no	Opcional, solo para ejecuciones de una sola empresa. Déjalo vacío y el nombre se lee desde la página de inicio.
`target_titles`	array	no	Frases de título para coincidir, por ejemplo marketing, jefe de contenido, editor. Un título coincide cuando contiene cada palabra de una frase como palabra completa. También se envía a Prospeo y a la búsqueda web como filtro de título.
`seniority`	array	no	Opcional. Conserva solo estos niveles de antigüedad.
`departments`	array	no	Opcional. Conserva solo estos departamentos.
`exclude_titles`	array	no	Opcional. Elimina cualquier título que contenga una de estas frases, por ejemplo becario.
`expand_title_synonyms`	boolean	no	También coincide con una lista corta de sinónimos (marketing también coincide con growth, brand, demand generation). Desactivado por defecto, porque cada fila se cobra.
`lookback_months`	string	no	Cuántos meses calendario hacia atrás mirar, incluido el mes actual. De 1 a 24, predeterminado 6. 6 en octubre significa de mayo a octubre. Escrito como texto para que Clay pueda enviarlo.
`move_types`	array	no	Qué movimientos devolver y cobrar. new_hire es una persona que vino de otro empleador. promotion es un nuevo puesto en el mismo empleador. unknown es un anuncio de contratación sin historial laboral. Predeterminado solo new_hire.
`include_year_only`	boolean	no	También devuelve personas cuyo inicio se conoce solo por el año y podría caer dentro de la ventana. Se cobran como cualquier fila. Desactivado por defecto.
`people`	array	no	Personas que ya tienes, con historiales de puestos. Cada elemento: person_name, company_domain, profile_url (opcional) y roles, una lista de {title, company_name, start (AAAA-MM), end (AAAA-MM o null)}. Las mismas reglas de ventana, título y movimiento se aplican a ellos, sin llamada a proveedor.
`sources`	array	no	Rutas a ejecutar. Predeterminado todas. buyer_data es tu lista de personas; prospeo y web_search se ejecutan solo con tu clave; news, newsroom y team_pages son gratuitas.
`prospeo_api_key`	string	no	Tu propia clave de Prospeo. Proporciona el historial laboral detrás del mes de inicio y el tipo de movimiento. Un crédito de Prospeo por página de búsqueda de 25 personas y uno por enriquecimiento de persona, facturado por Prospeo a ti. Nunca se almacena. Tu propia clave, enviada como entrada de ejecución; nunca almacenada por el actor.
`web_search_provider`	string	no	Cuál de tus claves de búsqueda usar. auto toma la primera clave presente: Serper, luego SerpApi, luego Exa.
`serper_api_key`	string	no	Tu propia clave de Serper.dev para búsqueda web. Una búsqueda por empresa por defecto. Los resultados de búsqueda no llevan fecha de inicio, por lo que se fechan con tu clave de Prospeo o se cuentan como sin fecha. Tu propia clave, enviada como entrada de ejecución; nunca almacenada por el actor.
`serpapi_api_key`	string	no	Tu propia clave de SerpApi para búsqueda web. Un proveedor diferente de Serper. Tu propia clave, enviada como entrada de ejecución; nunca almacenada por el actor.
`exa_api_key`	string	no	Tu propia clave de Exa. La búsqueda de personas de Exa devuelve historiales laborales con meses de inicio, por lo que sus resultados no necesitan enriquecimiento. Tu propia clave, enviada como entrada de ejecución; nunca almacenada por el actor.
`max_people_per_company`	string	no	La mayoría de filas de personas a devolver por empresa, los inicios más recientes primero. De 1 a 100, predeterminado 25.
`max_search_queries_per_company`	string	no	Consultas de búsqueda web por empresa con tu clave. De 1 a 4, predeterminado 1.
`max_enrich_per_company`	string	no	Llamadas de enriquecimiento de Prospeo por empresa para fechar personas encontradas por búsqueda web, titulares y páginas de equipo. De 0 a 25, predeterminado 5.
`max_prospeo_pages_per_company`	string	no	Páginas de búsqueda de Prospeo de 25 personas por empresa. De 1 a 4, predeterminado 1.
`max_charge_usd`	number	no	Opcional. La ejecución se detiene antes de cualquier cargo que llevaría esta ejecución más allá de este monto, y conserva cada fila ya pagada. Déjalo vacío para confiar solo en el costo máximo por ejecución establecido en Apify, que la ejecución también respeta.
`skip_cache`	boolean	no	Buscar de nuevo incluso cuando la misma empresa y filtros se ejecutaron en los últimos 7 días. Un resultado en caché se devuelve gratis.

Precios

Paga por evento en Apify, facturado a tu cuenta de Apify. Precios en USD.

Evento	Plan gratuito	Bronce	Plata	Oro
`new_hire_found`, por persona devuelta	$0.085	$0.08075	$0.0765	$0.07225
`apify-actor-start`, por inicio de ejecución	$0.001	$0.001	$0.001	$0.001

Tus claves

El actor no posee ninguna clave de proveedor propia. Cada clave de proveedor de pago es tuya, se pasa como entrada y Apify la almacena como entrada secreta. Sin una clave, el actor omite ese paso y lo indica en la ejecución.

Documentación completa del actor

apify.com/mambalabs/new-hire-finder

Licencia

MIT. Consulta LICENSE.