# Kowork Collect

> Collect recent public job postings from KOWORK (kowork.kr), an English jobs-for-foreigners board in Korea. Use when the user wants to gather, scan, or monitor KOWORK listings — foreigner-eligible roles with visa-sponsorship tags. Read-only — no login, save, or apply. Prints a normalized JSON array of postings.

- **Type:** Skill
- **Install:** `agentstack add skill-itssosunny-job-searcher-kowork-collect`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [itssosunny](https://agentstack.voostack.com/s/itssosunny)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [itssosunny](https://github.com/itssosunny)
- **Source:** https://github.com/itssosunny/job-searcher/tree/main/skills/kowork-collect

## Install

```sh
agentstack add skill-itssosunny-job-searcher-kowork-collect
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# KOWORK Collect

Collect recent public postings from KOWORK's English jobs-for-foreigners listing
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 `/en` listing only. Never log in, save a job,
  message, or apply. Do not submit any form.
- **No fabrication.** Fields the feed does not expose are `null`; titles,
  companies, locations, and visa/type tags 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.

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

python3 skills/kowork-collect/collect.py --query "developer" --limit 20
python3 skills/kowork-collect/collect.py --limit 20      # whole first page
```

- `--query, -q` — filter the listing by title/company substring (**client-side**;
  see Notes). Omit to return the whole first page.
- `--limit, -n` — max postings (default 20).
- `--pretty` — indent the JSON.

Output: a JSON array on stdout; a one-line count on stderr. KOWORK exposes
company (from the logo `alt`), location, employment type, and metadata pills
(visa eligibility like `E-7 Sponsors`, job category) — the full pill set is kept
in `snippet`, with a deadline `D-` in `deadline` when shown.

## Notes

- Source: `SRC-JOB-KOWORK` — https://kowork.kr/en (collectible_open, re-verified
  2026-07-07). This is a board for foreigners in Korea, so postings carry visa
  tags (E-7, F-series, etc.).
- **First page only, best-effort.** KOWORK is a server-rendered Next.js app; the
  static HTML holds ~15 postings (the first page). More requires a real browser
  (infinite scroll), which is out of scope for a plain-fetch collector.
- **Keyword filtering is client-side.** The `?search=` param is ignored
  server-side, so `--query` filters the fetched page by title/company substring.
- Each card is an `a[href*='/en/post/']`; `external_id` is that numeric id.
  Canonical detail URL: `/en/post/`. Company comes from the logo image `alt`
  (`job-list--logo`); the metadata pills are duplicated across
  desktop/mobile blocks and are deduped on text.
- If the Tailwind markup changes and 0 postings return, re-derive the card
  anchor, `p.line-clamp-2` title, and pill selectors against a live fetch (do
  not hardcode a specific company).

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [itssosunny](https://github.com/itssosunny)
- **Source:** [itssosunny/job-searcher](https://github.com/itssosunny/job-searcher)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-itssosunny-job-searcher-kowork-collect
- Seller: https://agentstack.voostack.com/s/itssosunny
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.