CLI

CLI Quickstart & Commands

@wport/cli lets AI agents search WPORT jobs and emit structured data straight from the terminal. It's designed to be token-friendly, scriptable, and automation-ready.

Install

bash
npm install -g @wport/cli

Check install and environment:

bash
wport doctor

Search jobs

The most basic usage:

bash
wport jobs search --keyword 前端

Filter by area code (repeatable); view a specific job by enc_id:

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

Global options

OptionDescription
-k, --keyword <text>Keyword search (title / company etc.)
-l, --location <code>Area code (repeatable, e.g. 6001001000)
-c, --category <code>Job classification code (repeatable)
-p, --page <n>Page number (default 1)
--json-query <file>Advanced: full query body from a JSON file
--fields <list>JSON only: keep only these dotted-path fields
--minimalJSON only: shorthand for the key fields
--output <table|json>Output format (table in TTY, json when piped)
--lang <locale>Response locale (zh-TW / en-US / vi-VN / th-TH / id-ID)

Token-friendly output

--minimal keeps only the key fields (JSON only, filtered client-side) so agents spend fewer tokens:

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

Structured output (feed an agent)

--output json with --fields produces structured data (paginated results under data[]) to pipe straight to an agent, jq, or your own script:

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
}

For example, extract every job title with jq:

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

Next