SPB Git forge

spb/auto-ka

Public
61commits 1branches 0releases
14.4 MBsize
maindefault branch
13 days agolast push
Python 61.6% TypeScript 20.9% CSS 11.4% JavaScript 5.1% HTML 1.1%
4.8 KB

# Module sm360_dealers — sm360

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

# Vue d'ensemble

  • Fichier : autoka/connectors/sm360_dealers.py
  • Sources membres : 15
  • Annonces actives (BD) : 1397
  • Backend de fetch : requests direct — Firecrawl par source au besoin (use_firecrawl, sites derrière Cloudflare)
  • Mécanique détectée : sitemap, JSON-LD schema.org, GraphQL, flux RSS, API JSON interne, endpoint JSON
  • Plafonds / cache : AUTOKA_MAX_DETAILS, cache détail BD (detail_cache)
  • Classes : ToutesLesMarques → touteslesmarques ; StJeromeAutoDepot → stjeromeautodepot ; LamontagneAuto → lamontagneauto ; Spinelli → spinelli ; AutoDesjardins → autodesjardins ; LallierHondaHull → lallierhondahull … (+9)

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

connectors/sm360_dealers.py : connecteurs des concessionnaires sur plateforme SM360 / 360.agency (fournisseur de sites très répandu chez les concessionnaires franchisés au Québec).

Stratégie : le sitemap (/fr/sitemap-xml) recense chaque page véhicule d'occasion (/fr/inventaire-occasion//<modèle>/-id). Chaque page détail est server-rendered et expose :

  1. un JSON-LD schema.org (@type Car) : prix, km, VIN, transmission, carrosserie, couleurs, portes/places, moteur, succursale vendeuse ;
  2. un dataLayer JS : stockNo, isNew/isDemo, catégorie de véhicule, carburant, succursale (utile pour les groupes multi-succursales) ;
  3. la galerie photo complète (img.sm360.ca/…/images/inventory/…) ;
  4. le lien Carfax le cas échéant. Les pages détail sont mises en cache BD (clé hebdomadaire) : seuls les nouveaux véhicules — et une revalidation par semaine pour les prix — génèrent de vraies requêtes.

En complément, l'API GraphQL publique que le site utilise lui-même (webauto-supplier-api.sm360.ca — celle des widgets VDP) donne pour chaque id : la liste d'équipements (options.labels), la galerie complète (multimedia.pictures — indispensable pour les gabarits dont la galerie n'est PAS server-rendered : touteslesmarques, spinelli, rivesudchrysler, toyotagatineau) et une description/tagline de repli. Un POST par véhicule, mis en cache avec le même payload hebdomadaire.

Le listing lui-même est un widget JS (GraphQL webauto-supplier-api) — inutile ici, le sitemap suffit. robots.txt : Allow /?page= et //api/, Crawl-delay 10 → délai généreux + cache détail.

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

Champ % rempli
Marque 99.6 %
Modèle 100.0 %
Année 100.0 %
Kilométrage 98.5 %
Prix 99.7 %
Carburant 95.3 %
Boîte (transmission) 89.0 %
VIN 99.5 %
Photos 89.0 %
Carfax 21.2 %
GPS (lat/lng) 100.0 %

# Sources membres (BD live)

Source Nom Ville Région Actives Masquées (dup VIN) Dernier sync Statut
autodesjardins Automobiles Desjardins Québec Capitale-Nationale 106 0 2026-09-13 16:21 OK (100 trouvés)
baiecomeaugm Baie-Comeau Chevrolet Buick GMC Baie-Comeau Côte-Nord 107 101 2026-09-13 16:22 OK (100 trouvés)
kiamatane Kia Matane Matane Bas-Saint-Laurent 46 2 2026-09-13 16:23 OK (46 trouvés)
lallierhondahull Lallier Honda Hull Gatineau Outaouais 67 0 2026-09-13 16:21 OK (67 trouvés)
lamontagneauto Lamontagne Auto Rimouski Bas-Saint-Laurent 10 0 2026-09-13 16:20 OK (10 trouvés)
marquisautomobiles Marquis Automobiles Matane Bas-Saint-Laurent 34 0 2026-09-13 16:23 OK (34 trouvés)
rivesudchrysler Rive-Sud Chrysler Brossard Montérégie 17 0 2026-09-13 16:21 OK (17 trouvés)
septilesgm Sept-Îles Chevrolet Buick GMC Sept-Îles Côte-Nord 100 81 2026-09-13 16:22 OK (100 trouvés)
septileshonda Sept-Îles Honda Sept-Îles Côte-Nord 16 0 2026-09-13 16:22 OK (16 trouvés)
spinelli Groupe Spinelli Montréal Montréal 100 0 2026-09-13 16:21 OK (100 trouvés)
stjeromeautodepot St-Jérôme Auto Dépôt Saint-Jérôme Laurentides 199 0 2026-09-13 16:20 OK (199 trouvés)
touteslesmarques Toutes les marques Chicoutimi Saguenay–Lac-Saint-Jean 318 317 2026-09-13 16:20 OK (318 trouvés)
toyotagatineau Toyota Gatineau Gatineau Outaouais 100 0 2026-09-13 16:22 OK (100 trouvés)
villeneuveford Villeneuve Ford Matane Bas-Saint-Laurent 68 0 2026-09-13 16:23 OK (68 trouvés)
volvosaintleonard Volvo Cars Saint-Léonard Montréal Montréal 109 0 2026-09-13 16:22 OK (109 trouvés)

# Erreurs de synchronisation récentes

Aucune erreur dans le sync_log pour les sources de ce module.