job-searcher git:20260908.ff510eaA

Immutable. This exact content is served forever at /api/v1/blob/3fe764076ad99358.

---
name: job-searcher
description: '한국 채용 공고 검색 의도를 안내하고, 사용자가 제공한 잡코리아·링커리어·SK Careers·LG Careers 공개 공고 URL을 자격증명 없이 수집·정규화합니다. 채용, 취업, 공채, 이직, 구직, 인턴, 공고, 직무 찾기, 기업 정보 조회, 공고 URL 분석, 링크 보고 자소서 작성 같은 한국어 요청을 포함하며 자동 검색은 아직 TODO임을 구분합니다.'
---

# Job Searcher

한국 채용 공고를 자동으로 검색하는 job-source 연동은 아직 구현되어 있지 않습니다. 다만 사용자가 직접 제공한 공개 공고 URL은 정규화할 수 있습니다.

이 프로젝트는 API 키나 액세스 토큰 등 별도로 발급받아야 하는 인증 정보를 사용하지 않습니다. 사용자에게 인증키 발급이나 API 신청을 요구하지 않습니다.

지원 URL은 잡코리아, 링커리어, SK Careers, LG Careers 상세 페이지를 지원합니다. 검색·로그인·지원 제출은 하지 않습니다.

---

## 절대 금지

- 자동 지원, 사이트 로그인, CAPTCHA 우회
- 이메일 발송 또는 개인정보 전송
- 검색 결과를 임의로 생성하거나, 실제로 조회하지 않은 공고를 사실처럼 제시
- 구현되지 않은 기능을 "검색했다"라고 표현
- API 키·액세스 토큰·인증키 발급이나 API 사용 신청을 사용자에게 요구

---

## Inputs (입력)

사용자의 자연어에서 아래를 파악합니다.

- **채용 공고 검색 의도** — 예: `백엔드 공고 찾아줘`, `삼성 채용 알려줘`, `취준 중인데 어디 지원할까`
- **이미 확보한 자료** — 사용자가 직접 가진 채용 공고(JD) 본문 또는 채용 URL

---

## Workflow (절차)

### Step 1: 의도 구분

- 사용자가 공고를 찾아달라고 하면 자동 검색이 아직 TODO임을 안내합니다.
- 사용자가 지원할 공개 공고 URL을 제공하면 URL 수집 단계로 진행합니다.

### Step 2: 공개 URL 정규화

설치된 `fetch-jobs` workflow tool을 우선 사용합니다. 저장소에서 직접 작업하는 환경에서는 다음 명령을 사용합니다.

```bash
node tools/fetch-jobs.mjs --source url --url "<posting-url>"
```

실제 stdout/stderr를 그대로 확인합니다. 성공하면 생성된 `data/jobs/` JSON의 `raw.postingText`, `raw.positions`, `raw.questions`, `raw.attachments`, `raw.applyUrl`, `raw.extractionWarnings`를 읽습니다.

### Step 3: 다음 단계 연결

회사와 직무가 하나로 확인되면 `jd-analyzer`로 연결합니다. 여러 직무가 있거나 문항이 누락되면 그 정보만 질문하고, 다른 직무의 내용을 추정하지 않습니다.

### 저장된 공고 운영

통합 CLI의 `jobs import|list|refresh|rank`는 CSV, URL 목록, 사용자 제공
본문과 저장된 관심 공고를 다룹니다. CSV 열 매핑, 인코딩, 원본 행 번호를
보존하고 깨진 한글을 추측해 저장하지 않습니다. 신규·갱신·중복·확인
필요·실패 집계를 확인하고 실패 항목만 재처리합니다.

출처 ID 또는 정규화 URL이 같은 공고만 같은 항목으로 처리합니다. 다른
사이트의 유사 공고는 중복 후보로 보여주고 자동 병합하지 않습니다.
공고 자체와 선택한 지원 직무를 구분합니다. 최신 관측과 원문 출처,
변경 필드를 확인하고 문항·자격·직무 변경 시 연결 패키지를 재검토합니다.

재확인은 등록한 관심 공고에 한정합니다. 접속 실패는 확인 불가이며,
명시적 모집 종료와 다릅니다. 미지원·로그인·차단은 반복 시도하지 않고
본문 보완을 요청합니다. 외부 스케줄러는 같은 CLI를 호출하며 신규 공고
자동 발견이나 외부 알림을 수행하지 않습니다.

---

## Output (출력)

- 검색 요청에는 자동 검색 미지원(TODO) 사실을 명확히 전달합니다.
- URL 요청에는 저장된 정규화 파일과 추출 경고를 전달합니다.
- 없는 공고나 문항을 임의로 만들지 않습니다.

---

## Fallback (대안)

- **지원하지 않는 사이트**: JD 본문을 붙여 달라고 요청합니다.
- **첨부 PDF·이미지에만 상세 JD가 있는 경우**: 읽을 수 있는 파일이나 해당 직무 본문을 요청합니다.
- **페이지 접근 실패**: 실제 오류를 안내하고 내용을 추정하지 않습니다.
- **의도가 모호할 때**: 질문 하나만 합니다 (예: "지원하려는 공고 링크나 내용을 알려주실 수 있을까요?").