mcpField
G
google-jobs-research

google-jobs-research

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

google-jobs-research について

Crawlora APIを使い、Googleの公開求人を検索して詳細を取得するスキルです。採用担当者や求人を調査する人向けで、ページ分割検索と求人IDによる照会に対応します。

主な機能

  1. 01Google求人の検索
  2. 02キーワードと勤務地による絞り込み
  3. 03求人詳細の取得
  4. 04検索結果のページ送り
  5. 05IDによる求人情報の再取得

活用シーン

  1. 01職種名と勤務地で求人を探す
  2. 02業務内容と応募資格を確認する
  3. 03複数ページから結果を集める
  4. 04保存した求人の更新や終了を確認する

インストール

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

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

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

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

詳細

Google Jobs 検索

Google の公開採用サイトを検索し、Crawlora API から募集要項 1 件の詳細全体（説明、職務内容、応募資格）を正規化された JSON として取得します。careers.google.com を手作業でスクレイピングする必要はありません。

このスキルを使う場面

  • 「Google の <場所> で <職種> の求人を検索してください。」
  • 「Google は現在、<チーム／場所> でどんな人材を募集していますか？」
  • 「Google の求人 ID の詳細全体（説明、職務内容、応募資格）を取得してください。」
  • 「Google Jobs の <職種> の新着求人を継続的に追跡してください。」

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

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

仕組み

  1. 検索 — /google-jobs/search では、必須の q（検索クエリ）に加えて、任意の location（自由形式のテキスト）と page（1 始まり）を指定できます。careers.google.com のサーバー側でレンダリングされた検索ページに埋め込まれている求人データを解析するため、各検索結果には説明、職務内容、応募資格がすでに含まれており、募集要項を読むためだけに 2 回目の API 呼び出しを行う必要はありません。1 ページあたりの件数は Google により 20 件に固定されています。さらにページを閲覧するには page を指定します。
  2. 求人の詳細 — /google-jobs/job では、必須の id（検索結果に返された数値形式の Google 求人 ID）を指定すると、その求人のサーバー側でレンダリングされた詳細ページ全体を再取得します。1 件の求人情報を更新する場合や、すでに別の場所で求人 ID を入手している場合（保存済みリンクなど）に、その求人情報を取得するために使います。

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

API の呼び出し

# Search:
scripts/crawlora.sh /google-jobs/search q="software engineer" location="Mountain View" | jq '.'

# Job detail by id:
scripts/crawlora.sh /google-jobs/job id=123456789012345 | jq '.'

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

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

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

例

  • 場所を指定した職種検索： /google-jobs/search に q="data scientist" と location="New York" を指定し、 page=2、page=3 とページを切り替えて 20 件を超える結果を収集します。
  • 特定の求人情報を追跡： 検索結果の id を保存し、定期的にその id を指定して /google-jobs/job を呼び出し、編集や掲載終了を検出します （404 または空のレスポンスは、求人掲載が終了したことを示します）。

注意事項と制限

  • クレジット／成功時のみ課金： 2xx の場合のみ課金されます。無料枠は月 2,000 クレジットです。 キーは https://crawlora.net で取得できます。
  • 公開データのみ — 公開されている careers.google.com の求人情報が対象です。Google の利用規約を遵守してください。
  • セキュリティ： キーは CRAWLORA_API_KEY にのみ保存してください。ハードコードしたり、クエリパラメーターに指定したり、コミットしたりしないでください。
  • 1 ページあたりの件数は Google により 20 件に固定されています。limit／per_page パラメーターはなく、結果をたどるには page のみを使用します。
  • id には、検索結果の id フィールドにある数値形式の Google 求人 ID を指定してください。 スラッグや URL は使用できません。

コメント

Markdown 対応