网申求职半自动AI助手

Herramienta de postulación a empleos impulsada por LLM, con dos modos de uso: cliente de escritorio EXE (navegador integrado + autocompletado inteligente) y modo CLI totalmente automático: analizar el currículo -> recomendar empresas -> acceso directo al canal de postulación en el sitio web oficial -> autocompletado con un clic en el navegador integrado / envío totalmente automático.

Descarga e instalación

Desde Releases descarga auto-apply-Setup-x.x.x.exe (es decir, el asistente de instalación de «网申求职半自动AI助手»), haz doble clic y completa la instalación con el asistente habitual (Bienvenida → Seleccionar carpeta → Instalar → Finalizar):

• Se instala por defecto en el directorio del usuario (%LocalAppData%\Programs), sin necesidad de permisos de administrador

• Crea automáticamente accesos directos en el menú Inicio y en el escritorio; admite desinstalación completa

• Compatible con Windows 10/11 de 64 bits

Related MCP server: Shortlist MCP Server

Vista previa de la interfaz

Primer inicio — elige el modo de trabajo (modo MCP = control de IA externa, sin necesidad de API Key; modo API = IA integrada en el software; luego siempre puedes cambiarlo en «Configuración»):

Seis páginas funcionales:

Cliente de escritorio (recomendado)

Aplicación de escritorio construida con PySide6 + QtWebEngine, con seis páginas:

Ejecución

pip install -r requirements.txt
python main_gui.py

Empaquetado del EXE / paquete de instalación

# 方式一：绿色版（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 中文语言包

En la primera ejecución del EXE se mostrará el diálogo de selección de modo (MCP / API) y se generará config.yaml (copiado desde config.example.yaml) en el mismo directorio; los datos se guardarán en data/.

Modo MCP (control de IA externa)

El software actúa también como servidor MCP, que puede ser controlado por clientes de IA como Codex / Claude (sin necesidad de API Key):

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

Proporciona 8 herramientas: get_profile / set_profile (lectura/escritura de la ficha de currículo), recommend_companies (recomendación por reglas; con la API Key configurada se usa primero la IA), search_companies, record_application / list_applications (registro de postulaciones), open_url / smart_fill (si la GUI está en ejecución, se coordina con el navegador integrado para abrir páginas y rellenarlas inteligentemente en tiempo real). El comando de conexión y la configuración para Codex / Claude aparecen en la página de «Configuración → Servicios MCP», con copia a un solo clic.

Notas sobre el autocompletado automático

• En cualquier página de formulario de solicitud ATS (Greenhouse/Lever/Workday/formularios genéricos), haz clic en «⚡ Relleno inteligente»

• Motor de reglas: nombre/correo/teléfono/ubicación/enlaces/opciones de la EEO/privacidad/permiso de trabajo/salario y otros campos estándar se asignan directamente automáticamente

• Motor de IA (después de configurar la API Key): pregunta de respuesta personalizada se genera con el LLM a partir de la hoja de vida

• Subida de archivos: al hacer clic en el botón de subir en la página, se añade automáticamente el archivo de currículo predefinido

• Los campos rellenados se destacan con un borde verde; después de una revisión manual, el envío se hace manualmente; el botón «Registrar postulación» guarda la solicitud en el registro de postulaciones

Modo CLI (totalmente automático)

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                  # 查看投递记录

Pruebas

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

Puntos clave de configuración (config.yaml)

Ampliar con nuevos adaptadores ATS

En apply/adapters.py, en los ADAPTERS registran una clase e implementa apply(page, orch, job): después de navegar a job.apply_url, llama a run_application(page, orch, job, submit_selectors, success_patterns, next_selectors) para reutilizar el motor de formularios genérico. Los sitios desconocidos pasan automáticamente a GenericApply.

Comportamiento y cumplimiento

• CAPTCHA: no se intenta eludir. En modo con interfaz gráfica se detiene y espera a que lo resuelvas manualmente; en modo sin interfaz se omite y se deja constancia.

• Límite de velocidad: entre un postulación y la siguiente se espera un tiempo aleatorio en delay_min/max_seconds, además de un límite diario.

• dry-run: antes del uso real, ejecuta primero --dry-run para comprobar la calidad del llenado del formulario; las capturas de pantalla de los pasos clave se guardan en outputs/screenshots/.

• La automatización del envío relativas puede violar las condiciones de uso de algunos sitios web. Úsela solo para postulaciones de trabajo reales, con fines personales, controlando la frecuencia y respetando las reglas de los sitios de destino.

• Las preguntas de EEO / datos demográficos se rellenan por defecto con la opción más respetuosa con la privacidad o se omiten.