worldjobplus-collect

name	worldjobplus-collect
description	Collect public overseas-job postings from WorldJobPlus (월드잡플러스), Korea HRD's 해외취업 portal, by keyword and country. Use when the user wants to gather, scan, or monitor overseas (해외취업) job listings for a role or country. Read-only — no login, save, or apply. Prints a normalized JSON array of postings.

WorldJobPlus Collect

Collect public overseas-employment postings from WorldJobPlus (월드잡플러스), the Korea HRD (한국산업인력공단) 해외취업 portal, and return normalized JSON (docs/SCHEMA.md). Self-contained: this skill's collect.py carries its own fetch + parse and depends only on curl_cffi, beautifulsoup4, lxml.

Boundaries

• Read-only. GET/POST of the public listing endpoint only (the POST just sets page size / page index — it is not a login or an application). Never log in, save a job, message, or apply.
• No fabrication. Fields the listing does not expose are null; titles, employers, countries, salaries, and deadlines are copied verbatim.
• A collected posting reflects the public page at run time; it is not proof the role is still open.

Run

If collect.py fails with ModuleNotFoundError, install the deps yourself (pip install curl_cffi beautifulsoup4 lxml) and retry — do not ask the user to install anything.

pip install curl_cffi beautifulsoup4 lxml   # or: pip install -r requirements.txt

python3 skills/worldjobplus-collect/collect.py --limit 20
python3 skills/worldjobplus-collect/collect.py --query "engineer" --location 일본

• --query, -q — filter the parsed rows by title/employer substring (client-side).
• --location, -l — filter by country substring, e.g. 일본, 베트남, 미국 (client-side; country is exposed per row).
• --limit, -n — max postings (default 20; the collector pages through the list 50-per-page until the limit is reached).
• --pretty — indent the JSON.

Output: a JSON array on stdout; a one-line count on stderr. Each row exposes title, employer (company), country (location), salary (연봉/시급 as shown), employment type (정규직/계약직/인턴 as shown), application deadline (MM/DD(요일)), and a snippet (job field / experience / education / visa).

Notes

• Source: SRC-JOB-WORLDJOBPLUS — https://www.worldjob.or.kr/ (collectible_open, re-verified 2026-07-07). The list endpoint /advnc/cnttNewList.do is server-rendered; posting ids look like E20260707013.
• Rows are div.post-box; external_id is the E… id from the row's goView1('E…') handler. The detail page is a JavaScript popup with no plain-GET URL, so url points at the public list endpoint and the stable id lives in external_id (no fabricated detail link).
• If the layout changes and 0 postings return, re-derive the div.post-box child selectors (h5.mb4 a, p.mb8 a, .nation-box img, .day-box, .post-condition-box p) against a live fetch (do not hardcode a specific role or posting id).