SuperAPI AI 工具集

ats-job-boards-research

数据与分析

查看项目

更新于 10-15 20:29

技能介绍

用途:从公司自托管的 ATS 招聘页面批量获取实时在招职位,输出规范化 JSON,避免手工抓取。不适用于聚合站搜索(如 Indeed/Google Jobs),也不涵盖少数大厂专用技能。

主要能力:统一的两段式调用——board/list 端点列出全部开放职位(部分内联详情),job-detail 端点获取单个职位的完整 HTML/文本描述,均以公司招聘 URL 中的 slug 为键。支持 Greenhouse、Lever、Ashby、Workday、SmartRecruiters、Workable、Personio、Recruitee、iCIMS、Oracle Recruiting、Rippling、Pinpoint、Eightfold、Gem、UKG、Teamtailor。另有两个跨平台端点:/jobs/company-search 用 slug 一次性探测多个平台(不含 Workday);/jobs/hiring-signals 汇总某平台 board 为招聘速度快照(开放职位总数、部门/地点/职位分布、远程比例、近 7/30 天新增职位)。

使用方式:需先获取 Crawlora API key(免费层每月 2,000 credits,无需信用卡,https://crawlora.net),设置环境变量 CRAWLORA_API_KEY,helper 会读取该变量并请求 https://api.crawlora.net/api/v1,缺失或无效返回 401。调用示例:

Greenhouse 列出 board 并取单个职位描述:

scripts/crawlora.sh /jobs/greenhouse/board token=stripe | jq '.data' scripts/crawlora.sh /jobs/greenhouse/job token=stripe id=1234567 | jq '.'

Lever 按部门过滤:

scripts/crawlora.sh /jobs/lever/postings company=netflix department=Engineering | jq '.'

Workday 需要 tenant + datacenter + site:

scripts/crawlora.sh /jobs/workday/board tenant=nike datacenter=wd5 site=nikeinc | jq '.'

Ashby board 的招聘速度快照:

scripts/crawlora.sh /jobs/hiring-signals provider=ashby org=ramp | jq '.'

建议统一使用 scripts/crawlora.sh,以避免 API key 出现在命令行参数中。端点、方法与参数详见 reference/endpoints.md。

适用场景:查询某公司当前在招职位、判断是否扩招、识别所用 ATS 与 board slug、按周对比新增职位、跨多个竞争对手的 ATS board 定时监控。

限制:仅覆盖公司自有 ATS 托管招聘页的公开数据,需遵守各来源条款;调用平台专用端点前必须已知公司使用的 ATS 及其 board slug(非公开品牌名),未知时用 /jobs/company-search 解析,不支持模糊公司名查找或更广的跨平台发现;多数 board/list 端点分页(limit/offset 或 page),需遍历完整列表;credits 仅在 2xx 时计费;key 只存放于 CRAWLORA_API_KEY,切勿硬编码、放入查询参数或提交到仓库。