求人スクレイパー は何をしますか?
新しい掲載情報を発見し、候補者のプロフィールに基づいてフィルタリングし、真に新しいものだけを報告します。
設定
$JOB_SEARCH_HOME/integrations.yaml から読み取ります:
| 必要なもの | キー |
|---|---|
--where 用のロケーション文字列 | search_locations |
| 構造化ボードCLI | tools.board_search_cli |
| オプションのLinkedIn CLI | tools.linkedin_search_cli |
| 重複排除用のトラッカーファイル | tracker_path |
- カテゴリ、役割キーワード、フィルタ:
references/search-queries.md - 候補者情報:
$JOB_SEARCH_HOME/profile.md
search_locations または tools.board_search_cli が空の場合は停止し、キーを指定してください。 ハードコードされた都市にフォールバックしたり、CLIのパスをでっち上げたりしないでください。
起動
「新しい仕事を探す」「求人をスクレイプ」「新しいポジションは?」 /scrape でトリガーされます。
オプション引数:
- フォーカスエリア —
/scrape platform broad— すべての優先カテゴリを実行remote— リモートとハイブリッドに絞り込むlinkedin— LinkedInチャンネルをオプトイン(ステップ2bを参照、デフォルトではオフ)
ステップ0 — 状態の読み込み
job_scraper/seen_jobs.jsonを読み取り、存在しない場合は{"seen": {}}として作成tracker_pathを読み取り、既に応募した企業と役割を確認references/search-queries.mdを読み取り、カテゴリ、キーワード、ロケーション階層を取得$JOB_SEARCH_HOME/profile.mdを読み取り、ステップ4の評価の根拠とする
ステップ1 — 構造化ボード検索(プライマリ)
優先カテゴリごとに、役割タイトルのキーワードごとにCLIを1回実行します。デフォルトでは上位3カテゴリ、broad で全カテゴリ、フォーカスエリアで指定されたカテゴリ。
python3 <board_search_cli> --keywords "<role title>" --where "<location>" --pages 2
# リモートスイープ:
python3 <board_search_cli> --keywords "<role title>" --where "All Australia" --remote --pages 2
# 最近のみ:
python3 <board_search_cli> --keywords "<role title>" --where "<location>" --days 14 --pages 2
Bashで実行します。JSON配列が出力されるので、直接パースします。キーワード呼び出しはバッチ処理します。それぞれ高速です。--where には search_locations を順に使用します。
ステップ2 — スタートアップおよびATSボード(セカンダリ、オプション)
メインボードではカバーが不十分な創業エンジニアやアーリーステージの役割については、スタートアップボードやATSホストでいくつかウェブ検索を実行します。強いマッチに見える場合のみ掲載情報を取得します。ウェブ検索は地域に偏るため、提示前に候補者の国での資格を確認してください — 多くの結果は現地のものではありません。
ステップ2b — LinkedIn(オプトインのみ)
候補者が明示的にオプトインした場合のみ実行します。自動化はプラットフォームの利用規約に違反するため、デフォルトではオフになっています。オプトインした場合は自己責任であると伝え、ボリュームを低く抑え、結果をプライマリチャンネルと同じ重複排除とランキングに統合します。
tools.linkedin_search_cli が空の場合は、推測せずにチャンネルが設定されていないと伝えます。
ステップ3 — 重複排除
すべての結果について:
- そのボードIDまたはURL、あるいは
company+titleキーが既にseen_jobs.jsonにある場合はスキップ company+roleが既にtracker_pathにある場合はスキップ
ステップ4 — クイックフィット評価
完全な評価パスではなく、シグナルです。検索で返されたティーザー、タイトル、給与、勤務形態、箇条書きを使用します:
- 高 — コアスキルにヒット、ロケーションまたはリモート可能、給与(表示されている場合)が基準をクリア
- 中 — 隣接する役割、またはロケーションと給与の確認が必要
- 低 — 大幅なスキルギャップ、または設定されたロケーション外でのオンサイト勤務でリモートなし
タイトルよりも専門分野を確認してください。 シニアタイトルは専門分野のシグナルではありません。「リードエンジニア」や「スタッフエンジニア」と謳われた役割は、バックエンドやアプリケーションエンジニアリングの役割であり、Java、Spring Boot、.NET、PHPなどの言語でのエキスパートレベルの実践的な作業が中核要件となります。中核要件が候補者の文書化されたプロフィール外の専門分野や言語である場合、タイトルがどれだけシニアであっても、ドメインがどれだけ馴染みがあっても、低と評価します。決済、銀行、プラットフォームに関連する文脈があっても、バックエンドの役割がプラットフォームの役割に変わるわけではありません。
$JOB_SEARCH_HOME/targets.md を読み取り、除外するスタックを確認し、profile.md のコアスキルで実際に証明されているものを確認してください。求人広告に記載された要件は、候補者がそれを持っている証拠にはなりません。
references/search-queries.md からロケーションフィルタを適用します。
ステップ5 — 保存
スキップされたものを含め、表面化したすべての求人を記録します:
{
"seen": {
"<board-id-or-company-title-key>": {
"title": "…", "company": "…", "location": "…", "url": "…",
"salary": "…", "work_arrangement": "…",
"first_seen": "YYYY-MM-DD", "fit": "high|medium|low",
"status": "new|skipped|evaluated"
}
}
}
ステップ6 — 提示
## 新しい求人マッチ — YYYY-MM-DD
X件の新しいポジションを発見(高 Y件、中 Z件、低 W件)。
| # | 適合度 | タイトル | 企業 | ロケーション | 勤務形態 | 給与 | URL |
|---|-----|-------|---------|----------|-------------|--------|-----|
| 1 | 高 | … | … | … | リモート/ハイブリッド | … | [リンク](…) |
その後、高マッチごとに2~3つの箇条書き:適合理由、確認すべき要件、レッドフラグ。
最後に、詳細に評価するか応募するかを尋ねます。job-application-assistant ワークフローを実行するには完全な説明が必要です — 検索ステップではティーザーのみが返されるため、最初に詳細を取得してください。
ステップ7 — トラッカーの更新
候補者が応募を決定した場合、tracker_path に行を追加します。
ルール
- 決して掲載情報を捏造しないでください。 CLIまたは実際のフェッチで返されたもののみを提示します。
- 常に重複排除 を
seen_jobs.jsonとtracker_pathの両方に対して行います。 - 設定されたロケーション階層を尊重します。 オプトインがない限り、範囲外のオンサイトの役割はスキップします。
- 募集中の役割のみ。 結果はライブですが、明らかに古くなったものはスキップします。
- 評価または応募する前に完全な説明を取得してください。
- タイトルよりも専門分野。 要件の主要言語と専門分野でスクリーニングし、決して役職名だけで判断しないでください。候補者が持っていないスタックでのシニアタイトルは低マッチです。
- 効率性。 まずタイトル、ティーザー、給与でフィルタリングし、すべての結果を取得しないでください。
- 明示的なオプトインなしにLinkedInにクエリを送信しないでください。