spb/lou-ka

1# Q Residential — connecteur `qresidential`23_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._45**État : pause** · Région : Ontario — multi-régions · Backend : direct · Annonces actives : 25/2567## Description de la source89connecteur Q Residential (qresidential.ca) Gestionnaire ontarien (~7 000 unités — Toronto, St. Catharines, Hamilton, Oshawa/GTA, Brampton, Barrie). « Corporate site » Yardi RentCafe derrière un Cloudflare STRICT (curl direct = 403) : tout passe par Scrapfly ASP (self.get_scrapfly, asp=true, SANS render_js — le contenu est rendu serveur, vérifié sur la recherche et les fiches). Contrairement à killam.py (même famille RentCafe), il n'y a PAS de blob #available_prop : la page /searchlisting.aspx rend 25 cartes propriétés côté serveur (nom, adresse, ville, province, vignette, URL de fiche). La fiche propriété fournit un JSON-LD ApartmentComplex (description, adresse postale, GPS, commodités, téléphone) et un tableau « Floor Plans » (tbody.floorplan-details : nom, Bed/Bath, pi², loyer — souvent « Call for pricing » —, disponibilité). Une annonce PAR PLAN D'ÉTAGE quand au moins un plan affiche un prix ; sinon repli « une annonce par propriété » sans prix (rien d'inventé). Fiches visitées via le cache BD self.detail(), clé datée du jour : au plus UNE visite Scrapfly par propriété par jour, peu importe le nombre de synchronisations. Expansion Ontario — GATÉE par LOUKA_ONTARIO=1 : sans la variable, le connecteur est `disabled` et exclu du registre (zéro impact prod QC).1011- **Site** : https://www.qresidential.ca12- **Page des annonces** : https://www.qresidential.ca/searchlisting.aspx13- **Secteurs couverts** : Toronto, St. Catharines, Hamilton, Niagara, Kitchener14- **Module** : `louka/connectors/qresidential.py` — classe `QResidentialConnector`1516## Accès1718- **Type d'accès** : pages HTML (rendu serveur)19- **Endpoint de base** : https://www.qresidential.ca20- **URLs de départ (constantes du module)** : https://www.qresidential.ca21- **Authentification** : aucune — contenu public22- **Pagination** : page de liste unique (pas de pagination)23- **Backend anti-bot / rendu** : requests direct24- **Politesse** : 1.5 s entre requêtes, timeout 30 s, User-Agent identifiable `LouKaBot/1.0 (+https://www.lou-ka.com/bot)`2526## Champs récupérés → schéma cible2728Le connecteur (direct, pages HTML (rendu serveur)) alimente les colonnes de la table `listings`. Complétude mesurée en SQL sur les 25 annonces actives ; exemple tiré d'une ligne réelle de la BD.2930| Colonne `listings` | Contenu | Renseignée (actives) | Exemple réel |31|---|---|---|---|32| `title` | Titre de l'annonce | 100 % | Queenston Manor |33| `address` | Adresse civique | 100 % | 382 Queenston Street, St. Catharines, ON L2P 3V5 |34| `city` | Ville (normalisée) | 100 % | St. Catharines |35| `sector` | Secteur / quartier | 0 % | — |36| `unit_type` | Type d'unité (3½, 4½…) | 4 % | — |37| `price` | Loyer mensuel ($) | 0 % | — |38| `bedrooms` | Chambres | 8 % | — |39| `bathrooms` | Salles de bain | 0 % | — |40| `area_sqft` | Superficie (pi²) | 0 % | — |41| `availability_date` | Date de disponibilité | 0 % | — |42| `lat` | GPS (lat/lng) | 100 % | 43.158181 |43| `description` | Description | 56 % | Queenston Manor is a building that offers spacious one and two bedroom suites. The buildi… |44| `images` | Photos (JSON) | 100 % | 13 photo(s) — https://cdngeneralcf.rentcafe.com/dmslivecafe/2/143346/382QueenstonSt-Thumb… |45| `amenities` | Commodités (JSON) | 60 % | ["Recycling", "Fitness Center", "Library", "Secured Entry", "On-Site Maintenance", "On-Si… |46| `details` | Détails additionnels (JSON) | 64 % | {"inclusions": {"heating": true, "electricity": true, "cable": true}, "appliances": {"fri… |47| `url` | URL de l'annonce source | 100 % | https://www.qresidential.ca/apartments/on/st.-catharines/queenston-manor/default.aspx |4849## Fréquence & budget5051- **Cadence observée** (médiane des passages OK, sync_log) : ≈ 2.8 h52- **Dernier passage OK** : 2026-08-27 14:09 — 25 trouvées, +0 / ~0 / -053- **Throttling** : 1.5 s entre requêtes (constante de classe `request_delay`)54- **Cache des pages détail (BD `detail_cache`)** : activé — évite de re-visiter les fiches inchangées5556## Volumétrie & complétude5758- **Annonces en BD** : 25 au total, **25 actives**59- **Première ingestion** : 2026-08-27 · **Dernière observation** : 2026-08-2760- **Complétude clé (actives)** : GPS 100 % · prix 0 % · photos 100 % · description 56 %61- **Runs journalisés (60 derniers)** : 5, dont 0 en erreur6263## Erreurs connues & dépannage6465Aucune erreur dans les 60 derniers runs journalisés.6667**Note du registre** : pause6869Rejouer la source seule : `python3 run.py sync qresidential` · vérifier ensuite `sync_log` (`SELECT * FROM sync_log WHERE source='qresidential' ORDER BY ts DESC LIMIT 5;`).7071## Licence, attribution & conditions7273- Scraping poli d'annonces **publiques** (données factuelles : prix, adresse, disponibilité) publiées par le gestionnaire sur son propre site.74- User-Agent **identifiable** avec page d'information et contact : `LouKaBot/1.0 (+https://www.lou-ka.com/bot; contact@spboucher.ai)` ; throttling 1.5 s ; cache détail pour minimiser les requêtes.75- Chaque annonce affichée sur Lou-Ka **pointe vers l'annonce d'origine** (colonne `url`) — la source garde le trafic de conversion.76- Retrait sur demande : contact@spboucher.ai.7778## Historique7980- 2026-08-27 — premières annonces de la source ingérées dans la BD.81- 2026-08-18 — vague d'enrichissement : standardisation de la documentation des connecteurs (fiche générée par `scripts/gen_connector_docs.py`).82