@mambalabsdev/ats-scrapers

@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.