# Job Hunt

> Find Korean job postings for a target role with minimal user input — pass a short `--seed` keyword like "Problem Solver" or "Forward Deployed Engineer" and the skill expands it to the full family of equivalent titles used at different companies (FDE / Applied AI Engineer / Generalist / Solutions Engineer / etc.), fetches matching postings from Korean job boards (사람인 / 잡코리아 / 원티드 / 프로그래머스), and pr…

- **Type:** Skill
- **Install:** `agentstack add skill-melons-melons-agents-job-hunt`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [MelonS](https://agentstack.voostack.com/s/melons)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [MelonS](https://github.com/MelonS)
- **Source:** https://github.com/MelonS/MelonS-Agents/tree/main/skills/job-hunt
- **Website:** https://melons.github.io/MelonS-Agents/

## Install

```sh
agentstack add skill-melons-melons-agents-job-hunt
```

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

## About

# job-hunt

Daily / on-demand digest of new job postings matched against an
operator-defined filter (직군 + 지역 + 키워드), with apply-assist
links per posting.

## Status (2026-05-20)

End-to-end pipeline **functional in mock-fallback mode**, with the
v2 short-keyword UX (`--seed "Problem Solver"` → automatic role
family expansion via `config/role-synonyms.yaml`) wired in.  Live
HTTP integration is gated on operator validation per source.

| Component | Status |
|---|---|
| Orchestrator (`scripts/run.sh`) | ✅ wired; filter + dedupe + diff + render + `--fit-score` integration |
| Markdown digest renderer (`scripts/digest.sh`) | ✅ working; fit-score line per posting |
| Apply-assist link derivation (`scripts/apply-assist.sh`) | ✅ working |
| `config/role-synonyms.yaml` | ✅ Phase 2.1 — 5 families, 50+ synonyms (problem-solver, ai-engineer-ml, agent-engineer, ai-product-manager, backend-engineer) |
| `config/operator-profile.example.md` | ✅ Phase 2.2 — generic template (operator copies → operator-profile.md, gitignored) |
| `sources/_mock.sh` | ✅ deterministic 11-posting fixture incl. Problem Solver family |
| **`sources/global-ats.sh`** | ⭐ **live-ready** — Greenhouse + Ashby + Lever public boards, no auth; 2026-05-21 e2e test pulled 5,019 raw / 171 Problem-Solver-matched postings; flip `JH_GLOBAL_ATS_LIVE=1` |
| **`sources/global-remoteok.sh`** | ⭐ **live-ready** — `remoteok.com/api`, no auth; 99 raw postings on test fetch; flip `JH_GLOBAL_REMOTEOK_LIVE=1` |
| **`sources/global-remotive.sh`** | ⭐ **live-ready** — `remotive.com/api/remote-jobs`, no auth; 19 raw postings; flip `JH_GLOBAL_REMOTIVE_LIVE=1` |
| **`sources/global-hn-whoshiring.sh`** | ⭐ **live-ready** — HN monthly "Who is hiring?" thread via hn.algolia.com; 334 postings on May 2026 thread; flip `JH_GLOBAL_HN_LIVE=1` |
| **`sources/kr-worknet.sh`** | ⭐ **live-ready** — 워크넷 (정부 공공고용서비스); SSR HTML parser, 10-20 postings/page; flip `JH_WORKNET_LIVE=1` |
| `sources/kr-wanted.sh` | ⚠️ mock-fallback default + 1 Problem Solver entry; live HTTP flip via `JH_WANTED_LIVE=1` + `WANTED_API_KEY` (operator-validated) |
| `sources/kr-saramin.sh` | ⚠️ mock-fallback default + 1 문제 해결사 entry; live OpenAPI flip via `JH_SARAMIN_LIVE=1` + `SARAMIN_KEY` (free signup at oapi.saramin.co.kr) |
| `sources/kr-jobkorea.sh` | ⛔ **permanent mock-only** — robots.txt forbids `/Search/?stext=` (only SSR path); 2017 잡코리아 vs 사람인 precedent applies. See `docs/research/job-sources-survey-2026-05-21.md`. |
| `sources/kr-programmers.sh` | ⛔ **deprecated stub** — Programmers 채용 service permanently closed 2025-05-19, domain NXDOMAIN |
| `scripts/fit-score.sh` | ⚠️ Phase 2.3 — scaffold mode default; per-posting Claude call gated on `JH_FIT_SCORE_LIVE=1` |
| `scripts/cover-letter-draft.sh` | ⚠️ Phase 2.5 — scaffold mode default; gated on `JH_COVER_LETTER_LIVE=1` |
| `scripts/company-research.sh` | ⚠️ Phase 2.5 — scaffold mode default; gated on `JH_COMPANY_RESEARCH_LIVE=1` |
| `scripts/interview-prep.sh` | ⚠️ Phase 2.5 — scaffold mode default; gated on `JH_INTERVIEW_PREP_LIVE=1` |
| `scripts/derive-profile.sh` | ⚠️ Phase 2.4 — scaffold mode default; reads repo and drafts `operator-profile.md`; gated on `JH_DERIVE_PROFILE_LIVE=1` |
| `tests/smoke.sh` + `edge-cases.sh` + `schema-validation.sh` | ✅ 68/68 PASS (32 + 26 + 10) |

The live HTTP path for each `kr-*` plugin is intentionally
disabled by default because:
1. Endpoint shapes need operator confirmation against the
   current API surface (these change without notice).
2. API keys (where required) are operator-supplied secrets.
3. Anti-bot patterns (for scraped sources) need supervised
   tuning, not unattended bursts.

Mock-fallback mode keeps the orchestrator + filter + dedupe +
digest path continuously testable.  Live integration is a
flip-the-flag operation once each plugin's curl/jq translation is
operator-validated.

### Activation dashboard

To see which flags are currently set, which are still off, and
which need an API key first:

```bash
bash skills/job-hunt/scripts/status.sh
```

The flag→script→required-env mapping is declared in
[`config/activation.tsv`](config/activation.tsv) (single source of
truth for the dashboard).  When a new gated script is added, append
a row there.

## What this produces

Given:

- A filter file (`config/filters.yaml`) listing 직군 (job category),
  지역 (region — typically Korean sido / sigungu level), and
  optional keyword include/exclude lists.
- A `locale:` key (currently only `kr` supported; future PRs can
  add other locales).
- One or more enabled `sources/.sh` plugins.

Produces:

- A dated digest at `records/jobs//digest.md` with:
  - One section per source (사람인, 원티드, etc.).
  - Per posting: title, company, region, posted-at timestamp,
    summary, and an **apply-assist link** that pre-fills the
    operator's filter context where the source supports it.
  - A "new since last run" delta when prior digests exist.
- A `records/jobs//raw/.json` cache of the raw
  fetch so subsequent runs can compute deltas without re-fetching.

## How to invoke

User-facing invocation: `/job-hunt` (zero-arg uses
`config/filters.yaml`).

Programmatic:

```bash
skills/job-hunt/scripts/run.sh                 # uses config/filters.yaml
skills/job-hunt/scripts/run.sh --filters=path  # explicit filter file
skills/job-hunt/scripts/run.sh --sources=kr-wanted,kr-programmers
```

## Filter schema (`config/filters.yaml`)

```yaml
locale: kr                         # required; only "kr" supported today
job_categories:                    # 직군 — typically a small list
  - 백엔드 개발자
  - AI 엔지니어
regions:                           # 지역 — sido or sido + sigungu
  - 서울
  - 경기 성남
  - 원격                           # remote-friendly opt-in
keywords:
  include: [Python, AI, agent]     # OR semantics within a posting
  exclude: [SI, 파견]              # exclude any posting matching
sources:                           # enabled source plugins
  - kr-saramin
  - kr-wanted
  - kr-programmers
output:
  records_root: ./records/jobs     # where digests land
  format: markdown                 # md | json (md is default)
```

`config/filters.example.yaml` ships as a documented starting
point; operator copies to `filters.yaml` and edits.

## Adding a locale

Each locale is a directory of source plugins matching the pattern
`sources/-.sh`.  Each plugin exposes a single
function `fetch_postings()` that prints normalized JSON on stdout:

```json
{
  "source": "kr-saramin",
  "fetched_at": "2026-05-20T00:30:00+09:00",
  "postings": [
    {
      "title": "백엔드 개발자",
      "company": "Example Co.",
      "region": "서울 강남구",
      "posted_at": "2026-05-19",
      "url": "https://...",
      "summary": "..."
    }
  ]
}
```

The orchestrator (`scripts/run.sh`) merges output from all enabled
sources, applies the keyword include/exclude filter, deduplicates
on `url`, computes the delta against the most recent prior
digest, and writes the markdown file.

Adding a new locale → drop a new `sources/-.sh`
that implements `fetch_postings()` and add the source name to the
operator's `filters.yaml` `sources:` list.  No orchestrator
change needed.  PRs welcome.

## Scope explicitly out (for now)

- **Resume tailoring** — separate skill if pursued.
- **Application submission automation** — anti-bot territory; the
  skill stops at apply-assist *links*, not auto-submission.
- **Interview prep** — separate skill.
- **Non-Korean locales** — design supports extension; ship is kr
  only until operator validates the kr path.

## Privacy / data handling

- Operator filter file (`config/filters.yaml`) is **gitignored
  by default** (see `.gitignore`).  Per [[repo-as-credibility-
  signal]] memory rule, specific 직군 / 지역 / exclusion lists
  reveal a job-seeker's personal target and don't belong in
  committed files.  Operators who *want* to commit a generic,
  non-personally-identifying filter (e.g. to share a domain
  starter-template) can `git add -f` it explicitly.
- `config/filters.example.yaml` is committed as the documented
  generic starting point — categories like "백엔드 개발자" /
  "AI 엔지니어" are deliberately broad and contain no operator
  specifics.
- Output digests under `records/jobs/` are gitignored (the repo's
  `records/` convention).  All raw fetched JSON + rendered
  markdown stays local.
- No source credentials are stored in this skill — each source
  plugin reads its key from `.env` (gitignored) if needed.

## Source & license

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

- **Author:** [MelonS](https://github.com/MelonS)
- **Source:** [MelonS/MelonS-Agents](https://github.com/MelonS/MelonS-Agents)
- **License:** MIT
- **Homepage:** https://melons.github.io/MelonS-Agents/

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:** yes
- **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-melons-melons-agents-job-hunt
- Seller: https://agentstack.voostack.com/s/melons
- 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%.