mcp-server-104 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 a7512cs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,229 @@
+# mcp-server-104
+
+台灣 104 人力銀行的 MCP server。讓 Claude（或任何 MCP client）能直接搜尋 104 的即時職缺。
+
+## 這個工具適合你嗎？
+
+| 你的情境 | 最佳工具 |
+|---------|---------|
+| 偶爾自己找工作 | 直接開 104 網站 |
+| 想寫個一次性爬蟲抓資料 | Playwright / cycletls 腳本就好，不用 MCP |
+| 不想自己寫腳本，要讓 Claude 直接幫你分析/比對/彙整/自動化職缺 | **這個 MCP** |
+
+## 安裝
+
+以下三種**擇一**，看你用什麼 client：
+
+**A：有快捷指令的 client** —— 一行搞定，設定自動寫好：
+
+```bash
+claude mcp add job104 -- npx -y mcp-server-104   # Claude Code
+```
+
+```bash
+codex mcp add job104 -- npx -y mcp-server-104    # OpenAI Codex CLI（新版才有；舊版走 B 的 TOML）
+```
+
+**B：手動貼設定的 client** —— 把設定貼進該 client 的 MCP 設定檔：
+
+Claude Desktop / Cursor / Windsurf（JSON）：
+
+```json
+{
+  "mcpServers": {
+    "job104": { "command": "npx", "args": ["-y", "mcp-server-104"] }
+  }
+}
+```
+
+OpenAI Codex CLI 舊版（`~/.codex/config.toml`）：
+
+```toml
+[mcp_servers.job104]
+command = "npx"
+args = ["-y", "mcp-server-104"]
+```
+
+> A 和 B 做的是同一件事：告訴 client「用 npx 啟動這個 server」。核心到哪都是 `npx -y mcp-server-104`，差別只在各家 client 怎麼登記它。
+>
+> ⚠️ ChatGPT 網頁／桌面版**接不上**這種本機型（stdio）server —— 它只支援遠端 URL 型 MCP，它的雲端上沒有你的電腦可以跑 `npx`。
+
+**C：開發者，想改 code** —— clone 這個 repo 後：
+
+```bash
+npm install && npm run build
+claude mcp add job104 -- node /你的路徑/104-mcp-server/dist/index.js
+```
+
+日常指令與測試策略見下方「開發」。
+
+## 用什麼方法取得資料
+
+104 的搜尋 API 藏在 Cloudflare bot 防護後面。用 `curl` 或 Node `fetch`（即使帶 Referer / User-Agent）都會被擋 —— 回 403 或 Cloudflare 的 "Just a moment..." 挑戰頁。
+
+**關鍵不是 header，是 TLS 指紋。** Cloudflare 會檢查 TLS 握手的指紋（JA3）；一般程式的指紋一看就不是瀏覽器，直接被攔。
+
+本專案用 **[cycletls](https://github.com/Danny-Dasilva/CycleTLS)** 偽裝成 Chrome 的 TLS 指紋，讓 Cloudflare 以為請求來自真瀏覽器 → 放行。這樣**不用開瀏覽器**（比 Playwright / Selenium 輕一個量級、快、好部署），純 HTTP 就能拿到真實 JSON。
+
+> cycletls 底層是一個 Go 寫的 TLS client 子程序，server 啟動時開一次、全程共用。
+
+## 現在有什麼
+
+| Tool | 狀態 | 說明 |
+|------|------|------|
+| `search_jobs` | ✅ 真實資料 | 依關鍵字 + 多種篩選搜尋職缺，支援分頁 |
+| `get_job_detail` | ✅ 真實資料 | 取得單筆職缺完整詳情：完整 JD、薪資、地點、學經歷要求、技能、語言能力、福利、產業別 |
+| `get_company_jobs` | ✅ 真實資料 | 列出某公司所有在徵職缺（分頁） |
+
+### `search_jobs` 參數
+
+| 參數 | 必填 | 說明 |
+|------|:----:|------|
+| `keyword` | ✅ | 職務關鍵字，例如 `Rust 工程師` |
+| `area` | | 工作地區名稱，例如 `台北市`、`新竹`（自動解析成 104 官方地區代碼查詢）。同名多區（如「信義區」有台北/基隆兩個）不會直接搜，改回 `ambiguousArea` 候選清單讓模型跟你確認 |
+| `salaryMin` | | 月薪下限（新台幣），例如 `60000`。薪資明確低於此值的濾掉；面議預設保留 |
+| `excludeNegotiable` | | 設 `true` 排除「面議」職缺。預設 `false` |
+| `excludeFeatured` | | 設 `true` 排除 104 付費廣告職缺（`featured=true` 那些）。預設 `false` |
+| `jobCategory` | | 職務類別名稱，例如 `軟體工程師`（自動解析成 104 官方職類代碼查詢） |
+| `remote` | | 遠端：`full` 完全遠端 / `partial` 部分遠端 / `any` 皆可 |
+| `jobType` | | 工作性質：`fulltime` 全職 / `parttime` 兼職 |
+| `experience` | | 需求年資：`under-1y` / `1-3y` / `3-5y` / `5-10y` / `over-10y` |
+| `sort` | | 排序：`newest` 最新更新在前（掃新缺用，建議配 `excludeFeatured=true`）/ `salary` 待遇高→低。預設相關性 |
+| `page` | | 第幾頁（每頁 20 筆），預設 1。想看更多就往後翻 |
+| `limit` | | 本頁回傳筆數上限，最多 20，預設 5 |
+
+> **篩選參數的實作眉角**（都是觀察 104 官網 UI 實際請求 + `metadata.total` 實測得來的）：
+> 1. `salaryMin` 要同時送 `scmin` + `sctp=M` + `scstrict=1`，缺了 `scstrict` 薪資篩選會被完全忽略。
+> 2. 「面議」薪資值是 `0`，104 預設保留（面議可能開很高）。`excludeNegotiable` 會排除它們。
+> 3. 薪資上限 `9,999,999` 是 104「不設上限」哨兵值，server 端已正規化成「N 元以上」。薪資前綴依原始 `s10` 類型標示（10=面議、30=時薪、40=日薪、50=月薪、60=年薪）—— 兼職多為時薪，別當月薪讀。
+> 4. `remoteWork`=1完全/2部分、`ro`=1全職/2兼職、`jobexp`=1/3/5/10/99（互斥年資級距）。
+> 5. 地區/職類用**樹狀代碼表 + 剪枝**：命中父節點（如「新竹縣市」）就用父代碼，不展開成一堆子代碼 —— 展開太多會讓 104 回 `400`。地區**同名多處**（如「信義區」）不聯集也不搜尋，回 `ambiguousArea` 請模型跟使用者確認（地理上不相干的地方聯集沒意義）；職類多重命中則維持聯集（相關職類一起查通常是想要的）。
+> 6. **廣告偵測**：104 會在結果最前面塞廣告（原始欄位 `jobType=1`），它會**無視關鍵字**（例如護理師搜尋跑出「COACH 精品銷售」）。每筆回傳 `featured` 旗標標記它，`excludeFeatured=true` 可整批濾掉。`jobType=2`（付費優先位）仍符合關鍵字，視為有效結果不標記。搜尋列表刻意不含完整 JD（精簡、避免模型整理清單時把某筆網址對錯到別筆），完整內容用 `get_job_detail`。
+> 7. **掃新缺姿勢**：`sort=newest`（`order=16`，實測）最新更新在前，但廣告位連排序都無視、照樣卡最前面 —— 配 `excludeFeatured=true` 才是乾淨的最新清單。另外 `employeeCount=0` 代表「未公開」（約半數公司不提供），不是 0 人。
+
+> **欄位命名跨三個工具一致**（都對照 104 原始欄位語意，避免同名不同物）：
+>
+> | 概念 | search_jobs | get_job_detail | get_company_jobs |
+> |------|:-----------:|:--------------:|:----------------:|
+> | 職缺代碼（slug，可餵回 `get_job_detail`）| `jobId` | `jobId` | `jobId` |
+> | 職缺網址 | `url` | `url` | `url` |
+> | 地區（區級）| `area` | `area` | `area` |
+> | 完整地址（區+街道）| — | `location` | — |
+> | 需求年資 | — | `experience` | `experience` |
+> | 擅長工具/語言（C++、Linux）| `skills` | `skills` | — |
+> | 職務技能（職類層級，如「軟體工程系統開發」）| — | `jobSkills` | — |
+> | 公司頁網址（餵給 `get_company_jobs`）| `companyUrl` | `companyUrl` | — |
+> | 是否為廣告位（`jobType=1`）| `featured` | — | — |
+> | 更新日期（頁面的「MM/DD更新」）| `appearDate` | `appearDate` | — |
+> | 員工人數 | `employeeCount`（數字，0=未公開） | `employees`（字串） | — |
+>
+> `jobId` 一律是 **slug**（如 `7uqyj`），不是 104 內部數字 —— slug 才能餵回 `get_job_detail`。`skills` 到哪都是「具體技術」。`appearDate` 統一為 `YYYY/MM/DD`。公司職缺**刻意不回**日期：公司 API 原始只有 `8/20` 這種無年份格式，久未更新的殭屍職缺看起來永遠像最近更新（實測有 2025 年的缺混在裡面），跨年靜默誤導 —— 想要某筆的日期，把它的 `jobId` 餵給 `get_job_detail` 拿完整的。
+
+### `get_job_detail` 參數
+
+| 參數 | 必填 | 說明 |
+|------|:----:|------|
+| `jobUrlOrId` | ✅ | 職缺網址或代碼，例如 `https://www.104.com.tw/job/7uqyj` 或 `7uqyj`（用 `search_jobs` 回傳的 `url`） |
+
+### `get_company_jobs` 參數
+
+| 參數 | 必填 | 說明 |
+|------|:----:|------|
+| `companyUrlOrId` | ✅ | 公司網址或代碼，例如 `https://www.104.com.tw/company/1a2x6blghh` 或 `1a2x6blghh` |
+| `page` | | 第幾頁（每頁 20 筆），預設 1 |
+| `limit` | | 本頁回傳筆數上限，最多 20，預設 10 |
+
+**三個工具怎麼串**：
+- `search_jobs` / `get_job_detail` 每筆都回 `url`（職缺）和 `companyUrl`（公司）兩個網址。
+- 想看某筆職缺完整內容 → 把它的 `url` 餵給 `get_job_detail`。
+- 想看「這家公司還有哪些缺」→ 把 `companyUrl` 餵給 `get_company_jobs`（它是**指定公司**的職缺列表，不是關鍵字搜尋）。
+
+```
+search_jobs ─ url ──────→ get_job_detail
+      │                        │
+      └─ companyUrl ───────────┴──→ get_company_jobs
+```
+
+## 104 內部 API 參考
+
+主要 endpoint：
+
+```
+GET https://www.104.com.tw/jobs/search/api/jobs
+```
+
+必要 header：`Referer: https://www.104.com.tw/jobs/search/`、`Accept-Language: zh-TW`
+
+常用查詢參數（本專案目前只用到部分，其餘供未來擴充）：
+
+| 參數 | 意義 | 範例值 |
+|------|------|--------|
+| `keyword` | 關鍵字 | 自由文字 |
+| `kwop` | 關鍵字運算 | `7`（全符合） |
+| `order` | 排序 | `15` 相關性(預設) · `16` 最新（實測） · `13` 薪資 |
+| `page` / `pagesize` | 分頁 | `pagesize` 建議 20 |
+| `area` | 地區碼（逗號分隔） | 查 `Area.json`（見下） |
+| `jobcat` | 職類碼（逗號分隔） | 查 `JobCat.json` |
+| `scmin` + `scstrict=1` | 最低薪資 | 整數 |
+| `remoteWork` | 遠端 | `1` 完全遠端 · `2` 部分 · `1,2` 皆可（實測） |
+| `ro` | 全/兼職 | `1` 全職 · `2` 兼職（實測；`wt` 部分值會 400，不用） |
+| `jobexp` | 年資 | `1`/`3`/`5`/`10`/`99` = 1年下/1-3/3-5/5-10/10年上（互斥級距，實測） |
+| `edu` | 學歷 | `4,5,6` 大學以上 等 |
+
+地區 / 職類代碼表（放 `static.104.com.tw`，**沒有 Cloudflare 擋**，一般 fetch 就能拿）：
+
+```
+https://static.104.com.tw/category-tool/json/Area.json
+https://static.104.com.tw/category-tool/json/JobCat.json
+```
+
+其他 endpoint：
+- 職缺詳情：`GET https://www.104.com.tw/job/ajax/content/{slug}`（Referer 指向 `/job/{slug}`）
+- 公司職缺：`GET https://www.104.com.tw/api/companies/{code}/jobs?page=1&pageSize=20`（回 `list.topJobs` + `list.normalJobs`）
+
+## 檔案結構
+
+```
+src/
+  index.ts            進入點：建 server、掛 tool、接 stdio、處理關閉
+  config.ts           所有設定 / 魔術數字（JA3 指紋、endpoint、節流區間…）
+  types.ts            乾淨型別 + normalizeJob / JobDetail / CompanyJob（防腐層）
+  query.ts            純函式：組查詢網址、client 端過濾、enum 對照
+  slug.ts             從 104 網址取出職缺 slug / 公司碼（types/query 共用）
+  codes.ts            地區/職類「名稱→官方代碼」解析（樹狀比對+剪枝，快取代碼表）
+  api/
+    httpClient.ts     cycletls 單例（TLS 指紋偽裝）
+    throttle.ts       禮貌性隨機節流 1.5~3.5s
+    job104.ts         104 抓取層：組 URL → 打 API → 重試 → 正規化
+  tools/
+    searchJobs.ts     search_jobs
+    getJobDetail.ts   get_job_detail
+    getCompanyJobs.ts get_company_jobs
+scripts/
+  smoke-test.mjs      手動發 JSON-RPC 驗證，不用開 Claude 也能測
+test/
+  types.test.mjs      normalize 邏輯（薪資格式、面議、哨兵值…）
+  query.test.mjs      組網址 / slug / 公司碼 / 過濾 / enum 對照
+  codes.test.mjs      代碼表樹狀比對 + 剪枝
+```
+
+## 開發
+
+```bash
+npm run build                 # 編譯 src → dist
+npm test                      # 跑單元測試（先 build 再 node --test，零額外依賴）
+node scripts/smoke-test.mjs   # 煙霧測試（連真實 104）
+npm run inspect               # 開 MCP Inspector GUI 除錯
+```
+
+改完 code 要 `npm run build`，然後重啟 Claude Code（或用 `/mcp` reconnect）才會生效 —— client 只在 session 啟動時抓一次工具清單。
+
+**測試策略**：純邏輯（normalize、組網址、過濾）都抽到 `types.ts` / `query.ts`，用 Node 內建 `node --test` 測，快又不用連網 —— 改壞馬上知道。碰網路的部分（`job104.ts` / `httpClient.ts`）用 smoke-test 對真實 104 驗證。
+
+## ⚠️ 免責聲明
+
+- 104 **沒有公開官方 API**。本專案使用的是網頁前端的**非官方內部 endpoint**，隨時可能因 104 改版而失效。
+- 自動化存取**可能違反 104 的服務條款**。本專案僅供**個人、低頻、學習用途**。
+- **請勿**拿去做高頻抓取、大量爬取，或架成公開服務 —— 容易被封鎖，也有法律風險。
+- 本專案已內建禮貌性節流（每次請求間隔隨機 1.5~3.5 秒），請勿移除或調低。
+- 使用本專案造成的任何後果，使用者自負。

package/dist/api/httpClient.js

@@ -0,0 +1,32 @@
+/**
+ * HTTP client：懶啟動 + 全程共用一個 cycletls 實例。
+ *
+ * 為什麼共用：initCycleTLS 會啟一個 Go 子程序（偽裝 TLS 指紋用），
+ * 啟動很貴，所以整個 server 生命週期只開一次。
+ *
+ * 註：cycletls 是 CommonJS 套件，型別匯出在 TS7 + NodeNext 下有相容問題，
+ * 因此用 createRequire 載入 runtime、用 import type 拿型別，兩者分開最穩。
+ */
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const initCycleTLS = require("cycletls");
+const log = (...args) => console.error("[104-mcp:http]", ...args);
+let clientPromise = null;
+/** 取得共用的 cycletls client（第一次呼叫才啟動） */
+export async function getClient() {
+    if (!clientPromise) {
+        log("starting cycletls...");
+        clientPromise = initCycleTLS();
+    }
+    return clientPromise;
+}
+/** 關掉 client 子程序（程式結束時呼叫，避免留殭屍程序） */
+export async function closeClient() {
+    if (clientPromise) {
+        const client = await clientPromise;
+        await client.exit();
+        clientPromise = null;
+        log("cycletls closed");
+    }
+}
+//# sourceMappingURL=httpClient.js.map

package/dist/api/httpClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpClient.js","sourceRoot":"","sources":["../../src/api/httpClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAEX,CAAC;AAE7B,MAAM,GAAG,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,GAAG,IAAI,CAAC,CAAC;AAE7E,IAAI,aAAa,GAAmC,IAAI,CAAC;AAEzD,sCAAsC;AACtC,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,GAAG,CAAC,sBAAsB,CAAC,CAAC;QAC5B,aAAa,GAAG,YAAY,EAAE,CAAC;IACjC,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,qCAAqC;AACrC,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;QACnC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,aAAa,GAAG,IAAI,CAAC;QACrB,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/api/job104.js

@@ -0,0 +1,135 @@
+/**
+ * 104 抓取層 —— 唯一直接碰 104 的檔案。
+ *
+ * 手法：用 cycletls 偽裝 Chrome 的 TLS 指紋，直接打 104 內部 API。
+ * Cloudflare 看 TLS 握手指紋像真 Chrome 就放行 —— 不用開瀏覽器。
+ * 104 改版時，只改這個檔（+ types.ts 的 normalize）。
+ */
+import { CONFIG } from "../config.js";
+import { getClient } from "./httpClient.js";
+import { waitForTurn } from "./throttle.js";
+import { normalizeJob, normalizeJobDetail, normalizeCompanyJob, } from "../types.js";
+import { buildSearchUrl, extractSlug, extractCompanyCode, filterJobs, REMOTE_CODES, JOB_TYPE_CODES, EXPERIENCE_CODES, SORT_CODES, } from "../query.js";
+import { resolveAreaMatches, resolveJobCatCodes, buildAreaAmbiguity, } from "../codes.js";
+const log = (...args) => console.error("[104-mcp:api]", ...args);
+// ── 共用的底層抓取（搜尋、詳情、公司職缺都用這個）──────────────
+/** 打一次 API，回傳解析後的物件；非 200 或非 JSON（被擋）時丟錯 */
+async function fetchOnce(url, referer) {
+    await waitForTurn(); // 禮貌性節流：距上次請求隨機間隔 1.5~3.5s
+    const client = await getClient();
+    const res = await client(url, {
+        ja3: CONFIG.ja3,
+        userAgent: CONFIG.userAgent,
+        headers: {
+            Accept: "application/json, text/plain, */*",
+            "Accept-Language": "zh-TW,zh;q=0.9",
+            Referer: referer,
+        },
+        timeout: Math.floor(CONFIG.requestTimeoutMs / 1000), // cycletls 以秒為單位
+    }, "get");
+    if (res.status !== 200) {
+        throw new Error(`104 回應 status=${res.status}（可能被 Cloudflare 阻擋）`);
+    }
+    const body = res.data;
+    if (typeof body !== "object" || body === null) {
+        throw new Error("104 回應不是預期的 JSON（可能是 Cloudflare 挑戰頁）");
+    }
+    return body;
+}
+/** 帶重試的抓取 —— Cloudflare 偶發失敗，多試幾次通常就過（節流自然拉開間隔） */
+async function fetchWithRetry(url, referer) {
+    let lastError;
+    for (let attempt = 0; attempt <= CONFIG.maxRetries; attempt++) {
+        if (attempt > 0)
+            log(`retry ${attempt}/${CONFIG.maxRetries}`);
+        try {
+            return await fetchOnce(url, referer);
+        }
+        catch (err) {
+            lastError = err;
+            log(`attempt ${attempt} failed:`, err instanceof Error ? err.message : err);
+        }
+    }
+    throw lastError instanceof Error ? lastError : new Error(String(lastError));
+}
+/** 依關鍵字 + 篩選條件搜尋職缺。地區同名多處時回 AreaAmbiguityResult（不搜尋，讓模型跟使用者確認） */
+export async function searchJobs(params) {
+    const { keyword, area, salaryMin, excludeNegotiable, excludeFeatured, jobCategory, remote, jobType, experience, sort, page, limit, } = params;
+    // 地區、職類：名稱 → 官方代碼（抓不到就回空陣列，退回 client 端子字串過濾）
+    const [areaMatches, jobCatCodes] = await Promise.all([
+        area ? resolveAreaMatches(area) : Promise.resolve([]),
+        jobCategory ? resolveJobCatCodes(jobCategory) : Promise.resolve([]),
+    ]);
+    // 同名多區（如「信義區」= 台北+基隆）：地理上不相干，聯集沒意義 → 回去確認
+    if (areaMatches.length > 1) {
+        log(`area "${area}" ambiguous: ${areaMatches.map((m) => m.name).join(", ")}`);
+        return buildAreaAmbiguity(area, areaMatches);
+    }
+    const areaCodes = areaMatches.map((m) => m.code);
+    const url = buildSearchUrl({
+        keyword,
+        salaryMin,
+        excludeNegotiable,
+        areaCodes,
+        jobCatCodes,
+        remoteWork: remote ? REMOTE_CODES[remote] : undefined,
+        jobType: jobType ? JOB_TYPE_CODES[jobType] : undefined,
+        experience: experience ? EXPERIENCE_CODES[experience] : undefined,
+        order: sort ? SORT_CODES[sort] : undefined,
+        page,
+    });
+    log(`search: ${url}`);
+    const body = await fetchWithRetry(url, CONFIG.referer);
+    const rawJobs = Array.isArray(body.data) ? body.data : [];
+    const pagination = body.metadata?.pagination;
+    log(`captured ${rawJobs.length} raw jobs (total=${pagination?.total ?? "?"})`);
+    // 正規化 → client 端過濾（地區 + 排除面議）
+    const normalized = rawJobs.map((raw) => normalizeJob(raw));
+    const filtered = filterJobs(normalized, { area, excludeNegotiable, excludeFeatured });
+    return {
+        total: pagination?.total ?? filtered.length,
+        page: page ?? 1,
+        jobs: filtered.slice(0, limit),
+    };
+}
+// ── 職缺詳情 ──────────────────────────────────────────────────
+/** 取得單筆職缺的完整詳情 */
+export async function getJobDetail(jobUrlOrSlug) {
+    const slug = extractSlug(jobUrlOrSlug);
+    if (!slug)
+        throw new Error("無法從輸入取得職缺代碼");
+    const url = `${CONFIG.jobDetailApiBase}${slug}`;
+    const referer = `${CONFIG.jobPageBase}${slug}`;
+    log(`detail: ${url}`);
+    const body = await fetchWithRetry(url, referer);
+    const data = body.data;
+    if (typeof data !== "object" || data === null) {
+        throw new Error(`找不到職缺 ${slug} 的詳情`);
+    }
+    // 補上 jobId(slug) 與 url，讓詳情跟搜尋/公司職缺的欄位一致
+    return normalizeJobDetail(data, { jobId: slug, url: referer });
+}
+/** 取得某公司的所有職缺（分頁） */
+export async function getCompanyJobs(params) {
+    const { companyUrlOrCode, page, limit } = params;
+    const code = extractCompanyCode(companyUrlOrCode);
+    if (!code)
+        throw new Error("無法從輸入取得公司代碼");
+    const query = new URLSearchParams({ page: String(page ?? 1), pageSize: String(CONFIG.pageSize) });
+    const url = `${CONFIG.companyApiBase}${code}/jobs?${query.toString()}`;
+    const referer = `${CONFIG.companyPageBase}${code}`;
+    log(`company jobs: ${url}`);
+    const body = await fetchWithRetry(url, referer);
+    const data = body.data;
+    if (!data)
+        throw new Error(`找不到公司 ${code} 的職缺`);
+    // 合併「置頂職缺」+「一般職缺」
+    const raw = [...(data.list?.topJobs ?? []), ...(data.list?.normalJobs ?? [])];
+    const jobs = raw.map((r) => normalizeCompanyJob(r));
+    return {
+        total: data.totalCount ?? jobs.length,
+        page: page ?? 1,
+        jobs: jobs.slice(0, limit),
+    };
+}
+//# sourceMappingURL=job104.js.map

package/dist/api/job104.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job104.js","sourceRoot":"","sources":["../../src/api/job104.ts"],"names":[],"mappings":"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"}

package/dist/api/throttle.js

@@ -0,0 +1,20 @@
+/**
+ * 禮貌性節流：確保兩次對 104 的請求之間，至少間隔一段隨機時間。
+ *
+ * 為什麼隨機：固定間隔（例如每 2 秒一次）本身就是一種機器人特徵，
+ * 在 min~max 間隨機更像真人操作，降低被偵測/封鎖的機率。
+ */
+import { CONFIG } from "../config.js";
+let lastRequestAt = 0;
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/** 呼叫後保證距離上一次請求已間隔隨機 min~max 毫秒 */
+export async function waitForTurn() {
+    const span = CONFIG.throttleMaxMs - CONFIG.throttleMinMs;
+    const gap = CONFIG.throttleMinMs + Math.random() * span;
+    const elapsed = Date.now() - lastRequestAt;
+    if (lastRequestAt > 0 && elapsed < gap) {
+        await sleep(gap - elapsed);
+    }
+    lastRequestAt = Date.now();
+}
+//# sourceMappingURL=throttle.js.map

package/dist/api/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../src/api/throttle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,IAAI,aAAa,GAAG,CAAC,CAAC;AAEtB,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAEpE,mCAAmC;AACnC,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;IACzD,MAAM,GAAG,GAAG,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC;IAC3C,IAAI,aAAa,GAAG,CAAC,IAAI,OAAO,GAAG,GAAG,EAAE,CAAC;QACvC,MAAM,KAAK,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC;IAC7B,CAAC;IACD,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAC7B,CAAC"}

package/dist/codes.js

@@ -0,0 +1,109 @@
+/**
+ * 地區 / 職類「名稱 → 官方代碼」解析。
+ *
+ * 104 的搜尋 API 篩地區、職類要用官方代碼（例如台北市=6001001000）。
+ * 代碼表是樹狀 JSON，放在 static.104（沒有 Cloudflare），一般 fetch 就能拿。
+ * 抓一次快取在記憶體，之後查詢直接用。
+ */
+import { CONFIG } from "./config.js";
+const log = (...args) => console.error("[104-mcp:codes]", ...args);
+/** 把樹狀代碼表攤平成一維陣列（含所有層級） */
+export function flattenTree(nodes) {
+    const out = [];
+    const walk = (list) => {
+        for (const node of list) {
+            if (node.no && node.des)
+                out.push({ code: node.no, name: node.des });
+            if (node.n?.length)
+                walk(node.n);
+        }
+    };
+    walk(nodes);
+    return out;
+}
+/** 太多筆表示查詢字太模糊（例如「市」），回空陣列讓上層改用其他方式 */
+const MAX_MATCHES = 30;
+/**
+ * 用名稱在樹上找代碼，關鍵是「剪枝」：
+ * 一旦某節點名稱命中，就用它的代碼、且不再往下展開子節點
+ * —— 因為父節點（例如「新竹縣市」）本身就涵蓋所有子區，
+ * 展開成一堆子代碼反而會讓 104 回 400（代碼數量有上限）。
+ * 太模糊（>30 筆）就放棄，回空陣列讓上層改用 client 端子字串過濾。
+ * 回傳 code+name（名稱給同名多區的確認訊息用）。
+ */
+export function matchCodes(nodes, query) {
+    const q = query.trim();
+    if (!q)
+        return [];
+    const out = [];
+    const walk = (list) => {
+        for (const node of list) {
+            if (node.des?.includes(q)) {
+                if (node.no)
+                    out.push({ code: node.no, name: node.des }); // 命中 → 收代碼、剪枝（不進子節點）
+            }
+            else if (node.n?.length) {
+                walk(node.n); // 沒中才往下找更細的
+            }
+        }
+    };
+    walk(nodes);
+    if (out.length === 0 || out.length > MAX_MATCHES)
+        return [];
+    return out;
+}
+/** 組出同名多區的確認訊息（例如「信義區」→ 台北市信義區、基隆市信義區） */
+export function buildAreaAmbiguity(query, matches) {
+    const names = matches.map((m) => m.name).join("、");
+    return {
+        ambiguousArea: {
+            query,
+            matches,
+            hint: `地區「${query}」同名多處：${names}。` +
+                `請向使用者確認要哪一個，再用完整名稱（如「${matches[0]?.name ?? query}」）重新搜尋；` +
+                `若使用者全部都要，就分別搜尋再彙整。`,
+        },
+    };
+}
+// ── 快取 + 抓取 ──────────────────────────────────────────────
+let areaTree = null;
+let jobCatTree = null;
+async function fetchTree(url) {
+    const res = await fetch(url, {
+        headers: { "User-Agent": CONFIG.userAgent, Accept: "application/json" },
+    });
+    if (!res.ok)
+        throw new Error(`抓取代碼表失敗 ${url}: ${res.status}`);
+    return (await res.json());
+}
+/** 解析地區名稱 → 命中的節點清單（code+name）。抓不到表時回空陣列，不讓整個搜尋失敗 */
+export async function resolveAreaMatches(query) {
+    if (!areaTree) {
+        log("fetching Area.json...");
+        areaTree = fetchTree(CONFIG.areaJsonUrl);
+    }
+    try {
+        return matchCodes(await areaTree, query);
+    }
+    catch (err) {
+        areaTree = null; // 失敗就清掉快取，下次重試
+        log("resolveAreaMatches failed:", err instanceof Error ? err.message : err);
+        return [];
+    }
+}
+/** 解析職類名稱 → 官方代碼陣列。多重命中維持聯集（相關職類一起查通常是想要的） */
+export async function resolveJobCatCodes(query) {
+    if (!jobCatTree) {
+        log("fetching JobCat.json...");
+        jobCatTree = fetchTree(CONFIG.jobCatJsonUrl);
+    }
+    try {
+        return matchCodes(await jobCatTree, query).map((m) => m.code);
+    }
+    catch (err) {
+        jobCatTree = null;
+        log("resolveJobCatCodes failed:", err instanceof Error ? err.message : err);
+        return [];
+    }
+}
+//# sourceMappingURL=codes.js.map

package/dist/codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codes.js","sourceRoot":"","sources":["../src/codes.ts"],"names":[],"mappings":"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"}

package/dist/config.js

@@ -0,0 +1,38 @@
+/** 全域設定：所有魔術數字集中在這裡，方便調整。 */
+export const CONFIG = {
+    /** 104 內部搜尋 API（直接打，用 TLS 指紋偽裝過 Cloudflare） */
+    searchApiUrl: "https://www.104.com.tw/jobs/search/api/jobs",
+    /** 搜尋 API 的 Referer（104 會檢查） */
+    referer: "https://www.104.com.tw/jobs/search/",
+    /** 職缺詳情 API（slug 接在後面） */
+    jobDetailApiBase: "https://www.104.com.tw/job/ajax/content/",
+    /** 職缺頁網址（拿來當詳情請求的 Referer，slug 接在後面） */
+    jobPageBase: "https://www.104.com.tw/job/",
+    /** 公司職缺 API（公司代碼接在中間：/api/companies/{code}/jobs） */
+    companyApiBase: "https://www.104.com.tw/api/companies/",
+    /** 公司頁網址（當公司請求的 Referer，代碼接在後面） */
+    companyPageBase: "https://www.104.com.tw/company/",
+    /** 地區代碼表（樹狀 JSON，放 static.104，沒有 Cloudflare） */
+    areaJsonUrl: "https://static.104.com.tw/category-tool/json/Area.json",
+    /** 職類代碼表（樹狀 JSON，放 static.104，沒有 Cloudflare） */
+    jobCatJsonUrl: "https://static.104.com.tw/category-tool/json/JobCat.json",
+    /**
+     * Chrome 的 JA3 TLS 指紋。cycletls 用這個讓 TLS 握手長得像真 Chrome，
+     * 騙過 Cloudflare 的 bot 偵測。Chrome 大改版時可能要更新這串。
+     */
+    ja3: "771,4865-4866-4867-49195-49199-49196-49200-52393-52392-49171-49172-156-157-47-53,0-23-65281-10-11-35-16-5-13-18-51-45-43-27-17513,29-23-24,0",
+    /** 配合指紋的 User-Agent（要跟 ja3 的 Chrome 版本大致一致） */
+    userAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/140.0.0.0 Safari/537.36",
+    /** 單次請求逾時（毫秒） */
+    requestTimeoutMs: 15_000,
+    /** 回傳非 200 時的重試次數（Cloudflare 偶發 403 用） */
+    maxRetries: 2,
+    /** 兩次請求間的最小間隔（毫秒），實際會在 min~max 間隨機，降低被 ban 風險 */
+    throttleMinMs: 1_500,
+    throttleMaxMs: 3_500,
+    /** 每頁抓幾筆（我們再依 limit 切） */
+    pageSize: 20,
+    /** 回傳筆數硬上限，避免一次抓太多 */
+    maxLimit: 20,
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,+CAA+C;IAC/C,YAAY,EAAE,6CAA6C;IAC3D,gCAAgC;IAChC,OAAO,EAAE,qCAAqC;IAC9C,0BAA0B;IAC1B,gBAAgB,EAAE,0CAA0C;IAC5D,wCAAwC;IACxC,WAAW,EAAE,6BAA6B;IAC1C,oDAAoD;IACpD,cAAc,EAAE,uCAAuC;IACvD,mCAAmC;IACnC,eAAe,EAAE,iCAAiC;IAClD,gDAAgD;IAChD,WAAW,EAAE,wDAAwD;IACrE,gDAAgD;IAChD,aAAa,EAAE,0DAA0D;IACzE;;;OAGG;IACH,GAAG,EAAE,8IAA8I;IACnJ,+CAA+C;IAC/C,SAAS,EACP,uHAAuH;IACzH,iBAAiB;IACjB,gBAAgB,EAAE,MAAM;IACxB,0CAA0C;IAC1C,UAAU,EAAE,CAAC;IACb,iDAAiD;IACjD,aAAa,EAAE,KAAK;IACpB,aAAa,EAAE,KAAK;IACpB,0BAA0B;IAC1B,QAAQ,EAAE,EAAE;IACZ,sBAAsB;IACtB,QAAQ,EAAE,EAAE;CACJ,CAAC"}

package/dist/index.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+/**
+ * 104 MCP Server —— 進入點。
+ * 只做組裝：建 server、掛 tool、接上 stdio、處理關閉。
+ * 實際邏輯都在 tools/ 和 api/。
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerSearchJobs } from "./tools/searchJobs.js";
+import { registerGetJobDetail } from "./tools/getJobDetail.js";
+import { registerGetCompanyJobs } from "./tools/getCompanyJobs.js";
+import { closeClient } from "./api/httpClient.js";
+const log = (...args) => console.error("[104-mcp]", ...args);
+const server = new McpServer({ name: "mcp-server-104", version: "0.1.0" });
+registerSearchJobs(server);
+registerGetJobDetail(server);
+registerGetCompanyJobs(server);
+/** 收到結束訊號時先關 client 子程序再退出，避免留下殭屍程序 */
+function installShutdown() {
+    const shutdown = async (signal) => {
+        log(`received ${signal}, closing http client...`);
+        await closeClient().catch(() => { });
+        process.exit(0);
+    };
+    process.on("SIGINT", () => void shutdown("SIGINT"));
+    process.on("SIGTERM", () => void shutdown("SIGTERM"));
+}
+async function main() {
+    installShutdown();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    log("server ready on stdio");
+}
+main().catch((err) => {
+    log("fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,GAAG,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,CAAC;AAExE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAE3E,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC3B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAE/B,uCAAuC;AACvC,SAAS,eAAe;IACtB,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;QACxC,GAAG,CAAC,YAAY,MAAM,0BAA0B,CAAC,CAAC;QAClD,MAAM,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,eAAe,EAAE,CAAC;IAClB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAC/B,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/query.js

@@ -0,0 +1,72 @@
+/**
+ * 純函式：組查詢網址、解析 slug、套用 client 端過濾。
+ *
+ * 刻意跟 job104.ts（網路 I/O）分開 —— 這些沒有副作用、不碰網路，
+ * 好測、好懂。所有「眉角知識」（篩選參數對照）都集中在這。
+ */
+import { CONFIG } from "./config.js";
+import { NEGOTIABLE } from "./types.js";
+// slug/公司碼解析移到 slug.ts（types.ts 也要用，抽出來避免重複）。這裡再匯出保持相容。
+export { extractSlug, extractCompanyCode } from "./slug.js";
+// ── 友善 enum → 104 代碼對照（都用 metadata.total 實測驗證過）───────
+/** 遠端工作：完全遠端 / 部分遠端 / 兩者皆可 */
+export const REMOTE_CODES = { full: "1", partial: "2", any: "1,2" };
+/** 工作性質（ro）：全職 / 兼職 */
+export const JOB_TYPE_CODES = { fulltime: "1", parttime: "2" };
+/** 年資（jobexp）：104 的互斥級距 */
+export const EXPERIENCE_CODES = {
+    "under-1y": "1",
+    "1-3y": "3",
+    "3-5y": "5",
+    "5-10y": "10",
+    "over-10y": "99",
+};
+/** 排序（order）：newest=16 最新更新在前（掃新缺/擴編偵測用）、salary=13 待遇高→低。預設 15 相關性 */
+export const SORT_CODES = { newest: "16", salary: "13" };
+/** 組出搜尋 API 網址 */
+export function buildSearchUrl(q) {
+    const params = new URLSearchParams({
+        keyword: q.keyword,
+        order: q.order ?? "15", // 預設相關性排序
+        pagesize: String(CONFIG.pageSize),
+    });
+    if (q.page && q.page > 1)
+        params.set("page", String(q.page));
+    if (q.salaryMin && q.salaryMin > 0) {
+        // 這幾個參數是「觀察 104 官網篩選 UI 實際送出的請求」得來的，缺一不可：
+        params.set("scmin", String(q.salaryMin)); // 薪資下限
+        params.set("sctp", "M"); // 薪資類型：月薪（104 會自動換算年薪職缺）
+        params.set("scstrict", "1"); // 嚴格比對 —— 少了這個 scmin 會被完全忽略！
+        // scneg 只在有薪資篩選時生效：1=保留面議、0=排除面議（實測單獨用無效）
+        params.set("scneg", q.excludeNegotiable ? "0" : "1");
+    }
+    if (q.areaCodes?.length)
+        params.set("area", q.areaCodes.join(","));
+    if (q.jobCatCodes?.length)
+        params.set("jobcat", q.jobCatCodes.join(","));
+    if (q.remoteWork)
+        params.set("remoteWork", q.remoteWork);
+    if (q.jobType)
+        params.set("ro", q.jobType); // 全職/兼職
+    if (q.experience)
+        params.set("jobexp", q.experience); // 年資級距
+    return `${CONFIG.searchApiUrl}?${params.toString()}`;
+}
+/** 套用 client 端過濾：地區子字串 + 排除面議 + 排除廣告 */
+export function filterJobs(jobs, opts) {
+    let result = [...jobs];
+    if (opts.area) {
+        result = result.filter((job) => job.area.includes(opts.area));
+    }
+    // 排除面議：因為 104 的 scneg 只在有薪資篩選時生效，
+    // 且最上方常有不受篩選的推薦職缺漏進來，這裡再保險一次。
+    if (opts.excludeNegotiable) {
+        result = result.filter((job) => job.salary !== NEGOTIABLE);
+    }
+    // 排除 104 付費推廣位（jobType≠0）—— 這些會無視關鍵字硬塞在最前面
+    if (opts.excludeFeatured) {
+        result = result.filter((job) => !job.featured);
+    }
+    return result;
+}
+//# sourceMappingURL=query.js.map

package/dist/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"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"}

package/dist/slug.js

@@ -0,0 +1,20 @@
+/**
+ * 從 104 網址取出代碼的純函式（無相依，types/query 共用，避免重複 regex）。
+ */
+/**
+ * 職缺 slug：吃得下完整網址或裸 slug。
+ * 例：https://www.104.com.tw/job/7uqyj?foo=bar → 7uqyj；7uqyj → 7uqyj
+ */
+export function extractSlug(input) {
+    const match = input.match(/\/job\/([^/?#]+)/);
+    return (match ? match[1] : input).trim();
+}
+/**
+ * 公司代碼：吃得下完整公司網址或裸代碼。
+ * 例：https://www.104.com.tw/company/1a2x6blghh → 1a2x6blghh
+ */
+export function extractCompanyCode(input) {
+    const match = input.match(/\/company\/([^/?#]+)/);
+    return (match ? match[1] : input).trim();
+}
+//# sourceMappingURL=slug.js.map

package/dist/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../src/slug.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC9C,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAClD,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3C,CAAC"}

package/dist/tools/getCompanyJobs.js

@@ -0,0 +1,52 @@
+/**
+ * get_company_jobs tool 的定義與註冊。
+ * 拿公司網址（或代碼），列出該公司所有在徵職缺（分頁）。
+ */
+import { z } from "zod";
+import { getCompanyJobs } from "../api/job104.js";
+import { CONFIG } from "../config.js";
+export function registerGetCompanyJobs(server) {
+    server.registerTool("get_company_jobs", {
+        title: "列出某公司所有職缺",
+        description: "列出「某一家指定公司」在 104 上所有在徵的職缺（職稱、地區、薪資、學經歷要求、網址）。這不是關鍵字搜尋 —— 是拿一家已知公司去看它全部的缺。公司網址請用 search_jobs 或 get_job_detail 回傳的 companyUrl 欄位。可分頁。",
+        inputSchema: {
+            companyUrlOrId: z
+                .string()
+                .min(1)
+                .describe("公司網址或代碼（用 search_jobs / get_job_detail 回傳的 companyUrl），例如 'https://www.104.com.tw/company/1a2x6blghh' 或 '1a2x6blghh'"),
+            page: z
+                .number()
+                .int()
+                .min(1)
+                .optional()
+                .describe("第幾頁（每頁 20 筆），預設 1"),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(CONFIG.maxLimit)
+                .default(10)
+                .describe(`本頁回傳筆數上限，最多 ${CONFIG.maxLimit}，預設 10`),
+        },
+    }, async ({ companyUrlOrId, page, limit }) => {
+        try {
+            const result = await getCompanyJobs({ companyUrlOrCode: companyUrlOrId, page, limit });
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `取得公司職缺失敗：${message}。104 可能改版或被 Cloudflare 阻擋，稍後再試。`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=getCompanyJobs.js.map

package/dist/tools/getCompanyJobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCompanyJobs.js","sourceRoot":"","sources":["../../src/tools/getCompanyJobs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,WAAW;QAClB,WAAW,EACT,qIAAqI;QACvI,WAAW,EAAE;YACX,cAAc,EAAE,CAAC;iBACd,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CACP,sHAAsH,CACvH;YACH,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,mBAAmB,CAAC;YAChC,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;iBACpB,OAAO,CAAC,EAAE,CAAC;iBACX,QAAQ,CAAC,eAAe,MAAM,CAAC,QAAQ,QAAQ,CAAC;SACpD;KACF,EACD,KAAK,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;QACxC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,EAAE,gBAAgB,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACvF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,YAAY,OAAO,iCAAiC;qBAC3D;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/getJobDetail.js

@@ -0,0 +1,38 @@
+/**
+ * get_job_detail tool 的定義與註冊。
+ * 拿 search_jobs 回傳的職缺網址（或代碼），取得完整詳情。
+ */
+import { z } from "zod";
+import { getJobDetail } from "../api/job104.js";
+export function registerGetJobDetail(server) {
+    server.registerTool("get_job_detail", {
+        title: "取得 104 職缺詳情",
+        description: "取得單筆 104 職缺的完整詳情：完整職務說明、薪資、地點、學經歷要求、需求技能、語言能力、福利、產業別。傳入 search_jobs 結果中的職缺網址（url 欄位）。",
+        inputSchema: {
+            jobUrlOrId: z
+                .string()
+                .min(1)
+                .describe("職缺網址或代碼，例如 'https://www.104.com.tw/job/7uqyj' 或 '7uqyj'（用 search_jobs 回傳的 url）"),
+        },
+    }, async ({ jobUrlOrId }) => {
+        try {
+            const detail = await getJobDetail(jobUrlOrId);
+            return {
+                content: [{ type: "text", text: JSON.stringify(detail, null, 2) }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `取得職缺詳情失敗：${message}。104 可能改版或被 Cloudflare 阻擋，稍後再試。`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=getJobDetail.js.map

package/dist/tools/getJobDetail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getJobDetail.js","sourceRoot":"","sources":["../../src/tools/getJobDetail.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,uFAAuF;QACzF,WAAW,EAAE;YACX,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CACP,gFAAgF,CACjF;SACJ;KACF,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;YAC9C,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,YAAY,OAAO,iCAAiC;qBAC3D;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/searchJobs.js

@@ -0,0 +1,88 @@
+/**
+ * search_jobs tool 的定義與註冊。
+ * 只負責：宣告參數 schema、呼叫抓取層、把結果整理成給模型看的格式。
+ */
+import { z } from "zod";
+import { searchJobs } from "../api/job104.js";
+import { CONFIG } from "../config.js";
+export function registerSearchJobs(server) {
+    server.registerTool("search_jobs", {
+        title: "搜尋 104 職缺",
+        description: "依關鍵字與篩選條件搜尋台灣 104 人力銀行的即時職缺，回傳職稱、公司、地區、薪資、需求技能與職缺網址。支援地區、薪資下限、職類、遠端、全/兼職、年資篩選，以及分頁。" +
+            "若 area 同名多處（如「信義區」有台北市與基隆市兩個），不會直接搜尋，改回傳 ambiguousArea 候選清單 —— 此時請向使用者確認是哪一個，再用完整名稱（如「台北市信義區」）重新搜尋。",
+        inputSchema: {
+            keyword: z.string().min(1).describe("職務關鍵字，例如 'Rust 工程師'"),
+            area: z
+                .string()
+                .optional()
+                .describe("工作地區名稱，例如 '台北市'、'新竹'（會解析成 104 官方地區代碼查詢）"),
+            salaryMin: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe("月薪下限（新台幣），例如 60000。薪資明確低於此值的濾掉；面議預設保留"),
+            excludeNegotiable: z
+                .boolean()
+                .optional()
+                .describe("排除「面議」（沒寫薪資）的職缺，預設 false。想只看有明確薪資時設 true"),
+            excludeFeatured: z
+                .boolean()
+                .optional()
+                .describe("排除 104 付費推廣/廣告職缺（結果中 featured=true 的），預設 false。這些會被 104 硬塞在最前面、常不符合搜尋條件；想只看自然結果時設 true"),
+            jobCategory: z
+                .string()
+                .optional()
+                .describe("職務類別名稱，例如 '軟體工程師'、'行銷企劃'（會解析成 104 官方職類代碼查詢）"),
+            remote: z
+                .enum(["full", "partial", "any"])
+                .optional()
+                .describe("遠端工作：full 完全遠端 / partial 部分遠端 / any 兩者皆可"),
+            jobType: z
+                .enum(["fulltime", "parttime"])
+                .optional()
+                .describe("工作性質：fulltime 全職 / parttime 兼職"),
+            experience: z
+                .enum(["under-1y", "1-3y", "3-5y", "5-10y", "over-10y"])
+                .optional()
+                .describe("需求年資級距：under-1y(1年以下)/1-3y/3-5y/5-10y/over-10y(10年以上)"),
+            sort: z
+                .enum(["newest", "salary"])
+                .optional()
+                .describe("排序：newest 最新更新在前（找新開職缺/掃描擴編用，建議搭配 excludeFeatured=true，否則廣告位仍會無視排序卡在最前面）/ salary 待遇由高到低。不給則用 104 預設的相關性排序"),
+            page: z
+                .number()
+                .int()
+                .min(1)
+                .optional()
+                .describe("第幾頁（每頁 20 筆），預設 1。想看更多職缺就往後翻頁"),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(CONFIG.maxLimit)
+                .default(5)
+                .describe(`本頁回傳筆數上限，最多 ${CONFIG.maxLimit}，預設 5`),
+        },
+    }, async (args) => {
+        try {
+            const result = await searchJobs(args);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `搜尋 104 職缺失敗：${message}。104 可能改版或被 Cloudflare 阻擋，稍後再試。`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=searchJobs.js.map

package/dist/tools/searchJobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchJobs.js","sourceRoot":"","sources":["../../src/tools/searchJobs.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,132 @@
+/**
+ * 職缺的「乾淨型別」—— 這是我們回給模型的格式。
+ *
+ * 刻意跟 104 的原始欄位脫鉤：104 改欄位名時，只改 normalizeJob，
+ * 這個型別和 tool 都不用動。
+ */
+import { extractSlug } from "./slug.js";
+export const NEGOTIABLE = "面議";
+/** 104 用這個值表示「上限不設」，要正規化成「以上」，不能直接印出來 */
+const NO_UPPER_LIMIT = 9_999_999;
+/** 104 薪資類型代碼（搜尋 API 的 s10）：10=面議、30=時薪、40=日薪、50=月薪、60=年薪 */
+const SALARY_TYPE_PREFIX = { 30: "時薪", 40: "日薪", 50: "月薪", 60: "年薪" };
+const SALARY_TYPE_NEGOTIABLE = 10;
+/** 把薪資數字轉成人看得懂的字串（type=10 或 0/0 代表面議；上限 9999999 代表不設上限） */
+function formatSalary(low, high, type) {
+    if (type === SALARY_TYPE_NEGOTIABLE || (!low && !high))
+        return NEGOTIABLE;
+    const prefix = SALARY_TYPE_PREFIX[type ?? 0] ?? "月薪"; // 沒給 s10 時退回月薪（歷史行為）
+    const fmt = (n) => n.toLocaleString("en-US");
+    const hasUpper = !!high && high < NO_UPPER_LIMIT; // 濾掉 9999999 這個哨兵值
+    if (low && hasUpper)
+        return `${prefix} ${fmt(low)}~${fmt(high)} 元`;
+    if (low)
+        return `${prefix} ${fmt(low)} 元以上`; // 含 low>0 且上限不設的情況
+    return `${prefix} ${fmt(high)} 元以下`;
+}
+/** 搜尋 API 的日期是 8 碼數字（20260817），轉成跟詳情 API 一致的 2026/08/17；非預期格式原樣放行 */
+function formatAppearDate(raw) {
+    if (!raw)
+        return "";
+    const m = raw.match(/^(\d{4})(\d{2})(\d{2})$/);
+    return m ? `${m[1]}/${m[2]}/${m[3]}` : raw;
+}
+/** 104 用 [[[關鍵字]]] 標記命中的字，清掉這些標記 */
+function stripHighlight(text) {
+    return text.replace(/\[\[\[|\]\]\]/g, "").trim();
+}
+/**
+ * 把一筆 104 原始職缺轉成乾淨的 Job（精簡列表用）。
+ * 刻意不含完整 JD —— 搜尋是概覽，完整內容用 get_job_detail 拿。
+ * 列表越精簡，模型整理成清單時越不會把某筆的網址對錯到別筆。
+ * ⚠️ 這是「防腐層」—— 104 改版時的唯一修改點。
+ */
+export function normalizeJob(raw) {
+    // jobId 用 slug（跟 link.job / get_job_detail / 公司職缺一致），不用數字 jobNo
+    const slug = extractSlug(raw.link?.job ?? "");
+    return {
+        jobId: slug || (raw.jobNo ?? ""),
+        jobName: stripHighlight(raw.jobName ?? ""),
+        companyName: raw.custName ?? "",
+        companyUrl: raw.link?.cust ?? "",
+        area: raw.jobAddrNoDesc ?? "",
+        salary: formatSalary(raw.salaryLow, raw.salaryHigh, raw.s10),
+        applyCount: raw.applyCnt ?? 0,
+        employeeCount: Number(raw.employeeCount) || 0,
+        skills: (raw.pcSkills ?? []).map((s) => s.description ?? "").filter(Boolean),
+        url: raw.link?.job ?? "",
+        appearDate: formatAppearDate(raw.appearDate),
+        // 只有 jobType=1 是會無視關鍵字硬塞的廣告；0(一般)和 2(優先位) 都是有效結果，一起分析
+        featured: raw.jobType === 1,
+    };
+}
+const descriptions = (items) => (items ?? []).map((i) => i.description ?? "").filter(Boolean);
+/** 把語言要求整理成 "英文 (聽:中等 說:中等)" 這種好讀字串 */
+function formatLanguages(langs) {
+    return (langs ?? []).map((l) => {
+        const a = l.ability;
+        const parts = a
+            ? [
+                a.listening && `聽:${a.listening}`,
+                a.speaking && `說:${a.speaking}`,
+                a.reading && `讀:${a.reading}`,
+                a.writing && `寫:${a.writing}`,
+            ]
+                .filter(Boolean)
+                .join(" ")
+            : "";
+        return parts ? `${l.language ?? ""} (${parts})` : (l.language ?? "");
+    });
+}
+/**
+ * 把 104 原始詳情轉成乾淨的 JobDetail。
+ * ref 帶入這筆職缺的 jobId(slug) 與 url —— 詳情 body 本身沒有，由呼叫端補上，
+ * 讓 jobId/url 跟 search_jobs / get_company_jobs 一致。
+ * ⚠️ 跟 normalizeJob 一樣是防腐層，104 改版時的修改點。
+ */
+export function normalizeJobDetail(raw, ref = { jobId: "", url: "" }) {
+    const jd = raw.jobDetail ?? {};
+    const cond = raw.condition ?? {};
+    const location = [jd.addressRegion, jd.addressDetail].filter(Boolean).join(" ");
+    return {
+        jobId: ref.jobId,
+        jobName: raw.header?.jobName ?? "",
+        companyName: raw.header?.custName ?? "",
+        companyUrl: raw.header?.custUrl ?? "",
+        url: ref.url,
+        appearDate: raw.header?.appearDate ?? "",
+        salary: jd.salary ?? "",
+        area: jd.addressRegion ?? "",
+        location,
+        description: (jd.jobDescription ?? "").trim(),
+        categories: descriptions(jd.jobCategory),
+        experience: cond.workExp ?? "",
+        education: cond.edu ?? "",
+        majors: cond.major ?? [],
+        otherConditions: (Array.isArray(cond.other) ? cond.other.filter(Boolean).join("\n") : (cond.other ?? "")).trim(),
+        // skills = 擅長工具/語言（跟 search 的 skills 一致），jobSkills = 職務技能（職類層級）
+        skills: descriptions(cond.specialty),
+        jobSkills: descriptions(cond.skill),
+        languages: formatLanguages(cond.language),
+        headcount: jd.needEmp ?? "",
+        manageResp: jd.manageResp ?? "",
+        businessTrip: jd.businessTrip ?? "",
+        industry: raw.industry ?? "",
+        employees: raw.employees ?? "",
+        welfareTags: raw.welfare?.tag ?? [],
+        welfare: (raw.welfare?.welfare ?? "").trim(),
+    };
+}
+/** 把公司 API 的原始職缺轉成乾淨的 CompanyJob（防腐層） */
+export function normalizeCompanyJob(raw) {
+    return {
+        jobId: raw.jobNo ?? "",
+        jobName: (raw.jobName ?? "").trim(),
+        area: raw.jobAddrNoDesc ?? "",
+        salary: raw.jobSalaryDesc ?? "",
+        education: raw.edu ?? "",
+        experience: raw.periodDesc ?? "",
+        url: raw.jobUrl ?? "",
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "mcp-server-104",
+  "version": "0.1.0",
+  "description": "Unofficial MCP server for 104.com.tw (Taiwan job board): search jobs, job details, company openings",
+  "type": "module",
+  "license": "MIT",
+  "author": "a7512cs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/a7512cs/104-mcp-server.git"
+  },
+  "homepage": "https://github.com/a7512cs/104-mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/a7512cs/104-mcp-server/issues"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "104",
+    "job-search",
+    "taiwan",
+    "claude"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "mcp-server-104": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js",
+    "test": "npm run build && node --test test/*.test.mjs",
+    "prepublishOnly": "npm test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "cycletls": "^2.0.5",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.0.0"
+  }
+}