ats-job-boards-research

ATS 招聘公告板研究

直接从公司的 ATS 托管招聘页面获取实时职位——涵盖 Greenhouse、Lever、Workday、Ashby 和其他 12 个平台——并通过 Crawlora API 获取标准化 JSON，无需手动抓取招聘页面。本技能适用于托管自有 ATS 招聘网站的公司，不适用于聚合搜索（Indeed/Google Jobs 请参阅 job-market-research 技能），也不适用于少数针对大型科技公司的专用技能（Google/Amazon/Apple/Meta/Tesla Jobs）。

何时使用此技能

• “从 <company> 的 Greenhouse/Lever/Workday 公告板拉取所有开放职位。”
• “<startup> 目前在 Ashby / SmartRecruiters / Workable 上招聘哪些职位？”
• “获取我在 <company> 招聘页面上找到的这条招聘信息的完整描述。”
• “<company> 是否正在扩大团队规模？”——基于其 ATS 公告板查看招聘速度快照。
• “<company> 使用哪个 ATS，其公告板 slug 是什么？”
• “逐周比较 <company> 公告板上的新增招聘信息。”

设置（仅需一次）

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

工作原理

每个平台都采用相同的两次调用形式：一个公告板/列表端点（所有开放职位，通常内含详细信息），以及一个职位详情端点（单条招聘信息的完整 HTML/文本描述）。这两个端点都使用公司招聘页面 URL 中的自有 slug，而非其公开品牌名称。如果你还不知道公司使用哪个 ATS，jobs/company-search 会帮你探测仅需 slug 的平台。

平台	Slug 参数	列表	详情
Greenhouse	token	/jobs/greenhouse/board	/jobs/greenhouse/job
Lever	company	/jobs/lever/postings	/jobs/lever/posting
Ashby	org	/jobs/ashby/board	（内嵌）
Workday	tenant + datacenter + site	/jobs/workday/board	/jobs/workday/job
SmartRecruiters	company	/jobs/smartrecruiters/postings	/jobs/smartrecruiters/posting
Workable	company	/jobs/workable/postings	/jobs/workable/posting
Personio	company	/jobs/personio/feed	（内嵌）
Recruitee	company	/jobs/recruitee/offers	/jobs/recruitee/offer
iCIMS	domain	/jobs/icims/board	/jobs/icims/job
Oracle Recruiting	host + site	/jobs/oracle/board	/jobs/oracle/job
Rippling	company	/jobs/rippling/board	/jobs/rippling/job
Pinpoint	company	/jobs/pinpoint/board	（内嵌）
Eightfold	tenant + domain	/jobs/eightfold/board	/jobs/eightfold/job
Gem	company	/jobs/gem/board	（内嵌）
UKG (Pro Recruiting)	tenant + board	/jobs/ukg/board	（内嵌，简要）
Teamtailor	company	/jobs/teamtailor/jobs	（内嵌）

跨平台端点：

• /jobs/company-search——一次性在 Greenhouse、Lever、Ashby、SmartRecruiters、Workable、Recruitee、Rippling、Teamtailor 和 Pinpoint 中探测某个 slug，并报告该 slug 能在哪些平台上解析（不包括 Workday——它需要 tenant + datacenter + site，而非普通 slug）。
• /jobs/hiring-signals——将任一平台的公告板汇总为团队规模增长快照（开放职位总数、部门/地点/职位名称细分、远程职位占比，以及过去 7/30 天新增职位），一次调用即可完成。传入 provider（ATS 名称）以及该平台自己的 slug 参数。

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

调用 API

# Greenhouse — list a board, then pull one job's full description:
scripts/crawlora.sh /jobs/greenhouse/board token=stripe | jq '.data'
scripts/crawlora.sh /jobs/greenhouse/job token=stripe id=1234567 | jq '.'

# Lever — list postings filtered by department:
scripts/crawlora.sh /jobs/lever/postings company=netflix department=Engineering | jq '.'

# Workday — needs tenant + datacenter + site from the careers URL:
scripts/crawlora.sh /jobs/workday/board tenant=nike datacenter=wd5 site=nikeinc | jq '.'

# Hiring-velocity snapshot for an Ashby-hosted board:
scripts/crawlora.sh /jobs/hiring-signals provider=ashby org=ramp | jq '.'

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

端点参考

所有端点、HTTP 方法及完整参数列表请参阅 reference/endpoints.md。

示例

• “<company> 目前在招聘哪些职位？” — 如果已知平台，直接调用其职位看板端点（例如 /jobs/greenhouse/board token=<slug>）；否则先用 /jobs/company-search slug=<slug> 解析。
• “<company> 正在扩大规模吗？” — 使用 /jobs/hiring-signals，并传入正确的 provider + slug 参数，获取招聘速度摘要（过去 7/30 天的新职位、部门构成）；然后调用原始职位看板端点，查看摘要背后的逐个职位详情。
• 跨 ATS 平台监控竞争对手招聘情况： 定期抓取 3-4 家竞争对手的 ATS 职位看板（混合使用 Greenhouse、Lever、Workday 等各自采用的平台），并比较每次运行期间新增的职位。

说明与限制

• 额度 / 成功后付费： 仅在状态码为 2xx 时计费；免费套餐每月 2,000 个额度。可在 https://crawlora.net 获取密钥。
• 仅限公开数据 — 公开招聘信息/职位看板；请遵守各来源的条款。
• 安全性： 密钥仅存放在 CRAWLORA_API_KEY 中 — 切勿将其硬编码、放入查询参数或提交到代码库。
• 调用特定平台的端点前，你需要事先知道公司使用哪种 ATS 以及其职位看板 slug （而不是其公开品牌名称）— 如果不知道，请使用 /jobs/company-search 进行解析。此技能不支持模糊公司名称查找，也不支持跨平台发现（该探测端点除外）。
• 大多数职位看板/列表端点的结果都采用分页形式（limit/offset 或 page）— 如需获取完整结果，请遍历所有页面。