{ "openapi": "3.1.0", "info": { "title": "104.com.tw Job Search API", "description": "Search jobs and companies on Taiwan's largest job platform (104.com.tw). Use this to find job listings, company profiles, and career opportunities in Taiwan.", "version": "1.0.1" }, "servers": [ { "url": "https://104-mcp.vercel.app", "description": "Production" } ], "paths": { "/api/search-jobs": { "get": { "operationId": "searchJobs", "summary": "Search job listings on 104.com.tw", "parameters": [ { "name": "keyword", "in": "query", "description": "Search keyword in English or Chinese (e.g. 'software engineer', '軟體工程師')", "schema": { "type": "string" } }, { "name": "area", "in": "query", "description": "Location code. Common: 6001001000=台北市, 6001002000=新北市, 6001005000=台中市, 6001008000=高雄市", "schema": { "type": "string" } }, { "name": "ro", "in": "query", "description": "Job type: 0=full-time (default), 1=part-time", "schema": { "type": "integer", "enum": [0, 1] } }, { "name": "remoteWork", "in": "query", "description": "Remote work: 1=partial remote, 2=fully remote", "schema": { "type": "integer", "enum": [1, 2] } }, { "name": "edu", "in": "query", "description": "Education level: 1=高中以下, 2=高中, 3=專科, 4=大學, 5=碩士, 6=博士", "schema": { "type": "string" } }, { "name": "s9", "in": "query", "description": "Experience (comma-separated): 1=應屆畢業, 2=1年以下, 3=1-3年, 4=3-5年, 5=5-10年, 6=10年以上", "schema": { "type": "string" } }, { "name": "order", "in": "query", "description": "Sort order: 15=newest (default), 1=relevance", "schema": { "type": "integer" } }, { "name": "page", "in": "query", "description": "Page number (default 1)", "schema": { "type": "integer", "minimum": 1 } } ], "responses": { "200": { "description": "Job listings with pagination", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "jobNo": { "type": "string" }, "jobName": { "type": "string" }, "custName": { "type": "string" }, "salaryLow": { "type": "number" }, "salaryHigh": { "type": "number" }, "jobAddrNoDesc": { "type": "string" }, "appearDate": { "type": "string" }, "applyCnt": { "type": "number" }, "remoteWorkType": { "type": "number" }, "link": { "type": "object", "properties": { "job": { "type": "string" }, "cust": { "type": "string" } } } } } }, "metadata": { "type": "object", "properties": { "pagination": { "type": "object", "properties": { "total": { "type": "number" }, "currentPage": { "type": "number" }, "lastPage": { "type": "number" } } } } } } } } } } } } }, "/api/jobs/{code}": { "get": { "operationId": "getJobDetail", "summary": "Get full details for a job listing", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "Job short code from URL (e.g. '8tft1' from https://www.104.com.tw/job/8tft1)", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Full job details including description, requirements, salary, and contact info", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/search-companies": { "get": { "operationId": "searchCompanies", "summary": "Search companies on 104.com.tw", "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "Company name keyword (English or Chinese)", "schema": { "type": "string" } }, { "name": "page", "in": "query", "description": "Page number (default 1)", "schema": { "type": "integer", "minimum": 1 } }, { "name": "pageSize", "in": "query", "description": "Results per page (default 10, max 50)", "schema": { "type": "integer", "minimum": 1, "maximum": 50 } } ], "responses": { "200": { "description": "Company listings with pagination", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/companies/{code}": { "get": { "operationId": "getCompanyDetail", "summary": "Get full company profile from 104.com.tw", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "Company short code (e.g. '1a2x6bmutz' from https://www.104.com.tw/company/1a2x6bmutz)", "schema": { "type": "string" } }, { "name": "includeJobs", "in": "query", "description": "Include current job listings (true/false)", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Full company profile including industry, size, benefits, and contact info", "content": { "application/json": { "schema": { "type": "object" } } } } } } } } }