mcpField
A
apple-jobs-research

apple-jobs-research

github.com/crawlora-orgOther141 installsUpdated 1d ago
Repository

About apple-jobs-research

apple-jobs-research is a skill for searching Apple's public careers listings through the Crawlora API. It returns search metadata and fetches full descriptions and qualifications for individual postings by ID.

Key features

  1. 01Search Apple job listings
  2. 02Filter search by location
  3. 03Paginate through search results
  4. 04Fetch full posting by ID
  5. 05Retrieve qualifications and description

Use cases

  1. 01Find Apple roles by keyword and location
  2. 02Review a posting's full requirements
  3. 03Look up an Apple job from its ID
  4. 04Search for retail or evergreen roles

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/crawlora-org/crawlora-skills --skill apple-jobs-research

After installing, type/apple-jobs-researchin Claude Code to confirm it loaded.

Bundled filesreference/endpoints.mdscripts/crawlora.sh

Details

From the project README

Apple Jobs search

Search Apple's public careers site and pull full posting detail — all as normalized JSON from the Crawlora API, no scraping jobs.apple.com by hand.

When to use this skill

  • "Search for jobs at Apple in ."
  • "What is Apple currently hiring for on the team?"
  • "Pull the full description and qualifications for Apple job ."
  • "Is Apple hiring for retail / evergreen roles in ?"

Setup (one-time)

  • Get a free Crawlora API key (2,000 credits/mo, no card) at https://crawlora.net.
  • Set CRAWLORA_API_KEY in the environment before running the helper.
  • The helper reads CRAWLORA_API_KEY from the environment and sends requests to https://api.crawlora.net/api/v1. Missing/invalid key → 401.

How it works

  1. Search — /apple-jobs/search (q required, location and page optional) searches jobs.apple.com's server-rendered search page. Page size is fixed by Apple at 20 results per page; results carry identity/location/ team metadata only, not the full description.
  2. Job detail — /apple-jobs/job (id required) fetches one posting's full description and qualifications by the id field returned from search (a specific requisition like 200674676-0836, or an evergreen/ pipeline retail role like PIPE-200314122).

Full endpoint list, methods, and params: reference/endpoints.md.

Calling the API

# Search:
scripts/crawlora.sh /apple-jobs/search q="software engineer" location="united-states-USA" | jq '.'

# Job detail:
scripts/crawlora.sh /apple-jobs/job id="200674676-0836" | jq '.'

Use scripts/crawlora.sh for all requests; it keeps the API key out of command-line arguments.

Endpoint reference

See reference/endpoints.md for both Apple Jobs endpoints this skill uses.

Examples

  • "What is Apple hiring for in Cupertino?" — /apple-jobs/search q="engineer" location="united-states-USA", page through with page, then /apple-jobs/job on the ids you care about for full qualifications.
  • "Pull the full posting for req 200674676-0836." — /apple-jobs/job id=200674676-0836 directly, no search needed if you already have the id.

Notes & limits

  • Credits / pay-on-success: billed only on 2xx; free tier 2,000 credits/mo. Key at https://crawlora.net.
  • Public data only — public postings; respect jobs.apple.com's terms.
  • Security: key lives in CRAWLORA_API_KEY only — never hardcode, query-param, or commit it.
  • Search page size is fixed at 20 by Apple — walk multiple pages via page to cover more results.
  • location uses Apple's own slug format (e.g. united-states-USA, singapore-SGP), not a free-text city/country string.
  • Search results are metadata-only — call /apple-jobs/job for the full description and qualifications of a specific posting.

Comments

Markdown supported