CLI

CLI 快速入門與指令

@wport/cli 讓 AI Agent 在終端機直接搜尋 WPORT 職缺並輸出結構化資料。設計目標是 token 友善、可 script、可接進自動化流程。

安裝

bash
npm install -g @wport/cli

檢查安裝與環境設定：

bash
wport doctor

搜尋職缺

最基本的用法：

bash
wport jobs search --keyword 前端

地區用 area code 篩選（可重複）；查特定職缺用 enc_id：

bash
wport jobs search --location 6001001000
wport jobs view <enc_id>

全域選項

選項說明
-k, --keyword <text>關鍵字搜尋（職稱／公司名等）
-l, --location <code>地區代碼（可重複，如 6001001000）
-c, --category <code>職類代碼（可重複）
-p, --page <n>頁碼（預設 1）
--json-query <file>進階：從 JSON 檔讀完整查詢條件
--fields <list>僅 JSON：只保留指定欄位（點路徑，逗號分隔）
--minimal僅 JSON：= --fields enc_id,title,company_name,area_display,salary_display
--output <table|json>輸出格式（TTY 預設 table，管線時 json）
--lang <locale>回應語系（zh-TW / en-US / vi-VN / th-TH / id-ID）

Token 友善輸出

--minimal 只保留關鍵欄位（僅 JSON、client-side 過濾），讓 Agent 少吃 token：

bash
wport jobs search --keyword 前端 --minimal --output json

結構化輸出（餵給 Agent）

--output json 搭配 --fields 產生結構化資料（分頁結果在 data[]），直接接給 Agent、jq 或你的腳本：

bash
wport jobs search --keyword 前端 --fields enc_id,title,salary_display --output json
json
{
  "data": [
    { "enc_id": "aX9…", "title": "前端工程師 (React)", "salary_display": "TWD 60–90k" }
  ],
  "totalCount": 47
}

例如用 jq 抽出所有職缺標題：

bash
wport jobs search --keyword 前端 --output json | jq -r '.data[].title'

下一步