104 Job Hunter MCP
This MCP server lets an AI assistant operate 104 Job Bank workflows for job hunting: search and filter jobs, research companies and competition, prepare applications with human review, and manage saved items.
Check whether the 104 session/login is still valid.
Search jobs with filters for keyword, location, salary minimum, negotiable salary exclusion, featured-ad exclusion, remote type, job type, sorting, and pagination.
Retrieve full job details from a job URL or code.
Analyze applicant competition with estimated applicant counts and distributions by education, experience, age, language, major, skills, and certifications.
Read saved cover-letter templates from the 104 account to preserve the user's original tone.
Prepare an application popup, optionally choose a cover-letter template or insert customized cover-letter text; it does not submit the final application.
Search companies and retrieve company details, benefits, contact info, open jobs, and keyword-search within a company's job descriptions.
Save jobs to favorites and follow/track companies in the 104 account.
Gracefully reload the MCP server after code updates without breaking the stdio channel.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@104 Job Hunter MCP 搜尋台北市的 TypeScript 前端工程師職缺"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
104 Job Hunter MCP 🏹
透過 MCP (Model Context Protocol) 讓 AI 直接接管 104 人力銀行的繁瑣操作。
專注於精準過濾、深度調研、競爭者情報反推與客製自薦信代填,拒絕無意義的亂槍打鳥。
🎯 實戰淬鍊的真實故事
這套工具不是寫來展示技術的 Demo。我自己轉職 AI 工程師時,就是靠著這套流程,精準拿到面試並成功落地。
在 104 上找工作,大家一定都體會過這種無力感:
雜訊太多:職缺標題寫著「AI 工程師」,點進去才發現工作內容只是資料標註,或者混雜了一堆與關鍵字無關的付費廣告(例如搜工程師跑出精品專櫃)。
競爭模糊:104 只給籠統的人數區間(如「6~10 人」或「30 人以上」),你根本不知道對手是誰、具備什麼學歷與技能背景。
精力有限:認真研究公司背景、核對職缺條件、手寫客製化自薦信,一天頂多投 3 家,腦袋就乾了。
罐頭履歷無效:市面上許多標榜「自動求職」的工具,本質只是狂按送出的垃圾信發報機,充滿 ChatGPT 套話,HR 一看就直接丟垃圾桶。
因此我寫了這套 MCP 工具,把 AI 當作自己的「求職特助」:
它清楚我的技能樹、職涯目標與地雷紅線;在背景幫我擋掉 95% 不合適與廣告職缺;調閱對手背景與確切應徵人數進行勝率診斷;接著調出我原本存在 104 的自薦信語氣,針對職位痛點微調,並把推薦信填妥在應徵視窗裡,最後交給我親自把關確認。
這套人機協作流程幫我拿到了滿意的工作。現在我把這套系統完整開源出來。
🧭 設計原則:四道防線
flowchart TD
subgraph Input["1. 輸入設定"]
A["求職宣言 (MY_PROFILE.md)"] --> B["AI Agent (大腦)"]
A2["帳號內既有推薦信範本<br>(保持真實語氣)"] --> B
end
subgraph Core["2. 篩選與競爭調研 (MCP)"]
B -->|攔截 API 搜尋| C["104 職缺庫"]
C -->|背景自動比對| D{"條件/紅線/廣告過濾"}
D -- 排除不符條件與廣告 --> X["捨棄"]
D -- 挑選 Top 3 --> E["深度調研職缺與企業"]
E -->|反推確切人數與對手背景| E2["📊 競爭態勢分析 (apply_analysis)"]
E2 --> F["撰寫客製自薦信<br>(突圍優勢 + 去 AI 腔調)"]
end
subgraph HITL["3. Hit-in-the-Loop 安全邊界"]
F --> G["自動代填至 104 應徵視窗<br>(job104_prepare_application)"]
G --> H{"人類最終肉眼審查"}
H -->|滿意| I["👤 人類手動點擊確認送出"]
H -->|需修改| F
end
classDef accent fill:#f96,stroke:#333,stroke-width:2px;
class H,I accent;1. 精準狙擊,不搞亂槍打鳥
AI 抓回搜尋結果後,不會一股腦把十幾頁列表倒給你。它會對照你的 MY_PROFILE.md,自動濾掉薪資不符、踩到地雷或技術棧差太遠的職缺,並能一鍵過濾 104 付費廣告(excludeFeatured),只整理出 3 到 5 筆真正值得看的選擇。
2. 競爭者情報逆向分析(知己知彼)
104 網站只提供粗略的應徵人數區間(如「11~30 人」),且 API 的 total 常態為 0。本專案透過兩位小數的百分比數值,利用數學解題器精準反推確切應徵總人數,並還原出對手的學歷、年資、擅長技能與證照分布,讓你在投遞前就知道自己贏在哪裡。
3. 說人話,拔除機器臭味
工具會直接讀取你 104 帳號現有的推薦信範本(job104_get_cover_letters),以你平常講話的習慣為底稿,針對該職缺的需求微調。徹底拿掉「深感榮幸、為貴司賦能」這種浮誇套話,把重點放在實際做過的專案邊界與解題過程。
4. Hit-in-the-loop:安全邊界不退讓
這套工具絕不替你按最後的「確認送出」。job104_prepare_application 會打開投遞彈窗、選定推薦信範本、填入客製化推薦信,然後停下來。投哪家、怎麼投,是你的個人職涯,最後的送出鍵必須由你親眼看過、親手按下。
Related MCP server: jobjourney-claude-plugin
✨ 核心功能與工程細節
🔍 進階 API 攔截搜尋:監聽 104 後端 JSON API,支援薪資下限 (
salaryMin搭配scstrict=1)、排除面議、排除廣告職缺 (excludeFeatured)、最新排序 (sort: 'newest') 與遠端工作篩選,並內建台灣縣市 Area Code 自動解析。📊 競爭情報精算:獨創
job104_get_apply_analysis,透過百分比反推與互斥維度總和約束 ($\sum k_i = N$) 精準算出不重複應徵人數,並掌握學歷(碩博/大學)、年資階層、對手 Top 10 技能與證照。🏢 企業深層調研與 JD 內文搜尋:除提取企業福利與公司簡介外,支援以
keyword直接在該公司所有職缺的 JD 內文中全文比對,挖掘職稱沒寫但內文要求的寶藏職缺。🔗 代碼/網址雙格式無縫串接:所有職缺與公司工具皆內建智慧正規化(
normalizeJobUrl),無論傳入完整 104 網址或純代碼(如6lots)皆可直接調用。🔒 本地優先 (Local-First):
100% 在你本機運作,不對外傳輸帳號密碼或個人資料。
登入使用獨立的本機 Chrome Profile,完全由你在官方頁面操作,免除重複登入困擾。
🚦 併發互斥與生命週期防護:內建
runExclusive佇列互斥鎖、導航監聽器防洩漏保護(waitForJsonResponseDuringGoto)、統一錯誤邊界(executeToolSafely),並在 MCP 斷線時自動釋放 Chrome Profile 鎖定,杜絕殭屍進程。
📋 前置準備清單 (Prerequisites)
開始使用前,請確認你的電腦已安裝好以下基礎工具:
項目 | 建議版本 | 必要性 | 說明與用途 | 下載來源 |
Node.js |
| 必備 | 執行 MCP 伺服器、編譯 TypeScript 與套件管理 | |
Google Chrome | 官方穩定版本 | 必備 | 本專案借用本機 Chrome 儲存 Profile,免除爬蟲驗證並維持登入 | |
Git | 任意版本 | 必備 | 用於下載專案及日後 | |
MCP Client | 支援 MCP 之客戶端 | 必備 | 載入並調用本工具的 AI 環境 (如 Antigravity, Claude Desktop, Cursor) | - |
104 會員帳號 | 個人正常帳號 | 必備 | 請先在 104 網站完成基本履歷填寫與自薦信範本儲存 |
一鍵環境診斷:安裝完套件後,可在終端機執行 npm run check,系統會自動檢測 Node.js 版本、Chrome 執行檔路徑、編譯狀態與登入 Profile,若有缺少會給出具體提示。
🚀 快速上手
🤖 給正在協助人類的 AI Agent (System Directive)
如果你是被人類指派來協助設定或操作本專案的 AI 代理(如 Antigravity, Claude Desktop, Cursor 等):
立即讀取操作手冊:請優先研讀專案根目錄的
AGENTS.md,內含完整的決策狀態機與去 AI 化推薦信規格。主動引導建立分身:檢查根目錄是否存在
MY_PROFILE.md。若尚無此檔,請暫停搜尋,主動向人類提問索取簡歷/專案經歷,並參考MY_PROFILE.example.md協助生成專屬 Profile。遵守安全防線:嚴格落實 Hit-in-the-Loop 規範,代填表單後將視窗交還人類,絕不替人類代按最終送出鍵。
1. 安裝與建置
git clone https://github.com/YuJunWang/104-job-hunter-mcp.git
cd 104-job-hunter-mcp
npm install
npm run check # 💡 檢查本機環境與 Chrome 是否就緒
npm test # 🧪 執行 6 組單元測試套件
npm run build2. 登入 104 帳號(只需一次)
npx tsx src/login.ts執行後會跳出 Chrome 視窗,請在 104 官方頁面登入。登入成功後腳本會自動儲存 Cookie 並安全關閉。
3. 掛載 MCP 伺服器
將設定加入你的 MCP 用戶端設定檔(例如 Antigravity 的 mcp_config.json 或 Claude Desktop 的 claude_desktop_config.json):
{
"mcpServers": {
"104-job-hunter": {
"command": "node",
"args": ["D:\\your-path\\104-job-hunter-mcp\\build\\index.js"]
}
}
}4. 設定 AI 腦袋
複製根目錄的
MY_PROFILE.example.md,命名為MY_PROFILE.md。填入你的專案經驗、技能樹、薪資期望、地點與絕對紅線。
直接告訴你的 AI:
「請閱讀專案裡的
MY_PROFILE.md與AGENTS.md,照著標準劇本幫我找工作。」
🛠️ MCP 工具列表 (共 11 組)
工具名稱 | 用途說明 | 運作機制 |
| 檢查登入是否有效 | 支援新版 |
| 搜尋職缺 | 支援關鍵字、地點代碼轉換、薪資下限、排除面議、排除廣告職缺、遠端型態與最新排序 |
| 讀取職缺完整內容 | 支援傳入職缺網址或代碼,取得詳細 JD、薪資條件、加分技能與 HR 聯絡人資訊 |
| 應徵者競爭情報分析 | 數學反推確切應徵總人數(含維度加總約束),並回傳學歷、年資、年齡、語言、Top 10 技能與證照分布 |
| 取得現有自薦信範本 | 支援傳入職缺網址或代碼,讀取帳號內的預設與自訂推薦信標題與全文,保留個人原始口吻 |
| 代填應徵表單 (HITL) | 支援傳入職缺網址或代碼,開啟彈窗、選定範本並填入微調後的推薦信,支援 Dry Run 截圖,不替你送出 |
| 搜尋企業資訊 | 查詢公司代碼、規模、產業類別與現有職缺數 |
| 公司深度分析 | 支援傳入公司網址或代碼,提取企業福利文化與開放職缺,並可以 |
| 收藏職缺 | 支援傳入職缺網址或代碼,解析所屬公司並加入我的收藏名單 |
| 追蹤公司 | 支援傳入公司網址或代碼,帶入完整規格 Payload 追蹤心儀企業 |
| 優雅重載 MCP | 伺服器更新代碼後安全關閉瀏覽器並發送重啟信號,不中斷 stdio 通道 |
📁 專案架構
104-job-hunter-mcp/
├── src/
│ ├── index.ts # MCP 入口,註冊 11 組工具、統一錯誤邊界與優雅退場機制
│ ├── browser.ts # Playwright 瀏覽器單例、fetchIn104 與防洩漏導航攔截封裝
│ ├── login.ts # 互動登入與 Cookie 本地持久化腳本
│ ├── check-env.ts # 環境健康檢查工具 (npm run check)
│ ├── utils/
│ │ ├── url.ts # 職缺/公司 URL 正規化、API 路徑比對與登入網址判斷
│ │ ├── area.ts # 104 官方台灣縣市 Area Code 雙向對照工具
│ │ └── applyAnalysis.ts # 應徵者人數精算反推(含維度總和約束)與多維度正規化
│ ├── tools/ # 8 個工具模組(共提供 10 組核心業務工具)
│ └── __tests__/ # 6 組單元測試套件與 runAllTests.ts 測試運行器
├── AGENTS.md # AI 操作手冊(含去 AI 寫作原則、競爭情報分析與 4 步投遞 SOP)
├── MY_PROFILE.example.md # 求職分身設定檔範本
└── package.json # v1.2.1寫在最後
求職不該是求職者與企業人資之間的「垃圾信轟炸攻防」。
善用 AI 替你過濾雜訊、診斷競爭態勢、填寫繁瑣表單,把時間和精力省下來,留給真正與未來主管、團隊交流的關鍵時刻。
希望這個專案能幫你少走一點冤枉路,順利找到合適的位置。
Available Tools
11 toolsjob104_check_sessionA
檢查 104 人力銀行的登入狀態。在開始求職流程前,可呼叫此工具確認 Cookie 是否仍有效,避免在最後投遞時才發現未登入。
Inputs: no named parameters.
job104_get_apply_analysisA
取得單一職缺的應徵者競爭情報分析:透過數學精算反推確切應徵人數(total),以及學歷、年資、年齡、語言、主要科系、擅長技能與證照分布。僅在評估競爭態勢或求職信對齊時使用。
Inputs: jobUrlOrId (required).
job104_get_company_detailB
取得單一公司的詳細內容(簡介、福利、聯絡人)與開放職缺列表,支援以 keyword 在該公司所有職缺 JD 內文中全文比對關鍵字。
Inputs: companyInput (required), keyword.
job104_get_cover_lettersA
讀取您 104 帳號中儲存的所有自我推薦信(Cover Letter)範本,包含範本名稱、內文與是否為預設。
Inputs: job_url (required).
job104_get_detailsA
取得單一職缺的詳細內容與條件要求
Inputs: job_url (required).
job104_prepare_applicationA
開啟應徵視窗並填入資訊,支援選擇特定推薦信範本或覆蓋填入客製化推薦信。此工具僅作輔助,需人類最後確認送出。
Inputs: job_url (required), dry_run, template_title, cover_letter_text.
job104_reload_serverA
優雅重新啟動 MCP 伺服器以載入新編譯的代碼,不中斷 stdio 管道。
Inputs: no named parameters.
job104_save_companyB
將指定的公司代碼加入您 104 帳號的追蹤名單中。此工具會直接執行寫入操作,需先確認已登入。
Inputs: companyInput (required).
job104_save_jobA
將指定的職缺代碼加入您 104 帳號的「我的收藏」中。此工具會直接執行寫入操作,需先確認已登入。
Inputs: jobInput (required).
job104_searchB
搜尋 104 人力銀行的職缺,支援薪資下限、排除面議/廣告職缺、遠端型態、全兼職與最新排序
Inputs: keyword (required), page, sort, remote, +5 more.
job104_search_companiesA
搜尋 104 人力銀行上的公司資訊,可根據公司名稱關鍵字搜尋,回傳包含產業別、地點、現有職缺數量等資訊。
Inputs: keyword (required), page, pageSize.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool targets a clearly distinct resource and action: job search/details, company search/details, application preparation, competition analysis, session check, cover letters, and saving jobs/companies. The job and company variants are easy to distinguish, and the specialized analysis/application tools do not overlap with the core search tools.
All tools use the same job104_ prefix and snake_case, with mostly predictable verb_noun naming such as get_details, search_companies, save_job, and check_session. Minor deviations exist, notably search without an explicit noun and reload_server as an operational utility.
Eleven tools is well-scoped for a job-hunting workflow covering search, company research, application preparation, competition analysis, and saved-item actions. The set is neither thin nor bloated, and each tool has a plausible role.
Core workflows are covered: searching jobs and companies, viewing details, checking login, reading cover letters, preparing applications, and saving jobs/companies. However, lifecycle coverage is incomplete: saved jobs/companies have save but no list/remove operations, cover letters are read-only, and application history/status tracking is absent.
Maintenance
Related MCP Connectors
Public MCP server for discovering open jobs. Search, filter, and get application links.
GetJobzi MCP server for job search, application tracking, and career forecasting.
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
Related MCP Servers
AlicenseNot gradedqualityBmaintenanceMCP server for job search and application tracking, enabling AI agents to search jobs, get details, manage applications, and find contacts across 128K+ jobs and 1,900+ companies.1,315 npm3MIT- AlicenseCqualityCmaintenanceAn MCP server that enables AI-assisted job search workflows including job discovery, application tracking, resume evaluation, and cover letter generation, with support for multiple job sources and scheduled scraping.8356 npm1AGPL 3.0
- AlicenseNot gradedqualityCmaintenanceAn MCP server that exposes job-search and application-management capabilities to compatible AI clients, enabling discovery of vacancies, drafting of tailored application materials, and coordinated human-approved submissions.MIT
- AlicenseAqualityBmaintenanceAn MCP server that automates job applications by discovering postings from ATS boards, applying eligibility gates, scoring candidates, and drafting answers, while requiring human approval before submission. It respects anti-bot controls and only submits with explicit consent.22196 npm2MIT