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と、ボードのスラッグを教えて。」
• 「<company>のボードで、新しい求人掲載を週ごとに比較して。」

セットアップ（一度だけ）

• https://crawlora.netで無料のCrawlora APIキーを取得します（月2,000クレジット、カード不要）。
• ヘルパーを実行する前に、環境変数にCRAWLORA_API_KEYを設定します。
• ヘルパーは環境変数からCRAWLORA_API_KEYを読み取り、https://api.crawlora.net/api/v1にリクエストを送信します。キーがない、または無効な場合は401が返されます。

仕組み

どのプラットフォームも、2つのエンドポイントを呼び出す同じ形式です。ボード／リストエンドポイント（募集中の求人掲載をすべて取得し、多くの場合、詳細情報も含まれます）と、求人詳細エンドポイント（1件の求人掲載について、HTML／テキスト形式の完全な説明を取得します）です。どちらも、公開されている企業ブランド名ではなく、採用ページのURLに含まれる企業独自のスラッグをキーとして使います。jobs/company-searchは、使用しているATSが不明な場合に、スラッグのみを使うプラットフォームを検索します。

プラットフォーム	スラッグパラメーター	リスト	詳細
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 — slugを使って、Greenhouse、Lever、Ashby、SmartRecruiters、Workable、Recruitee、Rippling、Teamtailor、Pinpointを一度に検索し、該当するプラットフォームを報告します（Workdayは、単純なスラッグではなくtenant+datacenter+siteが必要なため対象外です）。
• /jobs/hiring-signals — いずれか1つのプラットフォームのボードを集計し、従業員数の増加状況をスナップショットで確認します（募集中の職種数、部門／勤務地／職種名ごとの内訳、リモート勤務の割合、過去7日間／30日間の新規求人）。provider（ATS名）と、そのプロバイダー固有のスラッグパラメーターを渡します。

すべてのエンドポイント、HTTPメソッド、パラメーターについては、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> は事業を拡大していますか？」 — 直近 7／30 日間の新規求人や部門構成など、採用状況の概要を取得するには、適切な provider と slug のパラメーターを指定して /jobs/hiring-signals を呼び出します。その後、役職ごとの詳細を確認するため、求人ボードのエンドポイントを直接呼び出します。
• ATS プラットフォームを横断した競合他社の採用状況の監視： 3～4 社の競合他社について、それぞれが使用している Greenhouse、Lever、Workday などの ATS 求人ボードを定期的に取得し、実行間で新規求人を比較します。

注意事項と制限

• クレジット／成功時のみ課金： 2xx の場合にのみ課金されます。無料プランでは月 2,000 クレジットを利用できます。キーは https://crawlora.net で取得してください。
• 公開データのみ： 公開されている求人情報／求人ボードのみを対象とします。各ソースの利用規約を遵守してください。
• セキュリティ： キーは CRAWLORA_API_KEY のみに保存してください。ハードコード、クエリパラメーターへの指定、コミットは決して行わないでください。
• プラットフォーム固有のエンドポイントを呼び出す前に、利用している ATS と求人ボードの slug（公開ブランド名ではありません）を把握している必要があります。 わからない場合は、/jobs/company-search で特定してください。このスキルでは、あいまいな企業名検索や、このプローブ用エンドポイントを使った検索以外のプラットフォーム横断的な検出は行いません。
• ほとんどの求人ボード／一覧エンドポイントでは結果がページ分割されています（limit／offset または page）。すべて取得するには、全ページを確認してください。