tesla-jobs-research について
tesla-jobs-researchは、Crawlora APIでTeslaの公開求人を検索するスキルです。職種名、部門、勤務地で絞り込んでページごとに閲覧し、求人IDから詳細な説明と要件を取得できます。
主な機能
- 01キーワードや勤務地で求人検索
- 02求人一覧の絞り込みとページ分割
- 03求人の詳細説明を取得
- 04職務内容と応募要件の確認
活用シーン
- 01勤務地を指定してTeslaの求人を探す
- 02部門ごとの募集職種を一覧化
- 03選択した求人の応募要件を確認
- 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が返されます。
仕組み
- 求人情報の一覧表示 —
/tesla-jobs/listは Tesla の careers-state JSON スナップショットを検索します。query(職種名/部門の部分一致)やlocation(部分一致)で絞り込み、pageとpage_sizeで結果をページごとに取得できます。Tesla の上流エンドポイントは、クエリにかかわらず常に全世界の求人データセットを返します。このエンドポイントはそのスナップショットをサーバー側で絞り込み、ページ分割するため、一覧に含まれるのは ID/部門/勤務地のメタデータのみで、詳細な説明はまだ含まれません。 - 求人の詳細 — 一覧の結果から数値の
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)を指定してください。
コメント
Markdown 対応