google-jobs-research

Google Jobs 搜索

搜索 Google 的公开招聘网站，并从 Crawlora API 获取一条招聘信息的完整详情—— 包括描述、职责和任职资格，并将其作为规范化 JSON 返回，无需手动抓取 careers.google.com。

何时使用此技能

• “在 搜索 Google 的 职位。”
• “Google 目前在 <team/location> 招聘哪些职位？”
• “获取 Google 职位 ID 的完整详情（描述、职责和任职资格）。”
• “长期跟踪 Google 新发布的 职位。”

设置（一次性）

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

工作原理

1. 搜索 — /google-jobs/search 需要 q（搜索查询）， 还可选用 location（自由文本）和 page（从 1 开始）。 它会解析 careers.google.com 服务端渲染的搜索页面中嵌入的职位数据，因此 每条结果都已包含描述、职责和任职资格，无需再调用一次接口来读取职位信息。 Google 将每页结果数固定为 20；传入 page 可浏览后续页面。
2. 职位详情 — /google-jobs/job 需要 id（搜索返回的数字型 Google 职位 ID），并重新获取该职位服务端渲染的完整详情页。可用它刷新单条 职位信息；如果已从其他来源（例如保存的链接）获得职位 ID，也可用它 获取对应职位。

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

调用 API

# Search:
scripts/crawlora.sh /google-jobs/search q="software engineer" location="Mountain View" | jq '.'

# Job detail by id:
scripts/crawlora.sh /google-jobs/job id=123456789012345 | jq '.'

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

端点参考

此技能使用的两个 Google Jobs 端点详见 reference/endpoints.md。

示例

• 按地点搜索职位： 使用 /google-jobs/search，传入 q="data scientist" 和 location="New York"，再通过 page=2、 page=3 获取超过 20 条结果。
• 跟踪特定职位： 保存搜索结果中的 id，然后按计划定期轮询 /google-jobs/job 并传入该 id，以检测职位信息是否有修改或职位是否已下架 （返回 404 或空响应表示该职位已关闭）。

注意事项与限制

• 积分／成功后付费： 仅对 2xx 响应计费；免费套餐每月 2,000 积分。 获取密钥：https://crawlora.net。
• 仅限公开数据 — 数据来自 careers.google.com 上公开发布的职位；请遵守 Google 的条款。
• 安全性： 密钥仅保存在 CRAWLORA_API_KEY 中——切勿将其硬编码、作为查询参数传递或提交到代码库。
• Google 将每页结果数固定为 20 — 没有 limit／per_page 参数， 只能通过 page 浏览后续结果。
• id 必须是搜索结果 id 字段中的数字型 Google 职位 ID， 不能是 slug 或 URL。