apple-jobs-collect

Apple Jobs Collect

Collect recent public postings from Apple's careers search 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 search page 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, locations, and dates are copied verbatim.
• A collected posting reflects the public 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/apple-jobs-collect/collect.py --limit 20
python3 skills/apple-jobs-collect/collect.py --query "engineer" --limit 10

• --query, -q — search keyword (optional; omitted = all Korea postings).
• --location, -l — Apple location filter slug (default korea-republic-of-KOR).
• --limit, -n — max postings (default 20; the collector pages through 20-per-page results until the limit or totalRecords is reached).
• --pretty — indent the JSON.

Output: a JSON array on stdout; a one-line count on stderr. Apple exposes title, location, posting date, and a job-summary snippet; company is Apple (this is Apple's own board). employment_type, deadline, and salary are null — the Korea search results do not expose them.

Notes

• Source: SRC-JOB-APPLE — https://jobs.apple.com/ (collectible_open, re-verified 2026-07-07). Korea search returned 23 total records at verification.
• The search page is server-rendered: results ship inside a window.__staticRouterHydrationData JSON blob (loaderData.search.searchResults), parsed directly — no separate JSON API call.
• external_id is the numeric positionId. Posting detail URL: /en-us/details/<positionId>/<transformedPostingTitle>?team=<teamCode>.
• If Apple changes the hydration key and 0 postings return, re-derive the window.__staticRouterHydrationData / searchResults path against a live fetch (do not hardcode a specific role or req id).