工作搜尋器 (Job Scraper) 是做什麼的?
發現新的職缺,根據候選人簡歷進行過濾,並僅回報真正的新職缺。
設定
從 $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。預設執行前 3 個類別;使用 broad 時執行所有類別;使用焦點領域時只執行指定的類別。
python3 <board_search_cli> --keywords "<職稱>" --where "<地點>" --pages 2
# 遠端搜尋:
python3 <board_search_cli> --keywords "<職稱>" --where "全澳洲" --remote --pages 2
# 僅近期職缺:
python3 <board_search_cli> --keywords "<職稱>" --where "<地點>" --days 14 --pages 2
透過 Bash 執行。它會輸出一個 JSON 陣列 — 直接解析即可。批次處理關鍵字呼叫;每次呼叫都很快。按順序使用 search_locations 作為 --where 的值。
步驟 2 — 新創與 ATS 求職板(次要,選用)
針對創始工程師與早期階段的職位,主要求職板可能無法完整涵蓋,請在新創求職板與 ATS 主機上進行幾次網頁搜尋。只有當職位看起來很符合時才擷取完整內容。網頁搜尋會有地區偏差,因此在呈現前請確認該職缺在候選人所在國家/地區的資格 — 許多結果並非本地職缺。
步驟 2b — LinkedIn(僅限選擇加入)
僅在候選人明確選擇加入時才執行。自動化此流程違反該平台的使用條款,因此預設為關閉。當選擇加入時,請說明這是使用者自行承擔風險,保持低流量,並將結果合併到與主要管道相同的去重與排序流程中。
如果 tools.linkedin_search_cli 為空白,請說明該管道尚未設定,而非自行猜測。
步驟 3 — 去重
對每個結果:
- 如果其求職板 ID、URL 或
公司+職稱鍵已存在於seen_jobs.json中,則跳過。 - 如果
公司+職位已存在於tracker_path中,則跳過。
步驟 4 — 快速適配度評估
這是一個訊號,而非完整的評估過程。使用搜尋結果回傳的摘要、職稱、薪資、工作模式與條列重點:
- 高 — 符合核心技能,地點或遠端工作可行,且薪資(若有顯示)超過基本門檻。
- 中 — 相鄰職位,或需要確認地點與薪資。
- 低 — 技能差距顯著,或為非遠端且不在設定地點範圍內。
先檢查領域再檢查職稱。 高階職稱並不代表領域。一個廣告為「首席工程師」或「Staff 工程師」的職位,實際上可能是後端或應用工程師角色,其核心要求是精通 Java、Spring Boot、.NET 或 PHP 等語言的實作能力。如果核心要求是候選人個人資料中未記錄的領域或語言,則無論職稱多高、領域多熟悉,都將其評為低。支付、銀行或平台相關的背景並不會將後端角色轉變為平台角色。
讀取 $JOB_SEARCH_HOME/targets.md 以取得需要排除的技術棧,以及 profile.md 中的核心技能以了解已證實的能力。徵才廣告中列出的要求並非候選人具備該技能的證據。
套用 references/search-queries.md 中的地點篩選條件。
步驟 5 — 儲存
記錄每個出現的職缺,包括被跳過的:
{
"seen": {
"<求職板ID或公司-職稱鍵>": {
"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 個低匹配)。
| # | 適配度 | 職稱 | 公司 | 地點 | 工作模式 | 薪資 | 網址 |
|---|--------|------|------|------|----------|------|------|
| 1 | 高 | … | … | … | 遠端/混合 | … | [連結](…) |
然後對每個高匹配職位列出 2–3 點說明:為什麼適合、需要驗證的要求、以及紅旗警告。
最後詢問使用者是否要詳細評估任何職位或進行申請。在 job-application-assistant 工作流程執行前需要完整的職位描述 — 搜尋步驟僅回傳摘要,因此請先擷取詳細內容。
步驟 7 — 更新追蹤器
如果候選人決定申請,請在 tracker_path 中新增一列。
規則
- 絕不虛構職缺。 僅呈現 CLI 或實際擷取回傳的內容。
- 務必去重,同時比對
seen_jobs.json與tracker_path。 - 遵守設定的地點層級。 除非選擇加入,否則跳過不在範圍內的現場職位。
- 僅限有效職缺。 結果是即時的,但請跳過明顯過時的內容。
- 在評估或申請前,先取得完整職位描述。
- 領域優先於職稱。 根據需求中的主要語言與領域進行篩選,絕不能僅根據職稱。候選人未具備之技術棧的高階職稱,即評為低匹配。
- 效率至上。 先根據職稱、摘要與薪資進行篩選,不要擷取每個結果。
- 未經明確選擇加入,絕不查詢 LinkedIn。