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
2 days agolast push
HTML 98.9% Python 0.6%
5.1 KB · 80 lines markdown
Rendered Raw Blame History
1# Logisco — connecteur `logisco`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 : actif** · Région : Québec · Backend : direct · Annonces actives : 157/24167## Description de la source89connecteur Logisco (logisco.com) Site rendu serveur. Crawl : page liste principale (+ pages villes) pour découvrir les pages projets, puis extraction des unités disponibles (cartes .unitCard) sur chaque page projet. Une annonce par unité. Chaque page unité (mise en cache via self.detail, plafond 150 vraies requêtes/sync) apporte : JSON-LD (adresse avec no d'unité + code postal, étage, téléphone, plan de l'unité), superficie/étage/dispo structurés (sommaire .unitHeader) et les 4 sections de commodités (Inclusions, Particularités, Services offerts, Espaces communs). Villes retenues : Québec, Lévis, Saint-Augustin-de-Desmaures (Donnacona et autres villes hors région exclues).1011- **Site** : https://logisco.com/fr12- **Page des annonces** : https://logisco.com/fr/appartements-a-louer13- **Secteurs couverts** : Québec (Ste-Foy, Val-Bélair, Loretteville, Vanier, St-Augustin) + Lévis (St-Romuald, St-David, St-Nicolas, Desjardins)14- **Module** : `louka/connectors/logisco.py` — classe `LogiscoConnector`1516## Accès1718- **Type d'accès** : pages HTML (rendu serveur)19- **Endpoint de base** : https://logisco.com20- **URLs de départ (constantes du module)** : https://logisco.com21- **Authentification** : aucune — contenu public22- **Pagination** : page de liste unique (pas de pagination)23- **Backend anti-bot / rendu** : requests direct (session UA LouKaBot, throttling poli)24- **Politesse** : 0.6 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 157 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 % | L'AMALGAM — Appartement 413 |33| `address` | Adresse civique | 100 % | 413-975 Rue de l'École, Lévis, G6W 0V4 |34| `city` | Ville (normalisée) | 100 % | Lévis |35| `sector` | Secteur / quartier | 100 % | Saint-Romuald |36| `unit_type` | Type d'unité (3½, 4½…) | 100 % | 3½ |37| `price` | Loyer mensuel ($) | 100 % | 1 423 $ |38| `bedrooms` | Chambres | 100 % | 1 |39| `bathrooms` | Salles de bain | 0 % | — |40| `area_sqft` | Superficie (pi²) | 100 % | 698 |41| `availability_date` | Date de disponibilité | 100 % | now |42| `lat` | GPS (lat/lng) | 96 % | 46.7358587 |43| `description` | Description | 100 % | Projet L'AMALGAM — 698 pi², Étage 4 — 12 unité(s) disponible(s) dans le projet |44| `images` | Photos (JSON) | 100 % | 17 photo(s) — https://logisco.com/static/vb/3532-475/appartement-413-amalgam-logisco.webp |45| `amenities` | Commodités (JSON) | 100 % | ["Un stationnement intérieur", "Climatisation", "Entrée laveuse et sécheuse", "Entrée lav… |46| `details` | Détails additionnels (JSON) | 100 % | {"appliances": {"washer_dryer_hookup": true, "dishwasher_hookup": true}, "ac": true, "ele… |47| `url` | URL de l'annonce source | 100 % | https://logisco.com/fr/appartements-a-louer/levis/saint-romuald/amalgam/975-appartement-4… |4849## Fréquence & budget5051- **Cadence observée** (médiane des passages OK, sync_log) : ≈ 3.4 h52- **Dernier passage OK** : 2026-09-04 12:19 — 156 trouvées, +0 / ~0 / -4953- **Throttling** : 0.6 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** : 241 au total, **157 actives**59- **Première ingestion** : 2026-08-06 · **Dernière observation** : 2026-09-0460- **Complétude clé (actives)** : GPS 96 % · prix 100 % · photos 100 % · description 100 %61- **Runs journalisés (60 derniers)** : 60, dont 0 en erreur6263## Erreurs connues & dépannage6465Aucune erreur dans les 60 derniers runs journalisés.6667Rejouer la source seule : `python3 run.py sync logisco` · vérifier ensuite `sync_log` (`SELECT * FROM sync_log WHERE source='logisco' ORDER BY ts DESC LIMIT 5;`).6869## Licence, attribution & conditions7071- Scraping poli d'annonces **publiques** (données factuelles : prix, adresse, disponibilité) publiées par le gestionnaire sur son propre site.72- User-Agent **identifiable** avec page d'information et contact : `LouKaBot/1.0 (+https://www.lou-ka.com/bot; contact@spboucher.ai)` ; throttling 0.6 s ; cache détail pour minimiser les requêtes.73- Chaque annonce affichée sur Lou-Ka **pointe vers l'annonce d'origine** (colonne `url`) — la source garde le trafic de conversion.74- Retrait sur demande : contact@spboucher.ai.7576## Historique7778- 2026-08-06 — premières annonces de la source ingérées dans la BD.79- 2026-08-18 — vague d'enrichissement : standardisation de la documentation des connecteurs (fiche générée par `scripts/gen_connector_docs.py`).80