The job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.

AI Job Search – AI 기반 구직 지원 어시스턴트

정의 – Claude Code(Anthropic의 코드 어시스턴트 CLI)를 풀스택 구직 동반자로 바꾸는 자체 호스팅 워크플로우입니다. 개인 경력 프로필을 저장하고, 구인 게시판을 스크래핑하고, 적합성을 자동 평가하고, LaTeX 이력서와 자기소개서를 작성하고, 검토 에이전트가 비판하도록 하고, 마지막으로 보낼 준비가 된 PDF를 생성할 수 있습니다. 핵심 명령은 /setup, /scrape, /apply입니다. 보조 명령은 면접 준비, 결과 추적, Notion/Gmail 동기화, 기술 격차 분석, 맞춤 템플릿을 처리합니다.

주요 개념 및 작동 방식

프로필 생성 (/setup) – 기존 문서(CV PDF, LinkedIn 내보내기, 졸업장 등)를 가져오거나 인터뷰 형식의 질문에 답변합니다. 데이터는 documents/에 저장되며 .claude/skills/job-application-assistant/ 아래의 Claude 스킬 파일에서 사용됩니다.
구인 검색 (/scrape) – TypeScript/Bun으로 작성된 포털별 CLI 도구(Jobindex, Jobnet, Jobbank, LinkedIn, freehire.me 등) 세트를 실행합니다. 결과는 중복 제거되고 04-job-evaluation.md에 정의된 5차원 적합성 프레임워크에 대해 점수가 매겨집니다.
지원 (/apply <url>) –
- 게시물(또는 붙여넣은 설명)을 구문 분석합니다.
- 적합성을 점수화하고 진행 여부를 결정합니다.
- 내장 템플릿(cv/main_example.tex, cover_letters/cover.cls)을 사용하여 LaTeX로 이력서와 자기소개서를 작성합니다.
- 회사를 조사하고 피드백을 제공하는 검토자 Claude 에이전트를 생성합니다.
- 검토자가 만족할 때까지 반복한 다음 PDF를 컴파일합니다(이력서는 lualatex, 자기소개서는 xelatex).
- 선택적 ATS 검사(pypdf 또는 pdftotext)를 실행하여 PDF가 기계 판독 가능한지 확인합니다.
지원 후 도구 –
- /interview는 STAR 예제와 모의 면접이 포함된 준비 팩을 구성합니다.
- /outcome은 면접 결과를 기록하고 자료를 보관하며 정중한 후속 이메일을 작성할 수 있습니다.
- /rank는 새로 스크래핑된 구인을 일괄 점수화하고 후보 목록을 반환합니다.
- /expand는 공개 소스(GitHub, Kaggle 등)에서 프로필을 강화합니다.
- /upskill은 기술 격차 히트맵과 학습 계획을 생성합니다.
- /html-report는 job_search_tracker.csv에서 오프라인 대시보드를 만듭니다.
- /notion-sync 및 /gmail-sync는 Notion의 선택적 읽기 전용 보기와 Gmail의 자동 상태 감지를 제공합니다.

사전 요구 사항(README에 명시된 대로)

Claude Code CLI(유료 Anthropic 구독 또는 API 크레딧 필요).
Python 3.10+.
Bun(포털 검색 CLI용).
LaTeX 배포판(lualatex 및 xelatex 포함)(TeX Live, MacTeX, TinyTeX 또는 MiKTeX). 추가 패키지는 SETUP.md에 나열되어 있습니다.
선택 사항: pypdf(ATS 검사용) 및 PDF 텍스트 추출기(poppler-utils 또는 pdftotext).

빠른 시작 흐름(README에서)

# 1. 포크 및 클론(개인 데이터를 저장하는 경우 비공개 포크 유지)
gh repo fork MadsLorentzen/ai-job-search --clone
cd ai-job-search

# 2. 포털 CLI 설치(각 .agents/skills/*/cli/에서 bun install 실행)
python3 tools/install_portal_clis.py

# 3. Claude Code를 통해 프로필 초기화
claude   # Claude Code REPL 열기
/setup   # 마법사 따르기 – 문서 가져오기 또는 질문에 답변

# 4. 일치하는 구인 검색
/scrape

# 5. 선택한 게시물에 지원(URL 또는 붙여넣은 설명)
/apply https://jobindex.dk/job/1234567

README에는 시각적 안내를 위한 YouTube 연습 동영상 링크도 있습니다.

파일 레이아웃(높은 수준)

CLAUDE.md – 최상위 후보자 프로필 및 워크플로 규칙.
.claude/commands/ – 각 슬래시 명령에 대한 마크다운 정의.
.claude/skills/ – 핵심 "job-application-assistant" 스킬 및 지원 스킬(job-scraper, upskill).
.agents/skills/ – 개별 구인 포털 CLI 도구.
cv/, cover_letters/ – LaTeX 템플릿.
documents/ – 개인 이력서, LinkedIn 내보내기, 졸업장, 추천서, 과거 지원서를 보관하는 곳.
tools/ – CI, 스킬 린팅, PDF 검증, 급여 조회 등을 위한 헬퍼 스크립트.
job_search_tracker.csv – HTML 대시보드에 데이터를 제공하는 스프레드시트.
SETUP.md – 자세한 설치 및 구성 가이드.

누가 이것을 사용할까요?

대규모 언어 모델 어시스턴트를 사용하여 지원서를 자동화하고 재현 가능한 방식으로 맞춤화하려는 전문가.
로컬 Python/Bun/LaTeX 스택을 실행할 수 있고 이미 Claude Code 구독이 있는 구직자.
새 포털 스킬(/add-portal)을 추가하여 프레임워크를 다른 시장으로 확장하려는 개발자.

주의 사항 및 보안 참고 사항(README에 따름)

워크플로우는 구인 게시물을 샌드박스 처리하지 않습니다. 숨겨진 텍스트와 지시문 형태의 줄을 제거하지만 보내기 전에 가져온 콘텐츠를 검토해야 합니다.
/setup이 작성한 개인 데이터는 추적되는 파일에 저장됩니다. 데이터를 공개하고 싶지 않으면 저장소를 비공개로 유지하세요.
Claude Code는 유료 서비스입니다. 무료 티어는 없습니다.
이 프로젝트는 Anthropic과 제휴하지 않았습니다. 후원 주장은 사기입니다.

결론: AI Job Search는 Claude Code를 활용하여 원시 구인 목록을 정교하고 모델 검토된 지원 PDF로 변환하는 구체적이고 오픈소스인 자동화 파이프라인으로, 추적, 면접 준비, 기술 개발을 위한 풍부한 보조 도구를 갖추고 있습니다.

ai-job-search-dev/ai-job-search