indeed-research

Indeed の求人検索

Indeed の求人情報をキーワードと場所で検索し、オートコンプリートで有効な場所文字列を解決して、単一の求人情報の詳細を取得します。すべて Crawlora API から正規化された JSON 形式で取得でき、indeed.com を手作業でスクレイピングする必要はありません。

このスキルを使う場面

• 「Indeed で の の求人を検索してください。」
• 「<partial city/area> に対応する Indeed の適切な場所文字列は何ですか？」
• 「この Indeed の求人（求人キー ）の詳細をすべて取得してください。」
• 「Indeed で過去 N 日以内に掲載された の求人を探してください。」
• 「Indeed の の検索結果をページ送りしてください。」

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

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

仕組み

1. 場所を解決します（任意ですが推奨） — /indeed/locations/suggest に部分的な場所文字列（q）を渡すと、Indeed 独自のオートコンプリート候補が返されます。これはアプリの検索バーに表示されるものと同じなので、推測せずに検索用の有効な l 値を作成できます。
2. 検索します — /indeed/search にはキーワード（必須の q）と、任意の l（場所）、radius、fromage（過去 N 日以内に掲載された求人のみ）、sort（relevance または date）、ページネーション用の page を指定します。各結果には、詳細の取得に使用する job_key が含まれます。
3. 求人の詳細 — /indeed/job に jk（検索結果に含まれる 16 文字の 16 進数の求人キー）を渡すと、求人情報全体が返されます。

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

API の呼び出し

# Resolve a location string:
scripts/crawlora.sh /indeed/locations/suggest q="san fran" | jq '.'

# Search:
scripts/crawlora.sh /indeed/search q="staff engineer" l="San Francisco, CA" fromage=7 sort=date | jq '.'

# Job detail (jk from a search result):
scripts/crawlora.sh /indeed/job jk=abcdef0123456789 | jq '.'

すべてのリクエストには scripts/crawlora.sh を使用してください。API キーをコマンドライン引数に含めずに済みます。

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

このスキルが使用する Indeed の全エンドポイントについては、reference/endpoints.md を参照してください。

例

• あいまいな場所で役職を検索する場合： ユーザーが指定したおおまかな都市名で /indeed/locations/suggest を呼び出して有効な l 値を取得し、その値と q、さらに最新の求人を先頭に表示する sort=date を指定して /indeed/search を呼び出します。
• 検索結果の情報を補完する場合： /indeed/search を実行し、任意の検索結果から job_key を取得して、/indeed/job を呼び出します。その求人情報の詳細な説明、給与、応募方法をすべて取得できます。

注意事項と制限

• クレジット／成功時のみ課金： 2xx の場合のみ課金されます。無料プランでは毎月 2,000 クレジットを利用できます。キーは https://crawlora.net で取得できます。
• 公開データのみ — 公開されている Indeed の求人情報が対象です。Indeed の利用規約を遵守してください。
• セキュリティ： キーは CRAWLORA_API_KEY のみに保存してください。コードへのハードコード、クエリパラメーターへの指定、コミットは行わないでください。
• page が 2 以上の場合と fromage を指定した場合は、より低速なページベースの転送方式に切り替わります — fromage を指定しない 1 ページ目では、Indeed の高速な認証不要の GraphQL API を使用します。2 ページ目以降をリクエストするか fromage で絞り込むと転送方式が切り替わりますが、どちらの方式でもレスポンスの正規化された形式は同じです。
• 場所のオートコンプリートにはページベースの代替手段がありません — /indeed/locations/suggest は GraphQL のみを使用するため、検索や求人詳細の取得とは独立して失敗することがあります。
• /indeed/search の結果はページ分割されています。page を指定して全件を取得してください。