jobgrep

jobgrep is a Node.js CLI for searching recent jobs across Ashby, Greenhouse, Lever, and Workable listings using SerpAPI-backed Google results.

Install

npx jobgrep sources

npm install -g jobgrep
jobgrep sources

Setup

jobgrep needs a SerpAPI key for search.

Use an environment variable:

export SERPAPI_API_KEY=your_key_here
jobgrep search --role "frontend engineer"

Or save the key once in the app config directory:

jobgrep auth set your_key_here
jobgrep auth show

Auth precedence:

1. SERPAPI_API_KEY
2. saved config from jobgrep auth set

Quick Start

jobgrep search --role "frontend engineer" --location London --date 7d
jobgrep search --role "product designer" --json
jobgrep search --role "backend engineer" --csv --pages 3
jobgrep sources

Commands

jobgrep search

Search recent job listings across supported boards.

Options:

• --role <role>: required role or title query
• --level <level>: junior, mid, or senior
• --location <location>: location substring match
• --date <range>: 24h, 7d, or 30d
• --limit <count>: maximum results to return, default 20
• --pages <count>: number of SerpAPI pages to fetch
• --refresh: bypass SerpAPI cache
• --json: emit JSON
• --csv: emit CSV

jobgrep sources

Print supported job board domains and local config path.

jobgrep auth set <apiKey>

Save a SerpAPI key in the local app config directory.

jobgrep auth show

Show whether jobgrep can resolve a key and whether it came from the environment or local config.

jobgrep auth clear

Remove the saved local key.

Output Modes

• Default output is a table for terminal use.
• --json emits machine-readable JSON.
• --csv emits CSV with company,title,location,board,url,postedAt,foundAt.

Supported Boards

• Ashby: jobs.ashbyhq.com
• Greenhouse: boards.greenhouse.io
• Greenhouse hosted boards: job-boards.greenhouse.io
• Lever: jobs.lever.co
• Workable: apply.workable.com

Notes

• Searches use live SerpAPI Google results constrained to supported board domains.
• One SerpAPI page is fetched by default; use --pages N for deeper pagination.
• --refresh forces a fresh SerpAPI request with no_cache=true.
• sources does not require authentication.

Release

pnpm test
npm pack --dry-run
npm publish