job-agent

Job Agent 발견부터 지원 추적까지 전체 구직 주기를 자동화하는 자율형 구직 지원 에이전트입니다. 주요 기능 다중 플랫폼 채용 공고 탐색 LinkedIn, Indeed, Glassdoor, ZipRecruiter, Dice, Wellfound를 지원하며 플랫폼별 속도 제한 및 세션 관리를 제공합니다. AI 기반 매칭 Google Gemini(무료), Groq(무료), Ollama(로컬), OpenRouter, Anthropic Claude 등 설정 가능한 AI 제공자를 사용하여 프로필과 각 일자리를 0.0~1.0 사이의 점수로 평가합니다. 이력서 및 자기소개서 맞춤화 지원서별로 ATS에 최적화된 이력서(PDF)와 사용자 정의 가능한 자기소개서를 자동 생성합니다. 전문적, 캐주얼, 격식 있는 어조를 지원합니다. 외부 ATS 처리 채용 게시판이 기업의 커리어 사이트로 리디렉션되는 경우, 에이전트가 Greenhouse, Lever, Workday, Ashby 및 일반 지원 포털의 양식을 감지하고 작성합니다. 또한 사전 심사 질문 및 이메일 지원 흐름도 처리합니다. 단계별 자율성 - 점수 ≥ 0.80: 자동 지원 - 점수 0.70–0.79: 수동 검토 대기열 - 점수 < 0.70: 건너뛰기 임계값은 대시보드나 YAML 프로필을 통해 설정할 수 있습니다. 웹 대시보드 Flask + HTMX + Bootstrap 5 기반의 인터페이스(http://127.0.0.1:5000)로 개요, 채용 정보, 검토 대기열, 지원 내역, 아웃리치, 분석, 설정 페이지를 제공합니다. 파일 수정 없이 UI에서 모든 것을 설정할 수 있습니다. 대화형 봇 휴대폰에서 일자리 승인/거부, 대기열 상태 확인, 통계 조회를 위한 텔레그램 봇(롱 폴링, 공개 URL 불필요)과 디스코드 봇(슬래시 명령어)을 지원합니다. 탐지 방지 브라우저 탐지 위험을 줄이기 위해 인간과 유사한 타이핑, 마우스 이동, 무작위 지연, 세션 로테이션 기능을 갖춘 Camoufox 스텔스 브라우저를 사용합니다. 알림 및 아웃리치 이메일(SMTP), Slack/Discord 웹훅, 텔레그램 알림. 채용 담당자에게 보낼 AI 생성 콜드 이메일 및 LinkedIn 촌촌 요청. 스케줄링 설정 가능한 활동 시간대(기본 오전 8시~오후 11시)를 지원하는 APScheduler. 일회성 실행, 일정에 따른 실행, 드라이런 모드를 지원합니다. 빠른 시작 git clone https://github.com/billmal071/job-agent.git cd job-agent uv sync uv run playwright install chromium uv run job-agent init-db uv run job-agent dashboard http://127.0.0.1:5000/settings에 방문하여 AI 제공자, 플랫폼 자격 증명, 임계값, 알림을 설정하세요. 프로필 생성 대시보드에 기존 이력서(PDF/DOCX)를 업로드하면 AI가 기술, 경력 수준, 목표 역할을 추출하여 검색 가능한 프로필을 자동 생성합니다. 다중 프로필 서로 다른 구직 활동(예: 풀스택 대 데브옵스)을 위해 각각 고유한 키워드, 위치, 급여 기대치, 이력서 템플릿을 갖춘 개별 프로필을 지원합니다. Docker 지원 docker compose up dashboard # 또는 docker compose run --rm agent 보안 - 플랫폼 자격 증명 Fernet 암호화 (~/.job-agent/fernet.key에 키 저장) - .env 파일의 API 키 (gitignored) - ~/.job-agent/agent.db에 데이터베이스 저장 (SQLite, 저장소 외부) - 브라우저 상태 별도 유지 라이선스 MIT