Configurer Sweepy
Vous avez installé Sweepy ! Il vous faut maintenant un profil.
Un profil de configuration indique à Sweepy les emplois à trouver et le CV auquel les comparer. Il définit aussi votre lieu cible.
Un profil est un petit fichier texte au format YAML. YAML, qui rime avec camel, organise les données avec l’indentation, les deux-points et les retours à la ligne. Vous n’avez pas besoin d’écrire du code : si vous savez lire une liste de courses, vous savez lire du YAML.
Option A : lancer l’assistant de configuration interactif
L’assistant de configuration crée un profil fonctionnel à partir de réponses simples. Il ouvre le lanceur de recherche avant le questionnaire et écrit le fichier de configuration à votre place.
Lancez cette commande :
sweepy --setup
L’assistant affiche sa bannière, puis le lanceur. La ligne d’état sous les tuiles indique le profil chargé, par exemple Current profile: Alex Rivera / 4 titles / Ready. Quand aucun profil n’est chargé, elle affiche Current profile: none loaded / build one to start.
Le lanceur présente six tuiles. Launch Sweep lance le profil chargé. Load Profile ouvre une recherche enregistrée. Build Profile démarre une nouvelle recherche et pose des questions en langage simple. Sweep Settings contrôle le classement, les fiches et l’historique. Sweepy's Toolbox regroupe la modification de profil, la gestion du moteur, la gestion des agrégateurs, l’option de débogage, l’aide, les journaux récents, la conversion de documents et les mises à jour. Exit Sweepy enregistre vos modifications et ferme l’assistant.
La référence des commandes liste les options derrière chaque entrée.
Voici la sortie du terminal lors de la première session d’Alex dans l’assistant, qui suit le chemin Build Profile :
╭────────────────────────────────────────────────────────────────────────────╮
│ 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
Relancez sweepy --setup à tout moment pour créer un profil ou modifier un profil existant. L’assistant écrit dans le fichier qu’il nomme et laisse vos autres profils intacts.
Pour ignorer le lanceur et modifier directement un profil enregistré, passez l’option --profile :
sweepy --setup --profile profiles/paralegal_nyc.yaml
Option B : modifier le fichier de configuration manuellement
Pour saisir vos paramètres directement, copiez le modèle d’exemple et ouvrez-le dans un éditeur de texte brut comme Notepad ou VS Code. Évitez les traitements de texte, qui remplacent les guillemets droits par des guillemets courbes et cassent le YAML.
- 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
Le profil d’Alex
L’assistant écrit ce fichier dans profiles/alex_rivera_paralegal.yaml. Les lignes qui commencent par # sont des commentaires : elles expliquent chaque paramètre, et Sweepy les ignore. Sweepy applique une valeur par défaut à toute section ou tout paramètre que vous omettez.
# ─────────────────────────────────────────────────
# 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"
Sous Windows : utilisez des doubles barres obliques inverses (\\) ou des barres obliques (/) dans les chemins YAML. Une seule barre inverse (\) casse le format YAML.
✅ Correct : "C:\\Users\\Alex\\Documents\\resume.pdf" ou "C:/Users/Alex/Documents/resume.pdf"
❌ Incorrect : "C:\Users\Alex\Documents\resume.pdf"
Utiliser les profils prédéfinis
Sweepy inclut des profils prêts à l’emploi dans le dossier profiles/. Ces quatre modèles couvrent des recherches courantes :
| Fichier | Parcours professionnel | Intitulés recherchés |
|---|---|---|
paralegal_nyc.yaml | Juridique | Paralegal, Legal Assistant, Litigation Support Specialist, Legal Secretary |
frontend_developer.yaml | Ingénierie logicielle | Front End Developer, React Developer, UI Engineer |
tech_writer.yaml | Rédaction technique | Technical Writer, UX Writer, Content Designer |
template_custom.yaml | Tout parcours | Intitulés d’exemple que vous remplacez. Chaque paramètre a un commentaire. |
Pour utiliser un profil prédéfini, passez son nom de fichier au lancement d’un balayage :
sweepy --profile profiles/frontend_developer.yaml
Vous pouvez créer autant de profils que vous voulez. Enregistrez un profil différent pour chaque variante d’intitulé ou chaque ville ciblée. Passez de l’un à l’autre instantanément avec l’option --profile.
Option C : automatiser avec un assistant de discussion
Un assistant de discussion peut créer des profils et lancer des balayages pour vous. Sweepy inclut un serveur Model Context Protocol (MCP), et l’assistant lit et écrit directement vos profils. Le guide d’intégration MCP couvre la configuration client pour Antigravity, Claude Desktop et VS Code, et la référence des outils MCP liste tous les outils de Sweepy.
Consulter chaque paramètre
La référence de configuration liste tous les paramètres qu’un profil accepte, de debug et resume.tracks à sources.* et report.*. Gardez-la ouverte pendant que vous modifiez votre profil.
Vérifier où Sweepy cherche des emplois
Sweepy interroge quatre systèmes publics de suivi des candidatures par défaut. Ce groupe couvre Greenhouse, Ashby, Lever et Workable. Il interroge aussi Built In NYC, un site d’emploi new-yorkais. Les flux d’agrégateurs de LinkedIn, Indeed, Glassdoor et ZipRecruiter passent par python-jobspy quand votre profil les active.
Des moteurs optionnels ajoutent des sites. Les options sont HireHunt, OpenRoles, JobDrop et Apify. OpenRoles exige une liste d’entreprises avant de démarrer. Apify exige un APIFY_TOKEN. JobDrop entre en conflit avec la version épinglée de JobSpy. L’option Download job engines de l’assistant de configuration les installe.
La page sources et plateformes couvre les moteurs optionnels, les fichiers d’amorçage, les entrées de plateformes personnalisées et les réserves de compatibilité.
Votre profil est prêt. Il est temps de lancer votre premier balayage.