| name | saramin-collect |
| description | Collect recent public job postings from Saramin (사람인) by keyword. Use when the user wants to gather, scan, or monitor Saramin listings for a role, stack, or company. Read-only — no login, save, or apply. Prints a normalized JSON array of postings. |
Saramin Collect
Collect recent public postings from Saramin's keyword search 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 of the public search page only. Never log in, save a job,
message, or apply. Do not submit any form.
- No fabrication. Fields the source does not expose are
null; titles,
companies, locations, 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
python3 skills/saramin-collect/collect.py --query "데이터 엔지니어" --limit 20
--query, -q — search keyword (default 개발자).
--limit, -n — max postings (default 20).
--pretty — indent the JSON.
Output: a JSON array on stdout (source, external_id, url, title, company, location, employment_type, posted_at, deadline, salary, snippet, collected_at); a one-line count on stderr. Saramin exposes location,
employment type, deadline, and sector tags cleanly.
Notes
- Source:
SRC-JOB-SARAMIN — https://www.saramin.co.kr/ (collectible_open,
re-verified 2026-07-07; the root auto-redirects same-host to /zf_user/).
- Cards are
div.item_recruit; external_id is the rec_idx. Canonical
posting URL: /zf_user/jobs/relay/view?rec_idx=<id>.
- If the layout changes and 0 postings return, re-derive the
.item_recruit
child selectors against a live fetch (do not hardcode a specific company).