spb/job-ka

1<!--2=============================================================================3Job·Ka — Groupe KA4Auteur  : Simon-Pierre Boucher5Contact : contact@spboucher.ai6Fichier : docs/connecteurs/espresso_jobs.md7Rôle    : Fiche connecteur — portail agrégateur Espresso-Jobs8Généré  : 2026-09-21 18:06 EDT par scripts/gen_connector_docs.py — NE PAS ÉDITER,9          relancer le script pour régénérer.10=============================================================================11-->1213# Espresso-Jobs (`espresso_jobs`) — portail agrégateur1415**Portail agrégateur** (`dedup.AGGREGATORS`) : source complémentaire, moins autoritaire qu'une page carrière. En cas de doublon avec une offre directe, **l'offre directe gagne la canonique** et la copie portail est masquée (`dup_of`). Ces offres ne portent pas le badge « Offre directe ».1617## Description1819- **Portail** : [Espresso-Jobs](https://www.espresso-jobs.com)20- **Secteurs** : Portail, TI, Créatif2122> Portail spécialisé Espresso-Jobs (espresso-jobs.com — TI et créatif QC).23>24> - liste  : pages /emploi?page_no=N — chaque page embarque un JSON-LD25>            schema.org/ItemList (URL + titre de ~21 offres) ;26> - détail : chaque page offre embarque un JSON-LD schema.org/JobPosting27>            (employeur, description, lieu, salaire) — cache BD + budget.2829## Accès3031- **Endpoint** (`BASE`) : `https://www.espresso-jobs.com`32- **Pagination** : par numéro de page33- **Backend** : GET direct `requests` (throttlé, UA `JobKaBot/1.0`)34- **Throttle** : 1.0 s entre requêtes.3536## Champs → schéma3738Complétude mesurée sur les **307 offres actives** de la source (base live, 2026-09-21 18:06 EDT).3940| Champ (`jobs.*`) | Rôle | Complétude |41|---|---|---|42| `title` — Titre | titre du poste | 100 % |43| `employer` — Employeur | nom de l'entreprise | 100 % |44| `url` — URL | lien direct vers l'offre originale | 100 % |45| `description` — Description | texte complet (HTML nettoyé) | 100 % |46| `city` — Ville | municipalité normalisée | 100 % |47| `region` — Région | région administrative | 100 % |48| `address` — Adresse | adresse du lieu de travail | 1 % |49| `postal_code` — Code postal | code postal si publié | 1 % |50| `work_mode` — Mode | presentiel / hybride / teletravail | 17 % |51| `employment_type` — Type | temps_plein / temps_partiel / … | 30 % |52| `salary` — Salaire ($) | bornes numériques normalisées $/h et $/an | 14 % |53| `salary_label` — Libellé salaire | texte salarial original | 6 % |54| `benefits` — Avantages | avantages sociaux publiés (JSON) | 0 % |55| `requirements` — Exigences | scolarité, expérience, langues (JSON) | 97 % |56| `date_posted` — Date de parution | ISO 8601 | 100 % |57| `date_deadline` — Date limite | date limite pour postuler | 100 % |58| `category` — Catégorie | taxonomie interne (TI, Santé, …) | 85 % |59| `language` — Langue | fr / en / bilingue (source ou heuristique) | 100 % |60| `company_logo` — Logo employeur | URL du logo si exposé par la source | 100 % |61| `apply_url` — Candidature | lien de candidature directe | 0 % |62| `gps` — GPS | lat/lng (géocodage sans invention) | 100 % |6364Exemple réel : *Adjoint(e) administratif(ve) (3875)* — Longueuil · Salaire : 50 000 $ à 60 000 $ · parue le 2026-09-21.6566## Fréquence & budgets6768- **Cadence** : resynchronisation **horaire** (PM2 `job-ka-sync` = `run.py watch 60`), suivie du géocodage en lot puis de la déduplication inter-sources.69- **Throttle** : 1.0 s minimum entre deux requêtes vers la source (`request_delay`).70- **Budgets / plafonds (variables d'environnement)** :7172| Variable | Défaut |73|---|---|74| `JOBKA_ESPRESSO_PAGES` | `15` |75| `JOBKA_ESPRESSO_DETAIL_LIMIT` | `100` |76- Cache BD des pages détail (`detail_cache`) : le détail d'une offre n'est re-téléchargé que si sa ligne de liste change.7778## Volumétrie & complétude live7980*(mesuré le 2026-09-21 18:06 EDT dans `data/jobka.db`)*8182- **Offres en base** : 1647 (dont **307 actives**, 19 masquées comme doublons `dup_of`)83- **Salaire** : 43/307 actives (14 %)84- **GPS** : 307/307 actives (100 %)85- **Mode** : 52/307 actives (17 %)86- **Parution** : 307/307 actives (100 %)87- **Dernier sync** : 2026-09-21 16:56 — trouvées 307, +0, ~0, -088- **Syncs enregistrés** (`sync_log`) : 3438990## Erreurs & dépannage9192Aucune erreur dans `sync_log` pour cette source.9394- Rejouer un sync isolé : `.venv/bin/python run.py sync espresso_jobs` puis inspecter `sync_log` : `sqlite3 data/jobka.db "SELECT * FROM sync_log WHERE source='espresso_jobs' ORDER BY ts DESC LIMIT 5;"`95- Garde-fous : une source qui retourne ≤ 25 % de sa médiane historique déclenche une alerte et les retraits sont suspendus ; une offre doit manquer 2 syncs consécutifs avant `active=0`.9697## Licence / conformité9899Lecture du **JSON-LD schema.org** (ItemList + JobPosting) publié par les pages publiques d'Espresso-Jobs. Lien vers l'offre originale sur le portail. robots.txt respecté ; budgets de visites par sync. Aucune donnée personnelle de candidat collectée.100101## Historique102103**Mission connecteurs du 2026-08-18** — passage de 135 à 217 employeurs directs connectés, de 9 à 17 plateformes ATS, ajout de 3 portails agrégateurs et du canal de dépôt direct :104- `fd4bfc8` qualité lieux : rejet des villes hors Québec, bâtiments McGill → Montréal ;105- `5a66f48` +59 employeurs (sondage massif d'ATS + détection de pages carrières) ;106- `4917d57` 8 nouveaux ATS (Taleo, Njoyn, UltiPro, iCIMS, SuccessFactors, ADP WFN, Digital Recruiters, Workland) + 23 employeurs publics/parapublics ;107- `f6e7571` portails Guichet-Emplois, Jobillico, Espresso-Jobs — l'offre directe gagne toujours la canonique (dédup) ;108- `744cbfc` badge « Offre directe », stats directes/portails, dépôt direct employeurs ;109- `1604ff9` reprise sur coupure WAF Guichet-Emplois (retry + acquis partiel).110111Commits touchant `jobka/connectors/espresso_jobs.py` :112113- `f6e7571` 2026-08-18 Portails agrégateurs : Guichet-Emplois, Jobillico, Espresso-Jobs — l offre directe gagne toujours la canonique114