用途:搜索 Apple 公开招聘网站并获取完整职位详情,全部以规范化 JSON 从 Crawlora API 返回,无需手动抓取 jobs.apple.com。适用于查询某地或某团队的 Apple 招聘岗位、拉取指定职位的完整描述与任职资格、了解零售/常设岗位招聘情况。
主要能力:搜索接口 /apple-jobs/search(q 必填,location 与 page 可选)检索 jobs.apple.com 服务端渲染的搜索页,每页固定 20 条,结果仅含身份、地点、团队等元数据,不含完整描述;职位详情接口 /apple-jobs/job(id 必填)按搜索返回的 id 获取单个职位的完整描述与任职资格,id 可为具体招聘编号(如 200674676-0836)或常设/管道零售岗位(如 PIPE-200314122)。
使用方式:先在 https://crawlora.net 获取免费 Crawlora API key(每月 2000 积分,无需信用卡),将 CRAWLORA_API_KEY 设置到环境变量。所有请求通过 scripts/crawlora.sh 发起,以避免密钥出现在命令行参数中,请求发送至 https://api.crawlora.net/api/v1。示例:scripts/crawlora.sh /apple-jobs/search q="software engineer" location="united-states-USA" | jq '.';scripts/crawlora.sh /apple-jobs/job id="200674676-0836" | jq '.'。完整端点、方法与参数见 reference/endpoints.md。
限制:仅公开数据,需遵守 jobs.apple.com 条款;密钥缺失或无效返回 401,且只能存于 CRAWLORA_API_KEY,切勿硬编码、放入查询参数或提交到仓库;计费仅在 2xx 时发生,免费额度每月 2000 积分;搜索页大小由 Apple 固定为 20,需用 page 翻页;location 使用 Apple 自有 slug 格式(如 united-states-USA、singapore-SGP),而非自由文本城市/国家;搜索结果仅含元数据,需调用 /apple-jobs/job 获取完整描述与任职资格。