saramin-collect

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   # or: pip install -r requirements.txt

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).