Configuración de Sweepy
¡Ya has instalado Sweepy! Ahora necesitas un perfil.
Un perfil de configuración indica a Sweepy los trabajos que debe buscar y el currículum con el que evaluarlos. Además, establece tu ubicación de destino.
Un perfil es un pequeño archivo de texto en formato YAML. YAML, que rima con «camel», organiza los datos mediante sangrías, dos puntos y saltos de línea. No hace falta escribir código: si sabes leer una lista de la compra, sabrás leer YAML.
Opción A: Ejecutar el asistente de configuración interactivo
El asistente de configuración crea un perfil operativo a partir de respuestas sencillas. Abre la pantalla de inicio de búsqueda antes del cuestionario y genera el archivo de configuración por ti.
Ejecuta este comando:
sweepy --setup
El asistente muestra su banner y, a continuación, la pantalla de inicio. La línea de estado situada debajo de los mosaicos muestra el perfil cargado, por ejemplo: Perfil actual: Alex Rivera / 4 títulos / Listo. Si aún no se ha cargado nada, se lee: Perfil actual: ninguno cargado / crea uno para empezar.
La pantalla de inicio muestra seis mosaicos. Launch Sweep ejecuta el perfil cargado. Load Profile abre una búsqueda guardada. Build Profile inicia una nueva búsqueda y formula preguntas en lenguaje sencillo. Configuración de Sweep controla la clasificación, las fichas y el historial. Caja de herramientas de Sweepy incluye la edición de perfiles, la gestión del motor, la gestión del agregador, el botón de depuración, la ayuda, los registros recientes, la conversión de documentos y las actualizaciones. Salir de Sweepy guarda los cambios y cierra el asistente.
La referencia de comandos enumera los parámetros asociados a cada entrada.
A continuación se muestra la salida de la terminal de la primera sesión del asistente de Alex, en la que se selecciona la ruta Perfil de compilación:
╭────────────────────────────────────────────────────────────────────────────╮
│ SWEEPY / SEARCH LAUNCHPAD │
├────────────────────────────────────────────────────────────────────────────┤
│ ╭────────────────────────────────╮ ╭────────────────────────────────╮ │
│ │ 01 LAUNCH SWEEP │ │ 04 BUILD PROFILE │ │
│ │ Run your job search now │ │ Set up your job search │ │
│ ╰────────────────────────────────╯ ╰────────────────────────────────╯ │
│ ╭────────────────────────────────╮ ╭────────────────────────────────╮ │
│ │ 02 LOAD PROFILE │ │ 05 SWEEP SETTINGS │ │
│ │ Open a search you saved │ │ Ranking, cards, tracking │ │
│ ╰────────────────────────────────╯ ╰────────────────────────────────╯ │
│ ╭────────────────────────────────╮ ╭────────────────────────────────╮ │
│ │ 03 SWEEPY'S TOOLBOX │ │ 06 EXIT SWEEPY │ │
│ │ Edit profile, logs, help │ │ Save changes and close │ │
│ ╰────────────────────────────────╯ ╰────────────────────────────────╯ │
├────────────────────────────────────────────────────────────────────────────┤
│ Current profile: none loaded / build one to start │
│ ↑ ↓ ← → navigate Enter select Esc exit │
╰────────────────────────────────────────────────────────────────────────────╯
Selected: 04 BUILD PROFILE
What is your name? Alex Rivera
What job titles are you looking for?
(Separate multiple titles with a comma)
> Paralegal, Legal Assistant, Litigation Support Specialist, Legal Secretary
Where do you want to work? (City, State): New York, NY
Do you want to see remote-only roles? (yes/no): no
Do you want to include hybrid roles? (yes/no): yes
What is the path to your resume PDF?
Hint: In File Explorer, select the file and press Ctrl+Shift+C (Windows 11); on older Windows, Shift+right-click and pick Copy as path.
> Alex_Rivera_Resume.pdf
What is your minimum target salary? (Leave blank to skip): 65000
Which platforms do you want to search?
[x] Greenhouse
[x] Ashby
[x] Lever
[x] Workable
[ ] Aggregator feeds (Remotive, Adzuna)
Do you want to add custom platforms or ATS domains? (yes/no): yes
Enter custom platform names and domains (format: Name:domain.com, comma-separated):
e.g. SmartRecruiters:smartrecruiters.com, Breezy HR:breezy.hr
> SmartRecruiters:smartrecruiters.com, Breezy HR:breezy.hr
Enter must-have skills or keywords to prioritize (comma-separated, leave blank to extract from resume): Westlaw, LexisNexis, e-discovery, Contract Review, Legal Research
What export formats do you want?
[x] PDF Report
[x] CSV Spreadsheet
[ ] JSON Data
Add job-tracking columns to the CSV? (date applied, status, interview stage, offer, follow-up date, contact, notes): (yes/no): yes
Do you want to configure multiple resume tracks (e.g. Tech Writer vs UX Writer)? (yes/no): no
Enable debug logging? (Logs are saved under logs/ in the application directory): (yes/no): no
What would you like to do?
1. Submit profile
2. Edit an answer
3. Toggle job tracking columns
4. Manage job engines
5. Adjust engine performance
6. Download job engines
7. Convert a document to PDF (bonus)
8. Show help
9. Show recent logs
10. Start over
Vuelve a ejecutar sweepy --setup en cualquier momento para crear un nuevo perfil o editar uno ya existente. El asistente escribe en el archivo que indica y no modifica tus otros perfiles.
Para omitir el Launchpad y editar directamente un perfil guardado, utiliza el parámetro --profile:
sweepy --setup --profile profiles/paralegal_nyc.yaml
Opción B: Editar el archivo de configuración manualmente
Para introducir la configuración directamente, copia la plantilla de ejemplo y ábrela en un editor de texto sin formato, como el Bloc de notas o VS Code. Evita los procesadores de texto, ya que sustituyen las comillas rectas por comillas curvas y hacen que el YAML deje de funcionar.
- Windows
- macOS / Linux
copy config.sample.yaml profiles\alex_rivera_paralegal.yaml
notepad profiles\alex_rivera_paralegal.yaml
cp config.sample.yaml profiles/alex_rivera_paralegal.yaml
open profiles/alex_rivera_paralegal.yaml # macOS
# or: nano profiles/alex_rivera_paralegal.yaml # Linux
Perfil de Alex
El asistente guarda este archivo en profiles/alex_rivera_paralegal.yaml. Las líneas que empiezan por # son comentarios: explican cada configuración, y Sweepy las ignora. Sweepy rellena con un valor por defecto cualquier sección o configuración que omitas.
# ─────────────────────────────────────────────────
# Sweepy — Alex's Paralegal Profile
# ─────────────────────────────────────────────────
# Your name (appears in the PDF report header)
name: "Alex Rivera"
# ─── Job Search Settings ──────────────────────────
search:
# List every job title you want to find.
# The engine searches for ALL of these titles simultaneously.
titles:
- "Paralegal"
- "Legal Assistant"
- "Litigation Support Specialist"
- "Legal Secretary"
# Your target city and state.
location: "New York, NY"
# Set to true to ONLY see remote roles.
# Set to false to see remote, hybrid, and on-site roles.
remote_only: false
# Set to false to exclude hybrid positions.
include_hybrid: true
# Minimum annual salary filter (optional).
# Leave as 0 or remove this line to skip salary filtering.
min_salary: 65000
# ─── Resume Settings ─────────────────────────────
resume:
# The full path to your resume PDF on your computer.
# On Windows, use double backslashes (\\) or forward slashes (/).
path: "Alex_Rivera_Resume.pdf"
# Must-have skills to prioritize for the match percentage.
must_have_skills:
- "Westlaw"
- "LexisNexis"
- "e-discovery"
- "Contract Review"
- "Legal Research"
# How heavily to weigh keyword matches when scoring roles.
# 1.0 = standard weight. Increase to 2.0 if you want
# exact skill matches to dominate the score.
keywords_weight: 1.5
# ─── Platform Settings ────────────────────────────
# Set each platform to true or false to enable or disable it.
platforms:
greenhouse: true
ashby: true
lever: true
workable: true
aggregators: false # Free feeds like Remotive, Adzuna
# Optional: custom ATS endpoints or company career domains
custom:
- name: "SmartRecruiters"
domain: "smartrecruiters.com"
enabled: true
- name: "Breezy HR"
domain: "breezy.hr"
enabled: true
# ─── Export Settings ──────────────────────────────
export:
# Comma-separated list of output formats.
# Options: pdf, csv, json
format: "pdf,csv"
# Where to save the output files.
# The engine creates this folder if it does not exist.
output_dir: "results"
En Windows: utiliza dos barras invertidas (\\) o barras (/) en las rutas YAML. Una sola barra invertida (\) altera el formato YAML.
✅ Correcto: "C:\\Users\\Alex\\Documents\\resume.pdf" o "C:/Users/Alex/Documents/resume.pdf"
❌ Incorrecto: "C:\Users\Alex\Documents\resume.pdf"
Uso de perfiles predefinidos
Sweepy incluye perfiles predefinidos listos para usar en la carpeta profiles/. Estos cuatro abarcan las búsquedas más habituales:
| Archivo | Carrera profesional | Títulos buscados |
|---|---|---|
| paralegal_nyc.yaml | Aviso legal | Asistente jurídico, auxiliar jurídico, especialista en apoyo en litigios, secretario jurídico |
frontend_developer.yaml | Ingeniería de software | Desarrollador front-end, desarrollador de React, ingeniero de interfaz de usuario |
tech_writer.yaml | Redacción técnica | Redactor técnico, redactor de UX, diseñador de contenidos |
template_custom.yaml | Cualquier carrera profesional | Ejemplos de títulos que puedes cambiar. Cada configuración incluye un comentario. |
Para utilizar un preajuste, introduce su nombre de archivo al ejecutar un barrido:
sweepy --profile profiles/frontend_developer.yaml
Puedes crear tantos perfiles como quieras. Guarda uno diferente para cada variante de puesto de trabajo o ciudad a la que te dirijas. Cambia de uno a otro al instante utilizando el indicador --profile.
Opción C: Automatizar con un asistente de chat
Un asistente de chat puede crear perfiles y ejecutar barridos por ti. Sweepy incluye un servidor integrado de Model Context Protocol (MCP), por lo que el asistente lee y escribe tus perfiles directamente. La guía de integración de MCP explica la configuración del cliente para Antigravity, Claude Desktop y VS Code, y la referencia de herramientas MCP enumera todas las herramientas de Sweepy.
Consulta todos los ajustes
La referencia de configuración enumera todos los parámetros que admite un perfil, desde debug y resume.tracks hasta sources.* y report.*. Manténla abierta mientras editas tu perfil.
Comprueba dónde busca trabajo Sweepy
Sweepy consulta, de forma predeterminada, cuatro sistemas públicos de gestión de candidatos. Este grupo incluye Greenhouse, Ashby, Lever y Workable. También consulta Built In NYC, una bolsa de empleo de Nueva York. Los feeds de los agregadores de LinkedIn, Indeed, Glassdoor y ZipRecruiter se procesan a través de python-jobspy cuando tu perfil lo permite.
Los motores opcionales añaden bolsas de empleo. Las opciones son HireHunt, OpenRoles, JobDrop y Apify. OpenRoles requiere una lista de empresas antes de ejecutarse. Apify requiere un APIFY_TOKEN. JobDrop entra en conflicto con la fijación de dependencias de JobSpy. La opción Descargar motores de empleo del asistente de configuración los instala.
La página Fuentes y plataformas trata sobre los motores opcionales, los archivos de inicialización, las entradas de plataformas personalizadas y las advertencias sobre compatibilidad.
Tu perfil ya está listo. Es hora de ejecutar tu primer barrido.