# 1. Clone 專案
git clone https://github.com/YuJunWang/104-job-hunter-mcp.git
cd 104-job-hunter-mcp

# 2. 安裝相依套件
npm install

# 3. 建置 TypeScript
npm run build

npx tsx src/login.ts

{
  "mcpServers": {
    "104-job-hunter": {
      "command": "node",
      "args": ["/絕對路徑/104-job-hunter-mcp/build/index.js"]
    }
  }
}

{
  "keyword": "TypeScript",
  "location": "台北市",
  "page": 1
}

{
  "keyword": "TypeScript",
  "page": 1,
  "total": 342,
  "results": [
    {
      "title": "前端工程師 (TypeScript / React)",
      "company": "某科技股份有限公司",
      "salary": "月薪 6～10 萬",
      "location": "台北市信義區",
      "description": "負責前端產品開發與維護...",
      "link": "https://www.104.com.tw/job/xxxxxx",
      "skills": ["TypeScript", "React", "Node.js"]
    }
  ]
}

{
  "job_url": "https://www.104.com.tw/job/xxxxxx"
}

{
  "title": "前端工程師 (TypeScript / React)",
  "company": "某科技股份有限公司",
  "description": "【工作內容】\n• 使用 React + TypeScript 開發 SPA 應用\n• 維護既有前端系統並進行效能優化...",
  "requirements": "【應徵條件】\n• 學歷：大學以上\n• 經歷：3年以上\n• 熟悉 TypeScript、React...",
  "benefits": "【福利制度】\n• 年薪14個月\n• 員工旅遊\n• 彈性上下班..."
}

{
  "job_url": "https://www.104.com.tw/job/xxxxxx",
  "cover_letter_text": "您好，我對貴公司的前端職位非常感興趣，我有 5 年的 TypeScript 開發經驗..."
}

{
  "status": "success",
  "message": "【Hit-in-the-loop】已成功點擊應徵按鈕並開啟投遞視窗。基於安全邊界，Agent 不會自動送出，請人類確認畫面後親自點擊最終送出按鈕！",
  "provided_cover_letter": "您好，我對貴公司的前端職位非常感興趣..."
}

{
  "status": "error",
  "error": "無法點擊我要應徵按鈕。請確認是否已經應徵過，或者網頁結構有變動。"
}

104-job-hunter-mcp/
├── src/
│   ├── index.ts          # MCP Server 主程式，註冊三個工具
│   ├── browser.ts        # Playwright 瀏覽器管理（單例模式）
│   ├── login.ts          # 首次登入輔助腳本
│   ├── test-client.ts    # 本地測試用客戶端
│   └── tools/
│       ├── search.ts     # job104_search 實作
│       ├── details.ts    # job104_get_details 實作
│       └── apply.ts      # job104_prepare_application 實作
├── build/                # TypeScript 編譯輸出（執行 npm run build 產生）
├── .chrome-profile/      # 登入後的 Chrome Profile（.gitignore 中）
├── package.json
└── tsconfig.json