A plugin that watches the job boards of companies you chose, through their public APIs, and files new openings for review #1103

New issue

Open

opened 2026-10-30 21:25:19 +00:00 by tiagoagueda · 0 comments

tiagoagueda commented

2026-10-30 21:25:19 +00:00

Owner

What exists today

#241 item 1 proposes ATS sources reading public JSON rather than HTML.
Captures wait for review; nothing is recorded without the person.
The sync kind (SyncPlugin) runs on the scheduler's interval, with a lease and a report.
The core's board recipes read LinkedIn and Greenhouse pages one at a time.

What would change

A new plugin repository: on a company, "Watch its job board" with the board's address; the plugin recognises the system from the address.
Each run reads that board, files new openings as captures, and marks as closed the listings whose opening disappeared.
Optional keyword and place filters per watch.

Decisions

Bulk scraping. The project does not scrape boards in bulk. Recommended reading: a list of companies the person named, each read through its documented public API at most once a day, is not that. The README should say so in those words.
Kind. Recommended: sync, which has the scheduler, the lease and the report already.
Which systems first. Recommended: Greenhouse and Lever, the simplest public APIs, then Ashby, then the rest on demand.

Checked against main at daee30b15 (2026-10-30). From the status review and feature suggestions of 2026-10-30.

Many employers publish their openings as JSON through their applicant tracking system: Lever, Greenhouse, Ashby, Personio, SmartRecruiters, Workable. #241 proposes sources that read them. This proposes the form: a plugin that watches the boards of the companies a person chose and files new openings as captures for review. ## What exists today - #241 item 1 proposes ATS sources reading public JSON rather than HTML. - Captures wait for review; nothing is recorded without the person. - The sync kind (`SyncPlugin`) runs on the scheduler's interval, with a lease and a report. - The core's board recipes read LinkedIn and Greenhouse pages one at a time. ## What would change - A new plugin repository: on a company, "Watch its job board" with the board's address; the plugin recognises the system from the address. - Each run reads that board, files new openings as captures, and marks as closed the listings whose opening disappeared. - Optional keyword and place filters per watch. ## Decisions - **Bulk scraping.** The project does not scrape boards in bulk. Recommended reading: a list of companies the person named, each read through its documented public API at most once a day, is not that. The README should say so in those words. - **Kind.** Recommended: sync, which has the scheduler, the lease and the report already. - **Which systems first.** Recommended: Greenhouse and Lever, the simplest public APIs, then Ashby, then the rest on demand. Checked against `main` at `daee30b15` (2026-10-30). From the status review and feature suggestions of 2026-10-30.

tiagoagueda added this to the 1.0.0 milestone

2026-10-30 21:25:19 +00:00

tiagoagueda added the

enhancement

label

2026-10-30 21:25:19 +00:00

tiagoagueda referenced this issue

2026-10-30 21:25:22 +00:00

Plugins worth writing next: ATS job-board sources, a WebDAV store, a LinkedIn export importer, modern mail sign-in, real templates #241