career-ops-plugin-tavily

June 30, 2026 · View on GitHub

A career-ops community plugin — Tavily search/extract for job scanning, liveness checks, and company research.

What it does

Supplements career-ops' zero-token ATS API scanning with web search via the Tavily API:

  • search hook — finds job postings across LinkedIn, Greenhouse, Lever, and Ashby via web search; results feed into the career-ops pipeline exactly like ATS scanner results
  • checkLiveness — fallback liveness check for non-ATS job postings (used by check-liveness.mjs when the ATS API is inconclusive)
  • researchCompany — deep company research queries for the deep mode

Setup

  1. Install: node plugins.mjs add tavily
  2. Add to .env: TAVILY_API_KEY=tvly-xxx
  3. Enable: node plugins.mjs enable tavily --confirm

Get a free Tavily API key at https://tavily.com.

Optional settings in config/plugins.yml:

tavily:
  role: "Instructional Designer"
  location: "Canada"
  maxResults: 10
  searchDepth: basic        # basic | advanced (advanced = 2x cost)

Author

Schlaflied

License

MIT