devrunner-collect

name	devrunner-collect
description	Collect recent public developer job postings from DevRunner (devrunner.dev) by keyword. Use when the user wants to gather, scan, or monitor DevRunner listings for a role, stack, or company. Read-only — no login, save, or apply. Prints a normalized JSON array of postings.

DevRunner Collect

Collect recent public postings from DevRunner's /jobs listing and return normalized JSON (docs/SCHEMA.md). Self-contained: this skill's collect.py carries its own fetch + parse and depends only on curl_cffi, beautifulsoup4, lxml.

Boundaries

• Read-only. GET of the public /jobs listing only. Never log in, save a job, message, or apply. Do not submit any form.
• No fabrication. Fields the source does not expose are null; titles, companies, dates, and tags are copied verbatim from the page's own data.
• A collected posting reflects the page at run time; it is not proof the role is still open.

Run

If collect.py fails with ModuleNotFoundError, install the deps yourself (pip install curl_cffi beautifulsoup4 lxml) and retry — do not ask the user to install anything.

pip install curl_cffi beautifulsoup4 lxml   # or: pip install -r requirements.txt

python3 skills/devrunner-collect/collect.py --query "backend" --limit 20

• --query, -q — filter the listing by title/company/summary/tech substring (client-side; see Notes).
• --limit, -n — max postings (default 20).
• --pretty — indent the JSON.

Output: a JSON array on stdout; a one-line count on stderr. DevRunner exposes title, company, location, employment type, position category, tech categories, a one-line summary, created date (→ posted_at), end date (→ deadline), and compensation when present (→ salary).

Notes

• Source: SRC-JOB-DEVRUNNER — https://devrunner.dev/ (collectible_open, verified 2026-07-07).
• The /jobs page is a JS (Next.js) app, but its server response embeds the full initial job list (~200 postings) as data in the RSC flight stream (self.__next_f → initialJobs.jobs[]). collect.py parses that embedded JSON directly, so no browser is required. external_id is the numeric jobId; canonical posting URL: /jobs/<jobId>.
• Because the whole initial list is embedded, --query filters it client-side. DevRunner's server-side filters/pagination are JS-driven; collecting results beyond the embedded initial list would need a browser.
• If DevRunner changes its RSC shape and 0 postings return, re-derive the initialJobs/"jobs":[ extraction against a live fetch (do not hardcode a specific company).