amazon-jobs-research

Amazon Jobs の検索

Amazon の公開キャリアサイト（amazon.jobs）を検索し、Crawlora API から個々の求人情報を正規化された JSON として取得します。amazon.jobs を手作業でスクレイピングする必要はありません。

このスキルを使う場面

• 「 の求人を で Amazon から検索して。」— amazon.jobs でキーワード／カテゴリー検索を行います。
• 「Amazon は でどんな求人を募集していますか？」— Amazon 独自の職種カテゴリー分類で絞り込みます。
• 「Amazon の求人 ID の募集内容をすべて見せて。」— 1 件の求人情報から、説明と応募資格を取得します。
• 「 の Amazon の最新求人を教えて。」— 投稿日が新しい順に並べ替えます。

セットアップ（初回のみ）

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

仕組み

1. 検索 — /amazon-jobs/search は、認証情報が不要な amazon.jobs の検索 JSON を照会します。q（テキスト検索）または category（Amazon 独自の職種カテゴリー分類のスラッグ）のいずれかが必須です。さらに絞り込むには両方を指定します。任意の country（ISO 3166-1 alpha-3）で勤務地を絞り込み、sort で relevant（デフォルト）または recent を指定し、limit／page で結果をページ分割できます。各検索結果には説明と応募資格がすでに含まれているため、詳細情報の呼び出しが必要なのは、後から特定の求人情報を再取得する場合のみです。
2. 求人詳細 — /amazon-jobs/job は、Amazon の数値形式の求人 id（検索結果の id フィールド）を指定して 1 件の求人情報を返します。amazon.jobs の安定したサーバー描画の求人ページから解析されます。上流には独立した JSON 詳細エンドポイントはありません。

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

API の呼び出し

# Search by keyword + country, newest first:
scripts/crawlora.sh /amazon-jobs/search q="software development engineer" country=USA sort=recent | jq '.'

# Fetch one posting by id:
scripts/crawlora.sh /amazon-jobs/job id=2612345 | jq '.'

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

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

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

使用例

• カテゴリーの閲覧： テキスト検索を指定せずに /amazon-jobs/search category=hr-and-recruiting を呼び出して、カテゴリー内の募集中の職種をすべて一覧表示し、その後 page／limit でページを切り替えます。
• 特定の求人情報を継続的に確認： 検索結果から id を保存し、定期的に /amazon-jobs/job id=<id> を呼び出して、編集や削除を検出します（結果が見つからない、または変更されている場合、その職種の募集が終了したか、更新されたことを示します）。

注意事項と制限

• クレジット／成功時のみ課金： 2xx の場合のみ課金されます。無料プランでは月 2,000 クレジットを利用できます。キーは https://crawlora.net で取得できます。
• 公開データのみ — Amazon.jobs の公開求人情報を対象とします。Amazon の利用規約を遵守してください。
• セキュリティ： キーは CRAWLORA_API_KEY のみに保存してください。ハードコードしたり、クエリパラメーターに指定したり、コミットしたりしないでください。
• /amazon-jobs/search では q または category のいずれかが必須です。どちらも指定せずに呼び出すと失敗します。
• 結果はページ分割されています。すべての結果を取得するには page／limit を指定してください（1 ページあたり最大 100 件）。