spb/lou-ka

1# BARNES Québec (location) — connecteur `barnes_quebec`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 : Montréal · Backend : direct · Annonces actives : 78/12467## Description de la source89BARNES Québec (barnes-quebec.com) — LOCATIONS Agence de prestige (Montréal, Québec, Laval, Mont-Tremblant…). Site WordPress indexé dans Algolia ; la config expose l'App ID et une clé API dans le HTML. L'index « quebec_all » mélange ventes (type "property") et locations (type "rental") : on filtre côté serveur avec facetFilters=[["type:rental"]]. Chaque location porte le loyer mensuel numérique (property_rent), l'adresse, chambres/salles de bains, superficie et géolocalisation. Les enregistrements sont dupliqués par langue (FR/EN) → on dédoublonne par titre normalisé en gardant la fiche FR. Adapté du connecteur « à vendre » d'Immo-Ka (agent-courtage/immoka).1011- **Site** : https://barnes-quebec.com12- **Page des annonces** : https://barnes-quebec.com/louer/13- **Secteurs couverts** : Montréal et environs — locations haut de gamme (index Algolia, facette type:rental)14- **Module** : `louka/connectors/barnes_quebec.py` — classe `BarnesQuebecConnector`1516## Accès1718- **Type d'accès** : API JSON interne du site19- **Endpoint de base** : https://barnes-quebec.com20- **URLs de départ (constantes du module)** : https://{APP_ID}-dsn.algolia.net/1/indexes/{INDEX}/query · https://barnes-quebec.com21- **Authentification** : aucune — contenu public22- **Pagination** : pagination par numéro de page23- **Backend anti-bot / rendu** : requests direct (session UA LouKaBot, throttling poli)24- **Politesse** : 0.25 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, API JSON interne du site) alimente les colonnes de la table `listings`. Complétude mesurée en SQL sur les 78 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 % | 6675 Rue St-Urbain #302 Montréal (Rosemont/La Petite-Patrie) (Montréal) |33| `address` | Adresse civique | 100 % | 6675 Rue St-Urbain #302 |34| `city` | Ville (normalisée) | 94 % | Montréal |35| `sector` | Secteur / quartier | 69 % | Rosemont/La Petite-Patrie |36| `unit_type` | Type d'unité (3½, 4½…) | 94 % | 4½ |37| `price` | Loyer mensuel ($) | 96 % | 2 600 $ |38| `bedrooms` | Chambres | 94 % | 2 |39| `bathrooms` | Salles de bain | 95 % | 1 |40| `area_sqft` | Superficie (pi²) | 65 % | 775 |41| `availability_date` | Date de disponibilité | 0 % | — |42| `lat` | GPS (lat/lng) | 96 % | 45.53074 |43| `description` | Description | 100 % | La PETITE-ITALIE et un dernier étage !! Face aux studios Mila et Behaviour Interactive, c… |44| `images` | Photos (JSON) | 100 % | 42 photo(s) — https://barnes-quebec.com/wp-content/uploads/2026/08/24043507-addcb7eda4967… |45| `amenities` | Commodités (JSON) | 0 % | [] |46| `details` | Détails additionnels (JSON) | 100 % | {"inclusions": {"electricity": true}, "appliances": {"fridge": true, "stove": true, "dish… |47| `url` | URL de l'annonce source | 100 % | https://barnes-quebec.com/rental/6675-rue-st-urbain-302-montreal-rosemont-la-petite-patri… |4849## Fréquence & budget5051- **Cadence observée** (médiane des passages OK, sync_log) : ≈ 3.3 h52- **Dernier passage OK** : 2026-09-04 13:55 — 78 trouvées, +0 / ~0 / -053- **Throttling** : 0.25 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ées55- **Caps / budgets du module** : `HITS_PER_PAGE` = 100, `MAX_PAGES` = 405657## Volumétrie & complétude5859- **Annonces en BD** : 124 au total, **78 actives**60- **Première ingestion** : 2026-08-12 · **Dernière observation** : 2026-09-0461- **Complétude clé (actives)** : GPS 96 % · prix 96 % · photos 100 % · description 100 %62- **Runs journalisés (60 derniers)** : 60, dont 1 en erreur6364## Erreurs connues & dépannage6566| Date | Message (sync_log) |67|---|---|68| 2026-08-29 14:53 | 403 Client Error: Forbidden for url: https://hcw55viqnm-dsn.algolia.net/1/indexes/quebec_all/query |6970Rejouer la source seule : `python3 run.py sync barnes_quebec` · vérifier ensuite `sync_log` (`SELECT * FROM sync_log WHERE source='barnes_quebec' ORDER BY ts DESC LIMIT 5;`).7172## Licence, attribution & conditions7374- Scraping poli d'annonces **publiques** (données factuelles : prix, adresse, disponibilité) publiées par le gestionnaire sur son propre site.75- User-Agent **identifiable** avec page d'information et contact : `LouKaBot/1.0 (+https://www.lou-ka.com/bot; contact@spboucher.ai)` ; throttling 0.25 s ; cache détail pour minimiser les requêtes.76- Chaque annonce affichée sur Lou-Ka **pointe vers l'annonce d'origine** (colonne `url`) — la source garde le trafic de conversion.77- Retrait sur demande : contact@spboucher.ai.7879## Historique8081- 2026-08-12 — premières annonces de la source ingérées dans la BD.82- 2026-08-18 — vague d'enrichissement : standardisation de la documentation des connecteurs (fiche générée par `scripts/gen_connector_docs.py`).83