# Module `hgregoire` — Site custom

_Généré automatiquement par `scripts/gen_connector_docs.py` — ne pas éditer à la main._

## Vue d'ensemble

- **Fichier** : `autoka/connectors/hgregoire.py`
- **Sources membres** : 1
- **Annonces actives (BD)** : 1938
- **Backend de fetch** : Scrapfly
- **Mécanique détectée** : blob JSON data-class
- **Plafonds / cache** : AUTOKA_MAX_DETAILS, AUTOKA_MAX_PAGES, cache détail BD (detail_cache)
- **Classes** : `HGregoire` → `hgregoire`

## Mécanique (en-tête du module)

> connectors/hgregoire.py : connecteur HGrégoire (hgregoire.com), la plus
> grosse chaîne de mégacentres d'occasion au Québec (St-Léonard, Laval,
> St-Eustache, Saguenay/Chicoutimi, Carbonear/Gaspésie, etc.).
> 
> Stratégie : la page de résultats /auto-usage?page=N est rendue côté
> serveur (WordPress custom) et embarque, pour CHAQUE carte véhicule, un
> <script type="application/json" data-class="Vehicle"> complet :
> Id, année/marque/modèle/version, prix (CAD), odomètre, VIN, no de stock,
> transmission, carburant, traction, carrosserie, couleurs, moteur,
> consommation, photo principale, Permalink ET la succursale du véhicule
> (FullLocation.city + province). 24 véhicules par page, ~74 pages —
> AUCUNE page détail nécessaire : ~75 requêtes pour tout l'inventaire.
> 
> Seules les succursales du QUÉBEC sont conservées (FullLocation.province
> == "QC") — le groupe opère aussi aux États-Unis (hgreg.com) et un
> véhicule hors-Québec serait exclu par ce garde-fou.
> 
> robots.txt demande Crawl-delay: 10 → request_delay élevé (sync complet
> ≈ 12 min, acceptable pour une synchronisation quotidienne).
> AUTOKA_MAX_PAGES (env) limite le nombre de pages pour les tests.
> 
> ENRICHISSEMENT DÉTAIL (galerie + équipements) : la carte liste n'a qu'UNE
> photo et quelques équipements ; la page détail expose la galerie complète
> (~25 photos) et l'onglet « Équipements » (~40 items). Avec Crawl-delay: 10
> un crawl direct des ~1 700 fiches prendrait ~4,7 h → les pages détail
> passent par SCRAPFLY (requêtes gérées par leur infra, non soumises au
> crawl-delay de notre IP). Cache BD à vie (clé stable « v1 » — la galerie
> et les équipements ne changent pas), plafond AUTOKA_MAX_DETAILS (défaut
> 300/sync) : l'inventaire complet s'enrichit en ~6 synchronisations.
> Le véhicule est toujours émis avec les données liste même sans détail.

## Complétude des champs (annonces actives, N = 1 938)

| Champ | % rempli |
|---|---|
| Marque | 100.0 % |
| Modèle | 100.0 % |
| Année | 100.0 % |
| Kilométrage | 100.0 % |
| Prix | 100.0 % |
| Carburant | 100.0 % |
| Boîte (transmission) | 100.0 % |
| VIN | 100.0 % |
| Photos | 100.0 % |
| Carfax | 0.0 % |
| GPS (lat/lng) | 100.0 % |

## Sources membres (BD live)

| Source | Nom | Ville | Région | Actives | Masquées (dup VIN) | Dernier sync | Statut |
|---|---|---|---|---|---|---|---|
| `hgregoire` | HGrégoire | St-Léonard | Montréal | 1938 | 0 | 2026-09-13 16:07 | OK (1936 trouvés) |

## Erreurs de synchronisation récentes (sync_log, ok = 0)

| Source | Quand | Message |
|---|---|---|
| `hgregoire` | 2026-08-31 20:28 | 502 Server Error: Bad Gateway for url: https://www.hgregoire.com/auto-usage?page=74 |