# ATS SDK
> An open-source TypeScript SDK for Applicant Tracking Systems. 9 adapters. One typed SDK.

ATS SDK is an open-source TypeScript SDK (npm: `ats-sdk`) for ingesting job postings from company ATS systems — Greenhouse, Ashby, Lever, Workday, BambooHR, SmartRecruiters, Workable, Recruitee, and Breezy HR — behind one typed SDK with retries and standardized schemas.

## Install
```bash
npm install ats-sdk
# or
bun add ats-sdk
```

## Quickstart
```ts
import { createAtsClient } from "ats-sdk";
import { greenhouse } from "ats-sdk/greenhouse";
import { ashby } from "ats-sdk/ashby";

const ats = createAtsClient({
  sources: [
    greenhouse({ boardToken: "stripe" }),
    ashby({ boardToken: "openai" })
  ]
});

const { jobs } = await ats.getJobs();
```

## AI Agent Integration
```ts
import { createAtsAgentTools } from "ats-sdk/agent-tools";

// Returns fetch_company_jobs, search_configured_jobs, test_ats_board
const tools = createAtsAgentTools(ats);
```

## Supported Adapters
- Greenhouse: `ats-sdk/greenhouse` (public boards API)
- Ashby: `ats-sdk/ashby` (posting API with compensation)
- Lever: `ats-sdk/lever` (postings API)
- Workday: `ats-sdk/workday` (CXS job endpoint)
- BambooHR: `ats-sdk/bamboohr` (careers portal endpoint)
- SmartRecruiters: `ats-sdk/smartrecruiters` (company postings API)
- Workable: `ats-sdk/workable` (widget API)
- Recruitee: `ats-sdk/recruitee` (offers API)
- Breezy HR: `ats-sdk/breezy` (portal JSON endpoint)

## Links
- Website: https://ats-sdk.dev
- Repository: https://github.com/agentcareer/agentcareer
- Discovery: https://ats-sdk.dev/.well-known/agent.json