mcpField
T
tesla-jobs-research

tesla-jobs-research

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

tesla-jobs-research について

tesla-jobs-researchは、Crawlora APIでTeslaの公開求人を検索するスキルです。職種名、部門、勤務地で絞り込んでページごとに閲覧し、求人IDから詳細な説明と要件を取得できます。

主な機能

  1. 01キーワードや勤務地で求人検索
  2. 02求人一覧の絞り込みとページ分割
  3. 03求人の詳細説明を取得
  4. 04職務内容と応募要件の確認

活用シーン

  1. 01勤務地を指定してTeslaの求人を探す
  2. 02部門ごとの募集職種を一覧化
  3. 03選択した求人の応募要件を確認
  4. 04ページをまたいで求人一覧を調査

インストール

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

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

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

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

詳細

Tesla の求人検索

Tesla の公開求人サイトを検索し、求人の詳細情報をすべて取得します。手作業で tesla.com/careers をスクレイピングせず、Crawlora API から正規化された JSON を取得します。

このスキルを使う場面

  • 「Tesla で の求人を検索して」/「Tesla は でどのような人材を募集していますか?」
  • 「 部門の Tesla の求人をすべて表示して」
  • 「Tesla の求人 ID の詳細な説明/応募要件を取得して」
  • 「Tesla は で採用を拡大していますか?」— 求人一覧をページごとに確認します。

セットアップ(一度だけ)

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

仕組み

  1. 求人情報の一覧表示 — /tesla-jobs/list は Tesla の careers-state JSON スナップショットを検索します。query(職種名/部門の部分一致)や location(部分一致)で絞り込み、page と page_size で結果をページごとに取得できます。Tesla の上流エンドポイントは、クエリにかかわらず常に全世界の求人データセットを返します。このエンドポイントはそのスナップショットをサーバー側で絞り込み、ページ分割するため、一覧に含まれるのは ID/部門/勤務地のメタデータのみで、詳細な説明はまだ含まれません。
  2. 求人の詳細 — 一覧の結果から数値の id フィールドを取得し、/tesla-jobs/job に渡すと、説明、職務内容、応募要件を含む求人の詳細を取得できます。

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

API の呼び出し

# Search Tesla openings by title/department and location:
scripts/crawlora.sh /tesla-jobs/list query="software engineer" location="Austin" | jq '.'

# Pull the full detail for one posting (id from the list response):
scripts/crawlora.sh /tesla-jobs/job id=204536 | jq '.'

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

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

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

例

  • 「Tesla はベルリンでどのような人材を募集していますか?」 — /tesla-jobs/list で location="Berlin" を指定し、関心のある ID に対して /tesla-jobs/job を呼び出して 詳細な応募要件を取得します。
  • 「Tesla のデータエンジニアリング職をすべて表示して」 — /tesla-jobs/list で query="data engineer" を指定し、1 ページ分に満たない応答が返るまで page/page_size を進めます。

注意事項と制限

  • クレジット/成功時のみ課金: 2xx の場合にのみ課金されます。無料枠は月 2,000 クレジットです。 キーは https://crawlora.net で取得できます。
  • 公開データのみ — 公開求人が対象です。Tesla の利用規約を遵守してください。
  • セキュリティ: キーは CRAWLORA_API_KEY にのみ保存してください。ハードコード、クエリパラメーターへの指定、コミットはしないでください。
  • query/location は部分一致フィルターであり、全文検索や地理検索ではありません — 市区町村の略称など、絞り込み語句が限定的だと求人を見逃す場合があります。検索結果がない場合は、より広い部分一致語句を試してください。
  • 一覧の結果にはメタデータのみが含まれます — 詳細な説明、職務内容、応募要件を取得するには、必ず /tesla-jobs/job を続けて呼び出してください。
  • 結果はページ分割されています — 一覧全体を確認するには、page(および任意で page_size、最大 100)を指定してください。

コメント