amazon-jobs-research

Amazon Jobs 搜索

搜索 Amazon 的公开招聘网站（amazon.jobs），并通过 Crawlora API 获取规范化的 JSON 格式单个职位信息，无需手动抓取 amazon.jobs。

何时使用此技能

• “在 搜索 Amazon 的 职位。”——在 amazon.jobs 上按关键词／类别搜索。
• “Amazon 在 类别中招聘哪些职位？”——按 Amazon 自有的职位类别分类法筛选。
• “显示 Amazon 职位 ID 的完整招聘信息。”——获取一条职位的描述和任职资格。
• “Amazon 最新发布的 职位有哪些？”——按发布时间从新到旧排序。

设置（一次性）

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

工作原理

1. 搜索 — /amazon-jobs/search 查询 amazon.jobs 无需凭证的 搜索 JSON。必须提供 q（文本查询）或 category（Amazon 自有的 职位类别分类法 slug）之一；同时传入两者可进一步缩小范围。 可选的 country（ISO 3166-1 alpha-3）用于按地点筛选，sort 可选 relevant（默认）或 recent，limit/page 用于翻页。 每条结果都已包含完整的职位描述和任职资格，因此之后仅需调用详情接口 重新获取某条职位信息。
2. 职位详情 — /amazon-jobs/job 根据 Amazon 职位的数字 id（搜索结果中的 id 字段）返回一条职位信息。数据解析自 amazon.jobs 稳定的服务端渲染职位页面——上游没有单独的 JSON 详情接口。

完整的接口列表、请求方法和参数：reference/endpoints.md。

调用 API

# Search by keyword + country, newest first:
scripts/crawlora.sh /amazon-jobs/search q="software development engineer" country=USA sort=recent | jq '.'

# Fetch one posting by id:
scripts/crawlora.sh /amazon-jobs/job id=2612345 | jq '.'

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

接口参考

请参阅 reference/endpoints.md，了解此技能使用的两个 Amazon Jobs 接口。

示例

• 按类别浏览： 使用 /amazon-jobs/search category=hr-and-recruiting，不提供 文本查询即可列出某类别中的所有开放职位，然后使用 page/limit 翻页。
• 长期跟踪某条职位： 保存搜索结果中的 id，然后定期调用 /amazon-jobs/job id=<id>，以检测职位信息是否编辑或移除 （结果缺失或发生变化，说明职位已关闭或更新）。

注意事项与限制

• 积分／成功后付费： 仅对 2xx 响应计费；免费套餐每月提供 2,000 个积分。 可在 https://crawlora.net 获取密钥。
• 仅限公开数据——仅限 Amazon.jobs 上公开的招聘信息；请遵守 Amazon 的条款。
• 安全性： 密钥只能存放在 CRAWLORA_API_KEY 中——切勿硬编码、用作查询参数或提交到代码库。
• /amazon-jobs/search 必须提供 q 或 category——两者都不提供时，请求会失败。
• 结果采用分页方式返回——传入 page/limit（每页最多 100 条）以遍历 完整列表。