apple-jobs-research

Apple Jobs 搜索

搜索 Apple 的公开招聘网站，并获取完整职位详情——所有数据均通过 Crawlora API 以规范化 JSON 格式返回，无需手动抓取 jobs.apple.com。

何时使用此技能

-“搜索 Apple 在 招聘的 职位。” -“Apple 的 团队目前在招聘什么职位？” -“获取 Apple 职位 的完整描述和任职资格。” -“Apple 在 是否招聘零售 / 长期开放职位？”

设置（仅需一次）

• 在 https://crawlora.net 获取免费的 Crawlora API 密钥（每月 2,000 个额度，无需银行卡）。
• 运行辅助脚本前，在环境中设置 CRAWLORA_API_KEY。
• 辅助脚本会从环境中读取 CRAWLORA_API_KEY，并向 https://api.crawlora.net/api/v1 发送请求。密钥缺失或无效时会返回 401。

工作原理

1. 搜索 — /apple-jobs/search（必需参数为 q，location 和 page 为可选参数）会搜索 jobs.apple.com 的服务端渲染搜索页面。每页结果数 由 Apple 固定为 20 条；结果仅包含身份、地点和团队元数据，不含完整描述。
2. 职位详情 — /apple-jobs/job（必需参数为 id）会根据从搜索结果中 返回的 id 字段，获取单个招聘信息的完整描述和任职资格（例如具体招聘编号 200674676-0836，或长期开放 / 人才储备类零售职位 PIPE-200314122）。

完整的端点列表、方法和参数：reference/endpoints.md。

调用 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 '.'

所有请求均使用 scripts/crawlora.sh；它可避免将 API 密钥暴露在命令行参数中。

端点参考

此技能使用的两个 Apple Jobs 端点请参阅 reference/endpoints.md。

示例

• “Apple 在 Cupertino 招聘什么职位？” — /apple-jobs/search q="engineer" location="united-states-USA"，通过 page 翻阅结果， 然后对你关注的职位 ID 调用 /apple-jobs/job，获取完整任职资格。
• “获取招聘编号为 200674676-0836 的完整职位信息。” — 直接调用 /apple-jobs/job id=200674676-0836，如果你已经有 ID，则无需搜索。

注意事项和限制

• 额度 / 成功后计费： 仅对 2xx 响应计费；免费套餐每月提供 2,000 个额度。 可在 https://crawlora.net 获取密钥。
• 仅限公开数据 — 仅限公开招聘信息；请遵守 jobs.apple.com 的条款。
• 安全性： 密钥仅保存在 CRAWLORA_API_KEY 中——切勿将其硬编码、作为查询参数传递或提交到代码库。
• 搜索页面大小由 Apple 固定为 20 — 使用 page 翻阅多个页面以获取更多结果。
• location 使用 Apple 自有的 slug 格式（例如 united-states-USA、singapore-SGP），而非自由格式的城市 / 国家字符串。
• 搜索结果仅含元数据 — 调用 /apple-jobs/job 获取特定招聘信息的完整描述和任职资格。