Que fait Scraper d'Emplois ?
Découvre les nouvelles offres, les filtre selon le profil du candidat et rapporte uniquement ce qui est vraiment nouveau.
Configuration
Lu depuis $JOB_SEARCH_HOME/integrations.yaml :
| Besoin | Clé |
|---|---|
Chaines de localisation pour --where | search_locations |
| CLI de recherche structurée | tools.board_search_cli |
| CLI LinkedIn optionnelle | tools.linkedin_search_cli |
| Fichier de suivi pour déduplication | tracker_path |
- Catégories, mots-clés de rôle et filtres :
references/search-queries.md - Faits sur le candidat :
$JOB_SEARCH_HOME/profile.md
Si search_locations ou tools.board_search_cli est vide, arrêter et nommer la clé. Ne pas utiliser de ville codée en dur ni inventer de chemin CLI.
Invocation
Déclenché par "trouver de nouveaux emplois", "scraper pour des emplois", "toute nouvelle position", /scrape.
Arguments optionnels :
- un domaine ciblé —
/scrape platform broad— exécuter toutes les catégories prioritairesremote— filtre strict sur les postes à distance et hybrideslinkedin— opt-in pour le canal LinkedIn (voir Étape 2b ; désactivé par défaut)
Étape 0 — Chargement de l'état
- Lire
job_scraper/seen_jobs.json, le créer comme{"seen": {}}s'il est absent - Lire
tracker_pathpour les entreprises et rôles déjà postulés - Lire
references/search-queries.mdpour les catégories, mots-clés et niveaux de localisation - Lire
$JOB_SEARCH_HOME/profile.mdpour fonder l'évaluation de l'Étape 4
Étape 1 — Recherche structurée sur le tableau principal
Pour chaque catégorie prioritaire, exécuter le CLI une fois par mot-clé d'intitulé de poste. Top 3 catégories par défaut ; toutes en mode broad ; la catégorie nommée en mode ciblé.
python3 <board_search_cli> --keywords "<role title>" --where "<location>" --pages 2
# recherche à distance :
python3 <board_search_cli> --keywords "<role title>" --where "All Australia" --remote --pages 2
# seulement récent :
python3 <board_search_cli> --keywords "<role title>" --where "<location>" --days 14 --pages 2
Exécuter via Bash. Il produit un tableau JSON — l'analyser directement. Grouper les appels par mot-clé ; chacun est rapide. Utiliser search_locations dans l'ordre pour --where.
Étape 2 — Plateformes de startups et ATS (secondaire, optionnel)
Pour les rôles de fondateur-ingénieur et de stade précoce où le tableau principal sous-indexe, effectuer quelques recherches web sur les plateformes de startups et les hébergeurs ATS. Ne récupérer une offre que si elle semble fortement correspondre. La recherche web est biaisée par région, donc vérifier l'éligibilité dans le pays du candidat avant de présenter — de nombreux résultats ne sont pas locaux.
Étape 2b — LinkedIn (optionnel uniquement)
Exécuter uniquement lorsque le candidat a explicitement opté-in. L'automatisation enfreint les conditions d'utilisation de la plateforme, donc elle est désactivée par défaut. En cas d'opt-in, préciser que c'est à ses risques, garder le volume bas, et fusionner les résultats dans la même déduplication et classement que le canal principal.
Si tools.linkedin_search_cli est vide, dire que le canal n'est pas configuré plutôt que de deviner.
Étape 3 — Déduplication
Pour chaque résultat :
- Ignorer si son ID de tableau ou URL, ou sa clé
company+title, est déjà dansseen_jobs.json - Ignorer si
company+roleapparaît déjà danstracker_path
Étape 4 — Évaluation rapide de la compatibilité
Un signal, pas l'évaluation complète. Utiliser l'aperçu, l'intitulé, le salaire, le type de travail et les points clés renvoyés par la recherche :
- Élevée — correspond aux compétences clés, lieu ou télétravail ok, et salaire (si affiché) dépasse le minimum
- Moyenne — rôle adjacent, ou lieu et salaire à vérifier
- Faible — écart de compétences significatif, ou sur site en dehors des lieux configurés sans télétravail
Vérifier le domaine avant l'intitulé. Un intitulé senior n'est pas un indicateur du domaine. Un poste annoncé comme "Lead Engineer" ou "Staff Engineer" peut être un rôle de backend ou d'ingénierie applicative dont l'exigence centrale est une expertise pratique dans un langage comme Java, Spring Boot, .NET ou PHP. Si l'exigence principale est un domaine ou un langage hors du profil documenté du candidat, le noter Faible quel que soit le titre senior, quel que soit le domaine familier. Le contexte de paiement, banque ou plateforme-adjacent ne transforme pas un rôle backend en rôle plateforme.
Lire $JOB_SEARCH_HOME/targets.md pour les stacks à exclure, et les Compétences Clés dans profile.md pour ce qui est réellement prouvé. Une exigence listée dans l'annonce n'est pas une preuve que le candidat la possède.
Appliquer le filtre de localisation depuis references/search-queries.md.
Étape 5 — Stockage
Enregistrer chaque emploi trouvé, y compris ceux ignorés :
{
"seen": {
"<board-id-or-company-title-key>": {
"title": "…", "company": "…", "location": "…", "url": "…",
"salary": "…", "work_arrangement": "…",
"first_seen": "YYYY-MM-DD", "fit": "high|medium|low",
"status": "new|skipped|evaluated"
}
}
}
Étape 6 — Présentation
## Nouvelles Correspondances d'Emplois — YYYY-MM-DD
Trouvée(s) X nouvelle(s) position(s) (Y élevée(s), Z moyenne(s), W faible(s) correspondance(s)).
| # | Fit | Titre | Entreprise | Lieu | Arrangement | Salaire | URL |
|---|-----|-------|------------|------|-------------|---------|-----|
| 1 | High | … | … | … | Remote/Hybrid | … | [Lien](…) |
Puis 2–3 puces par correspondance élevée : pourquoi ça correspond, exigences à vérifier, signaux d'alarme.
Terminer en demandant s'il faut évaluer en détail ou postuler. Une description complète est nécessaire avant que le workflow job-application-assistant puisse s'exécuter — l'étape de recherche ne renvoie qu'un aperçu, donc récupérer le détail d'abord.
Étape 7 — Mise à jour du suivi
Si le candidat décide de postuler, ajouter une ligne à tracker_path.
Règles
- Ne jamais inventer d'offres. Présenter uniquement ce que le CLI ou une récupération réelle a renvoyé.
- Toujours dédupliquer contre
seen_jobs.jsonettracker_path. - Respecter les niveaux de localisation configurés. Ignorer les postes sur site en dehors sauf opt-in.
- Uniquement les postes ouverts. Les résultats sont en direct, mais ignorer tout ce qui est visiblement obsolète.
- Récupérer la description complète avant d'évaluer ou de postuler.
- Le domaine prime sur l'intitulé. Filtrer sur le langage principal et le domaine dans les exigences, jamais uniquement sur l'intitulé du poste. Un titre senior sur une stack que le candidat ne maîtrise pas est une correspondance faible.
- Efficacité. Filtrer d'abord sur l'intitulé, l'aperçu et le salaire ; ne pas récupérer chaque résultat.
- Ne jamais requêter LinkedIn sans un opt-in explicite.