job-market-research

求人市場と採用に関する調査

求人情報を検索し、企業の現在募集中のポジションをATSから直接取得し、フリーランス案件を調査できます。すべてCrawlora APIから正規化されたJSONとして取得でき、求人サイトやATSのページを手動でスクレイピングする必要はありません。

このスキルを使う場面

• 「の求人をで検索して。」（Indeed、Google／Amazon／Apple／Meta／Teslaの採用情報）
• 「は現在どの職種を募集していますか？」— ATSの求人掲示板から直接取得します。
• 「はどのATSを使っていますか？」／「企業の求人掲示板を探して。」
• 「は積極的に採用していますか？」— 採用シグナルを集約して分析します。
• 「のフリーランサー／案件を探して。」（Upwork、Fiverr）

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

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

仕組み

1. 求人サイトと検索エンジン — /indeed/search（キーワード＋勤務地）、/google-jobs/search（careers.google.com）、および各企業専用の/amazon-jobs/search、/apple-jobs/search、/meta-jobs/search、/tesla-jobs/listを使用します。それぞれに、求人情報1件の詳細を取得する対応する.../job（または/list／/board）エンドポイントがあります。
2. あらゆる企業のATS求人掲示板 — まず、どのシステムを使っているかを特定します。/jobs/company-searchでGreenhouse、Lever、Ashby、SmartRecruiters、Workdayなどを調べ、企業のスラッグを取得します。その後、対応するエンドポイントで求人情報を一覧表示します。/jobs/greenhouse/board（パラメーターtoken）、/jobs/lever/postings、/jobs/workday/board、/jobs/smartrecruiters/postings、/jobs/ashby/board（パラメーターorg）、/jobs/recruitee/offers、/jobs/workable/postings、/jobs/rippling/board、/jobs/icims/board、/jobs/oracle/board、/jobs/ukg/board、/jobs/personio/feed、/jobs/pinpoint/board、/jobs/teamtailor/jobs、/jobs/eightfold/board、/jobs/gem/boardなど、ATSごとに1つのエンドポイントがあり、それぞれに求人情報1件の詳細を取得する対応エンドポイントがあります。ATSごとにスラッグのパラメーター名（token、company、org、tenant＋datacenter＋site、またはdomain）が異なります。詳しくはreference/endpoints.mdを参照してください。
3. 採用シグナル — /jobs/hiring-signalsは企業のATS求人掲示板を集約し、採用ペースの概要（従業員数増加の代替指標）を1回の呼び出しで作成します。provider（ATS名）と、そのプロバイダーのスラッグパラメーターを渡します（例：provider=greenhouse＋token=<slug>、またはprovider=ashby＋org=<slug>）。
4. フリーランス — 案件や仕事には/upwork/search／/fiverr/search、詳細には/upwork/job/{id}、/fiverr/gig/{username}/{slug}、プロフィールには/upwork/freelancer/{id}、/fiverr/seller/{username}を使います。

エンドポイント、メソッド、パラメーターの一覧については、reference/endpoints.mdを参照してください。

API の呼び出し

# Search:
scripts/crawlora.sh /indeed/search q="staff engineer" l="Remote" | jq '.'

# Resolve then pull a company's ATS board:
scripts/crawlora.sh /jobs/company-search slug=stripe | jq '.'
scripts/crawlora.sh /jobs/greenhouse/board token=stripe | jq '.data'

# Hiring signals:
scripts/crawlora.sh /jobs/hiring-signals provider=greenhouse token=stripe | jq '.'

# Freelance:
scripts/crawlora.sh /upwork/search q="react developer" | jq '.'

すべてのリクエストにはscripts/crawlora.shを使用します。これにより、コマンドライン引数にAPIキーが含まれないようにできます。

エンドポイントのリファレンス

このスキルが使用するIndeed、Google／Amazon／Apple／Meta／Tesla Jobs、ATS（Jobsグループ）、Upwork、Fiverrの全エンドポイントについては、reference/endpoints.mdを参照してください。

例

• 「企業Xは事業を拡大していますか？」 — /jobs/company-searchで求人掲示板を特定し、/jobs/hiring-signalsで採用ペースの概要を取得してから、元の求人掲示板エンドポイントで募集中のチームや職種を確認します。
• 複数ソースをまたいだ職種検索： 同じ職種名／勤務地で/indeed/searchと/google-jobs/searchを使い、企業名＋職種名で重複を除外します。
• 競合他社の採用状況を監視： 3～4社の競合企業のATS求人掲示板を定期的に取得し、実行間で新しい求人情報を比較します。
• フリーランスの報酬相場を確認： /upwork/searchでスキルを検索し、求人の予算を集めて市場相場を推定します。

注意事項と制限

• クレジット／成功時のみ課金： 2xx の場合にのみ課金されます。無料プランは月 2,000 クレジットです。 https://crawlora.net でキーを取得してください。
• 公開データのみ — 公開求人情報／求人掲示板が対象です。各情報源の利用規約を遵守してください。
• セキュリティ： キーは CRAWLORA_API_KEY のみに保存してください。ハードコード、クエリパラメーターへの追加、コミットは絶対にしないでください。
• ATS 掲示板では、公開ブランド名ではなく企業の掲示板スラッグが必要です — まだ分からない場合は、まず /jobs/company-search を使用してください。
• ほとんどの search／掲示板一覧エンドポイントでは結果がページ分割されます — 全件を取得するには page を渡してください。