mcpField
A
apple-jobs-research

apple-jobs-research

github.com/crawlora-orgその他141 回インストール1 日前に更新
リポジトリ

apple-jobs-research について

apple-jobs-research は Crawlora API 経由で Apple の公開求人を検索するスキルです。検索結果には求人メタデータが含まれ、ID を指定して詳細な説明と応募資格を取得できます。

主な機能

  1. 01Apple の求人を検索
  2. 02勤務地で検索結果を絞り込み
  3. 03検索結果をページ分割
  4. 04ID で求人の詳細を取得
  5. 05説明と応募資格を取得

活用シーン

  1. 01キーワードと勤務地で Apple の求人を検索
  2. 02求人の詳細な要件を確認
  3. 03ID から Apple の求人を照会
  4. 04小売職や通年募集の求人を検索

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/crawlora-org/crawlora-skills --skill apple-jobs-research

インストール後、Claude Code で/apple-jobs-researchを入力して読み込まれたか確認します。

同梱ファイルreference/endpoints.mdscripts/crawlora.sh

詳細

Apple Jobs 検索

Apple の公開採用サイトを検索し、求人の詳細全体を取得します。すべて Crawlora API から正規化された JSON で取得できるため、jobs.apple.com を手作業でスクレイピングする必要はありません。

このスキルを使う場面

  • 「<場所>にある Apple の<職種>の求人を検索してください。」
  • 「Apple の<チーム>では現在、どのような人材を募集していますか？」
  • 「Apple の求人 の詳細な説明と応募資格を取得してください。」
  • 「Apple は<場所>で小売／通年採用の職種を募集していますか？」

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

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

仕組み

  1. 検索 — /apple-jobs/search（q は必須、location と page は任意）で、jobs.apple.com のサーバー側レンダリングされた検索ページを検索します。1 ページあたりの件数は Apple により 20 件に固定されています。検索結果に含まれるのは求人の識別情報、場所、チームのメタデータのみで、詳細な説明は含まれません。
  2. 求人詳細 — /apple-jobs/job（id は必須）で、検索結果の id フィールドを使って求人の詳細な説明と応募資格を取得します（200674676-0836 のような特定の求人、または PIPE-200314122 のような通年採用／小売のパイプライン求人）。

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

API の呼び出し

# Search:
scripts/crawlora.sh /apple-jobs/search q="software engineer" location="united-states-USA" | jq '.'

# Job detail:
scripts/crawlora.sh /apple-jobs/job id="200674676-0836" | jq '.'

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

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

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

例

  • 「Cupertino では Apple はどのような人材を募集していますか？」 — /apple-jobs/search q="engineer" location="united-states-USA" を指定し、page でページを切り替えて検索します。その後、詳細な応募資格を確認したい求人の id を指定して /apple-jobs/job を呼び出します。
  • 「求人番号 200674676-0836 の詳細を取得してください。」 — すでに id がわかっている場合、検索せずに /apple-jobs/job id=200674676-0836 を直接呼び出します。

注意事項と制限

  • クレジット／成功時のみ課金： 2xx の場合のみ課金されます。無料枠は月 2,000 クレジットです。キーは https://crawlora.net で取得できます。
  • 公開データのみ — 公開されている求人のみを対象とし、jobs.apple.com の利用規約を遵守してください。
  • セキュリティ： キーは CRAWLORA_API_KEY のみに保存してください。コードに直接記述したり、クエリパラメーターに含めたり、コミットしたりしないでください。
  • 検索結果のページサイズは Apple により 20 件に固定されています。より多くの結果を確認するには、page を使って複数のページを順に取得してください。
  • location には Apple 独自のスラッグ形式（例：united-states-USA、singapore-SGP）を使用します。自由形式の都市名や国名の文字列は指定できません。
  • 検索結果にはメタデータのみが含まれます — 個別の求人の詳細な説明と応募資格を取得するには、/apple-jobs/job を呼び出してください。

コメント

Markdown 対応