SPB Git forge

spb/lou-ka

Public

Lou·Ka — tous les logements à louer du Québec, un seul endroit.

232commits 1branches 0releases
172.9 MBsize
maindefault branch
3 days agolast push
HTML 98.9% Python 0.6%
6.0 KB

# K-G Group (MyRental.ca) — connecteur kggroup

Fiche générée automatiquement par scripts/gen_connector_docs.py le 2026-09-04 14:12 — ne pas éditer à la main, régénérer.

État : pause · Région : Ontario — multi-régions · Backend : direct · Annonces actives : 10/10

# Description de la source

connecteur KG Group (myrental.ca) Gestionnaire familial torontois (~4 700 suites — 7 tours à Midtown, North York, Yonge & Sheppard). Le site est un Rentsync « nouvelle génération » (SPA Vue servie par cdn.rentsync.com/site/kg_rebuild) : PAS le flux LiftSystem classique (api.theliftsystem.com, cf. liftsystem.py) mais l'API interne « website-gateway » découverte dans les bundles JS : https://website-gateway-cdn.rentsync.com/v1/kg_rebuild/ properties -> 7 immeubles (adresse, GPS, quartier, overview HTML, politique animaux…) properties//unit-summary -> unités DISPONIBLES en direct (typeName, bed, bath, sqFt, rate) properties//photos -> galerie (fichiers S3 lws_lift, servis en https://s3.amazonaws.com/lws_lift/ kggroup/images/gallery/full/) properties//amenities -> commodités nommées Aucun anti-bot, pas de clé : l'API répond à un simple GET JSON. Une annonce PAR TYPE D'UNITÉ DISPONIBLE (groupé sur typeName, ex. « 1A »), prix plancher réel du groupe ; repli « une annonce par immeuble » SANS prix quand aucune unité n'est affichée (rien d'inventé). unit-summary est interrogé en direct à chaque synchronisation (c'est la donnée vivante) ; photos + commodités passent par le cache BD self.detail() (clé = champ modified de l'immeuble). Toutes les adresses sont à Toronto (North York, Midtown… = quartiers) : city = « Toronto », sector = neighbourhood du flux. Expansion Ontario — GATÉE par LOUKA_ONTARIO=1 : sans la variable, le connecteur est disabled et exclu du registre (zéro impact prod QC).

# Accès

# Champs récupérés → schéma cible

Le connecteur (direct, API JSON interne du site) alimente les colonnes de la table listings. Complétude mesurée en SQL sur les 10 annonces actives ; exemple tiré d'une ligne réelle de la BD.

Colonne listings Contenu Renseignée (actives) Exemple réel
title Titre de l'annonce 100 % Canyon — Suite 1A
address Adresse civique 100 % 35 Canyon Avenue, Toronto, ON M3H 4Y2
city Ville (normalisée) 100 % Toronto
sector Secteur / quartier 100 % North York
unit_type Type d'unité (3½, 4½…) 60 % 3½
price Loyer mensuel ($) 60 % 1 750 $
bedrooms Chambres 60 % 1
bathrooms Salles de bain 60 % 1
area_sqft Superficie (pi²) 60 % 782
availability_date Date de disponibilité 100 % now
lat GPS (lat/lng) 100 % 43.7580011
description Description 100 % Viewpoint Towers by KG Group | 35 Canyon Ave North York Apartments Bathurst & Sheppard G…
images Photos (JSON) 100 % 14 photo(s) — https://s3.amazonaws.com/lws_lift/kggroup/images/gallery/full/1780692509430…
amenities Commodités (JSON) 100 % ["Keyless entry", "On-site staff", "Outdoor pool", "Laundry facilities", "Convenience sto…
details Détails additionnels (JSON) 100 % {"inclusions": {"internet": true, "cable": true}, "appliances": {"fridge": true, "stove":…
url URL de l'annonce source 100 % https://www.myrental.ca/apartments-for-rent/35-canyon-ave

# Fréquence & budget

  • Cadence observée (médiane des passages OK, sync_log) : ≈ 2.4 h
  • Dernier passage OK : 2026-08-27 13:16 — 10 trouvées, +0 / ~1 / -0
  • Throttling : 1.0 s entre requêtes (constante de classe request_delay)
  • Cache des pages détail (BD detail_cache) : activé — évite de re-visiter les fiches inchangées

# Volumétrie & complétude

  • Annonces en BD : 10 au total, 10 actives
  • Première ingestion : 2026-08-27 · Dernière observation : 2026-08-27
  • Complétude clé (actives) : GPS 100 % · prix 60 % · photos 100 % · description 100 %
  • Runs journalisés (60 derniers) : 5, dont 0 en erreur

# Erreurs connues & dépannage

Aucune erreur dans les 60 derniers runs journalisés.

Note du registre : pause

Rejouer la source seule : python3 run.py sync kggroup · vérifier ensuite sync_log (SELECT * FROM sync_log WHERE source='kggroup' ORDER BY ts DESC LIMIT 5;).

# Licence, attribution & conditions

  • Scraping poli d'annonces publiques (données factuelles : prix, adresse, disponibilité) publiées par le gestionnaire sur son propre site.
  • User-Agent identifiable avec page d'information et contact : LouKaBot/1.0 (+https://www.lou-ka.com/bot; contact@spboucher.ai) ; throttling 1.0 s ; cache détail pour minimiser les requêtes.
  • Chaque annonce affichée sur Lou-Ka pointe vers l'annonce d'origine (colonne url) — la source garde le trafic de conversion.
  • Retrait sur demande : contact@spboucher.ai.

# Historique

  • 2026-08-27 — premières annonces de la source ingérées dans la BD.
  • 2026-08-18 — vague d'enrichissement : standardisation de la documentation des connecteurs (fiche générée par scripts/gen_connector_docs.py).