@mambalabsdev/ats-scrapers

Lightweight, dependency-free fetchers for public ATS job boards: Greenhouse, Lever, Ashby, Workday, and Rippling. Extracted from the Mamba Labs GTM Signal Intelligence actor suite so the same ATS logic is maintained in one place.

No runtime dependencies. Uses native fetch (Node 18 or newer). Every request is abort-bounded.

Install

npm install @mambalabsdev/ats-scrapers

Usage

import { detectATS, fetchGreenhouseJobs } from '@mambalabsdev/ats-scrapers';

// Detect which ATS a company uses and get its open roles in one call.
const result = await detectATS('stripe.com');
// { ats: 'greenhouse', jobs: [ { title, department, location, url, posted_date }, ... ], slug: 'stripe' }

// Or call a single board directly. Pass an explicit slug when it differs from
// the domain (for example clay.com uses the board slug "claylabs").
const gh = await fetchGreenhouseJobs('clay.com', { slug: 'claylabs', timeout: 8000 });
// { jobs: [...], slug: 'claylabs', is404: false }

API

All fetch*Jobs functions take (domain, options) and resolve to { jobs, slug, is404 }.

• detectATS(domain, options) returns { ats, jobs, slug }, where ats is the matching platform name or 'none'. Runs all five boards concurrently and returns the first non-empty result in platform precedence order (Greenhouse, Lever, Ashby, Workday, Rippling).
• fetchGreenhouseJobs(domain, options)
• fetchLeverJobs(domain, options)
• fetchAshbyJobs(domain, options)
• fetchWorkdayJobs(domain, options)
• fetchRipplingJobs(domain, options)
• deriveSlug(domain) returns the best-effort board slug used by default.

Options

| Key | Type | Default | Notes | |---|---|---|---| | signal | AbortSignal | none | An explicit abort signal. Takes precedence over timeout. | | timeout | number | 10000 | Per-request timeout in milliseconds, used when no signal is given. | | slug | string | derived | Override the board slug. Greenhouse, Lever, and Ashby honor this; Workday and Rippling discover their slug from the careers page and ignore it. |

Return shape

{
  jobs: [
    { title, department, location, url, posted_date } // posted_date is an ISO string or null
  ],
  slug,        // resolved board slug, or null
  is404        // true only when the board slug definitively does not exist (Greenhouse/Lever/Ashby)
}

Network and parse failures degrade gracefully to an empty jobs array rather than throwing, so a single unreachable board never breaks a caller.

Boards

| Board | Slug source | Notes | |---|---|---| | Greenhouse | domain or explicit slug | Public boards JSON API. | | Lever | domain or explicit slug | Public postings JSON API. | | Ashby | domain or explicit slug | Public posting API; unlisted roles filtered out. | | Workday | discovered from careers page | Scans /careers and /jobs for the tenant, then queries the cxs jobs endpoint. | | Rippling | discovered from careers page | Scans /careers and /jobs for the board, then tries the public jobs endpoints. |

License

ISC. Part of the Mamba Labs GTM Signal Intelligence suite.