网申求职半自动AI打字助手

LLM 기반 취업 지원 도구로, EXE 데스크톱 클라이언트(내장 브라우저 + 스마트 양식 작성)와 CLI 전체 자동 모드 두 가지 사용 방식을 제공합니다: 이력서 파싱 → 회사 추천 → 공식 채용 페이지로 바로 이동 → 내장 브라우저 원클릭 양식 작성 / 전체 자동 제출.

다운로드 및 설치

Releases에서 auto-apply-Setup-x.x.x.exe(즉, "网申半自动AI助手" 설치 마법사)를 다운로드하여, 더블클릭하여 일반 설치 마법사에 따라 설치를 완료합니다(환영 → 디렉터리 선택 → 설치 → 완료):

• 기본적으로 사용자 디렉터리(%LocalAppData%\Programs)에 설치되며, 관리자 권한이 필요하지 않습니다

• 시작 메뉴와 바탕화면 바로 가기가 자동 생성되며 완전한 제거를 지원합니다

• Windows 10/11 64비트 지원

Related MCP server: Shortlist MCP Server

인터페이스 미리보기

첫 실행 — 작업 모드 선택(MCP 모드 = 외부 AI 제어, API Key 불필요; API 모드 = 소프트웨어 내장 AI; 이 후 언제든지 "설정"에서 변경 가능):

6가지 기능 페이지:

데스크톱 클라이언트(권장)

PySide6 + QtWebEngine으로 구축된 데스크톱 응용프로그램, 6개 기능 페이지:

실행

pip install -r requirements.txt
python main_gui.py

EXE / 설치 패키지 빌드

# 方式一：绿色版（onedir，拷贝整个文件夹分发）
pyinstaller autoapply.spec --noconfirm
# 产物: dist/网申求职半自动AI助手/网申求职半自动AI助手.exe

# 方式二：安装向导安装包（推荐分发方式）
powershell -ExecutionPolicy Bypass -File build_installer.ps1
# 产物: installer/网申求职半自动AI助手-Setup-x.x.x.exe（Inno Setup 常规安装向导）
# 需安装 Inno Setup 6 + Languages/ChineseSimplified.isl 中文语言包

EXE 첫 실행 모드 선택 및 모드(MCP / API) 다이얼로그가 나오며, 동일 디렉토리 config.yaml (config.example.yaml 복사) 그리고 데이터는 data/에 저장됩니다.

MCP 방식(외부 AI 제어)

응용 프로그램은 MCP server 이기도 하고, Codex / Claude등 AI 클라이언트가 제어할 수 있습니다(API Key 불필요):

网申求职半自动AI助手.exe --mcp    # stdio JSON-RPC，协议为 Model Context Protocol

8가지 도구 제공: get_profile / set_profile(이력서 프로필 읽기/쓰기), recommend_companies(규칙 추천, 설정 Key 후 AI 우선), search_companies, record_application / list_applications(지원 기록), open_url / smart_fill(GUI 실행하는 동안 내장 브라우저 실시간으로 열고 스마트 채우기). 연결 명령어 및 Codex / Claude 설정은 프로그램 "설정 → MCP 서비스" 페이지에서 확인 및 원클릭 복사할 수 있습니다.

스마트 채우기 설명

• 어떤 ATS 신청서 페이지(Greenhouse/Lever/Workday/일반 폼)에서 "⚡ 스마트 채우기" 클릭

• 감정 엔진: 이름/이메일/전화/거주지/링크/EEO 개인정보 옵션/고용 가능/급여 등 표준 필드 직접 매핑

• AI 엔진(API Key 설정 시): 사용자 정의 질문을 기반으로 그 LLM이 이력서 기반 생성

• 파일 업로드, 실제 브라우저의 업로드 시 첨부된 미리 제공된 이력 파일 자동 첨부

• 채운 필드는 초록 테두리로 하이라이트되며, 확인 후 수동 제출; "지원 기록" 버튼으로 해당 지원을 기록에 저장

CLI 모드(완전 자동)

resume.pdf ──build-profile──> profile.json
                                  │
greenhouse/lever/workday API ──> 职位列表 ──> LLM 打分排序 ──> 逐个投递
                                                                  │
                                        Playwright + LLM 表单填充引擎（含验证码人工介入、截图留档）
                                                                  │
                                              SQLite 投递记录 / 答案缓存 / 求职信缓存

playwright install chromium
copy config.example.yaml config.yaml   # 填入目标公司 board token 等
$env:OPENAI_API_KEY="sk-..."           # 或 DeepSeek/通义等任意 OpenAI 兼容 key

python main.py build-profile --resume data/resume/resume.pdf
python main.py scan                    # 只看匹配结果，不投递
python main.py run --dry-run           # 填表+截图但不提交，先检查效果
python main.py run                     # review 模式：每份确认后提交
python main.py run --auto --max 5      # 全自动，本轮最多 5 份
python main.py status                  # 查看投递记录

테스트

python test_form_fill_js.py   # 表单填充引擎（JS注入，GUI核心）
python test_pipeline.py       # CLI 管道（职位抓取+Playwright填表）

설정 구성(config.yaml)

새 ATS 어댑터 확장

apply/adapters.py 파일의 ADAPTERS에 클래스를 등록하고, apply(page, orch, job)를 구현하세요: job.apply_URL의 내용 → run_application(page, orch, job, submit_selectors, success_patterns, next_selectors) 호출하여 기성 데이터 채움 엔진을 재사용 가능합니다. 알려지지 않은 사이트는 자동으로 GenericApply로 처리됩니다.

동작 및 준수 설명

• 캡차: 우회하지 않음. 화면 표시 유지 모드에 대기하며 수동 해결; 무해(화면 없는) 모드는 건너뛰고 기록만 남게 됩니다.

• 속도 제한: 지원 사이마다 delay_minute/max_seconds 만큼 무작위 대기, 일일 상위 한도 있음.

• 건식 실행: 실제 실행 전 --dry-run을 사용해서 채우기 품질 확인, 모든 주요 단계의 스크린샷은 outputs/screenshots/에 저장됩니다.

• 자동 제출은 일부 웹사이트의 이용약관을 위반할 수 있습니다. 실제 본인 취업 목적으로만 사용하고, 응용자 세이 유지하며 대상 사이트 규칙을 준수하세요.

• EEO/인구통계 관련 질문은 기본 값으로 가장 개인 정보가 보호되는 답변을 선택하거나 건너뜁니다.