/apple-jobs-collect

name: apple-jobs-collect
description: Collect recent public job postings from Apple's careers site (jobs.apple.com), default Korea, by keyword and location. Use when the user wants to gather, scan, or monitor Apple job listings for a role or region. Read-only — no login, save, or apply. Prints a normalized JSON array of postings.

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).