104-jobhunt

104-jobhunt — 求職者版 104 職缺分析中心

把任何 AI coding CLI（Claude Code 等）變成你的求職指揮中心： 用你的履歷在 104 找機會、逐一用 A–F 加權系統評分、把分析結果寫進本地資料夾、追蹤應徵進度。

靈感來自兩個專案，但立場相反：

• kevin-shu/104-sourcing：企業用 AI 找人才。
• career-ops：求職者的職缺分析系統（評分 / 報告 / 追蹤）。

本專案 = career-ops 的分析腦袋 + 104-sourcing 的 104 整合，但站在求職者這一側。

這不是亂槍打鳥工具，而是篩選器 —— 幫你從一堆職缺找出真正值得投的少數。 系統永遠不會替你送出應徵，最終決定權在你。

它能做什麼

• 找職缺 — 依履歷與偏好搜尋 104（agent-browser 為主，含零 token fast-path）
• A–F 評分 — 技能契合 / 職涯方向 / 薪資 / 公司文化 / 紅旗，產生 1–5 分
• 真實性評估 — 標出可能的「長期開缺 / 幽靈職缺」訊號（不指控，只提示）
• 本地報告 — 每個職缺一份 Markdown 分析，存到 reports/
• 應徵追蹤 — data/applications.md 單一真實來源

快速開始

Clone 本專案到本地（或直接下載 ZIP 解壓）。

git clone https://github.com/honruch/104-jobhunt.git
cd 104-jobhunt
node scripts/doctor.mjs        # 環境檢查（無 npm 相依，免 npm install）

安裝與設定

# 1. 環境檢查
npm run doctor

# 2. 設定（皆屬使用者層，更新不會被覆蓋）
cp config/profile.example.yml config/profile.yml   # 填目標 / 薪資 / 地區 / 紅旗
cp modes/_profile.template.md modes/_profile.md     # 求職敘事 / 加分故事（選用）

# 3. 匯入履歷
#    在 Claude Code 裡跑 /104-jobhunt resume，貼上履歷或給 PDF 路徑，
#    它會整理成 resume/resume.md（評分依據）。

# 4. 開始
#    /104-jobhunt search          → 找職缺加入 pipeline
#    /104-jobhunt {104 職缺網址}   → 直接評估某職缺
#    /104-jobhunt pipeline        → 批次評估
#    /104-jobhunt tracker         → 看應徵進度

指令

指令	說明
/104-jobhunt resume	匯入 / 整理履歷
/104-jobhunt search	依履歷與偏好在 104 找職缺
/104-jobhunt {網址}	自動評估單一職缺（A–F + 報告 + 追蹤）
/104-jobhunt evaluate {網址}	評估單一職缺
/104-jobhunt pipeline	批次評估 inbox
/104-jobhunt tracker	應徵狀態總覽
/104-jobhunt deep	公司深入研究
/104-jobhunt doctor	環境 / 設定檢查

關於 104 與 Cloudflare

104 在 Cloudflare 後面，伺服器端直接打 API 會被 403 擋。 所以 scripts/search-104.mjs / job-detail.mjs 是「機會主義 fast-path」，被擋是正常的； 可靠途徑是 agent-browser 開真實瀏覽器通過 Cloudflare，再在頁面內呼叫同源 API （細節見 modes/_shared.md 的「104 API 用法」）。

安裝 agent-browser：npm i -g agent-browser（或用 npx agent-browser）。

現況與規劃

• ✅ Phase 1：使用者提供履歷 + 104 職缺搜尋 / 評分 / 報告 / 追蹤。

目錄結構

• modes/ — 各模式指令（系統層，可更新）；_profile.md 為使用者層
• scripts/ — 零 token Node fast-path 與 doctor
• resume/ config/ — 使用者履歷與偏好（使用者層）
• data/ reports/ jds/ — 你的求職產物（使用者層）

使用範例

/104-jobhunt resume
# → 在 Claude Code 裡貼履歷，產生 resume/resume.md
/104-jobhunt search
# → 根據履歷與偏好搜尋 104，找到的職缺會加入 pipeline
/104-jobhunt pipeline
# → 逐一評估 pipeline 裡的職缺，產生 A–F 評分與分析報告，存到 reports/

致謝與授權 (Credits & License)

本專案的概念受兩個專案啟發，程式碼與文字皆為獨立原創撰寫（未複製任何來源檔案）：

• career-ops（MIT）— 啟發 A–F 評分與管道式工作流的想法。
• kevin-shu/104-sourcing（無授權，保留所有權利）— 啟發「瀏覽器登入 + API」的手法概念；本專案未複製其程式碼或文字。

104 的 API 端點為公開可觀察之事實，由獨立公開技術資料研究而得。

本專案以 MIT 授權（見 LICENSE）。使用前請詳閱 LEGAL_DISCLAIMER.md — 特別是 104 服務條款、個人用途與不自動投遞等規範。資料分層見 DATA_CONTRACT.md。