# BARNES Québec (`barnes_quebec`)

*Généré le 2026-08-28 22:22 par `scripts/gen_connector_docs.py` — fichier produit automatiquement, ne pas éditer à la main.*

## Registre (`data/sources.json`)

- **Site** : https://barnes-quebec.com
- **Recherche** : https://barnes-quebec.com/property
- **Couverture** : Montréal + province — luxe international
- **Type** : luxe
- **Statut** : actif

> Algolia (App HCW55VIQNM, index quebec_all). ~344 propriétés, prix/MLS/chambres/sdb/superficie/géoloc. Images non indexées (viendront de la page détail). Dédoublonnage FR/EN par adresse.

## Mécanique (introspection du code)

- Module : `immoka/connectors/barnes_quebec.py` — classe `BarnesQuebecConnector`
- Délai entre requêtes : 0.25 s ; cache détail BD : non
- Budgets env (enrichissement détail plafonné/exécution) : `IMMOKA_BARNES_DETAIL_LIMIT` (défaut 400)

**En-tête du module :**

> Immo-Ka — Agrégateur de maisons à vendre (province de Québec)
> Auteur : Simon-Pierre Boucher — contact@spboucher.ai
> connectors/barnes_quebec.py : BARNES Québec (barnes-quebec.com)
>   Site WordPress indexé dans Algolia. La config expose l'App ID et une clé
>   API dans le HTML (PHPVars) ; l'index « quebec_all » contient les propriétés
>   (type "property") avec adresse, prix, MLS, chambres, salles de bains,
>   superficie et géolocalisation. Les enregistrements sont dupliqués par
>   langue → on dédoublonne par référence MLS. Les permaliens pointent vers le
>   domaine de staging Kinsta ; on les réécrit vers le domaine de production.
>   RÉSILIENCE : la clé Algolia a déjà été rotée (403 le 2026-08-15) — on
>   l'extrait donc À CHAQUE FOIS du HTML public du site (avec cache process),
>   avec repli sur la dernière clé connue si l'extraction échoue.
>   FIABILITÉ (2026-08-18) : l'index Algolia conserve des fiches PÉRIMÉES
>   (vendues/retirées de WordPress) dont la page ET les photos renvoient 404
>   (~100 fiches sur ~340, soit les « annonces sans images »). Le sitemap
>   Yoast (property/rental/new-construction) est la source de vérité de ce
>   qui est publié : on filtre les fiches mortes, et on répare les slugs
>   renommés via la réf MLS présente dans les noms de fichiers image du
>   sitemap. La galerie de la fiche est aussi isolée par sa réf MLS (les
>   pages affichent des « propriétés similaires » qui polluaient la galerie).

## Mécanismes clés

- **Clé Algolia auto-extraite** : App ID / admin key / préfixe d'index lus dans les PHPVars du plugin `barnes-algolia` (wp_localize_script), avec cache et repli sur les derniers identifiants connus — la clé a déjà été rotée (403 le 2026-08-15) et le connecteur s'auto-répare.
- Algolia ne contient pas les photos : elles sont récupérées sur la fiche détail.

## Volumétrie & complétude (BD live)

| Indicateur | Valeur |
|---|---|
| Annonces en base (toutes) | 372 |
| Actives | 231 |
| Visibles (après dédup) | 231 |
| Masquées par la dédup | 0 |
| GPS (lat/lng) | 100.0 % |
| Photos | 100.0 % |
| Prix | 100.0 % |
| CAC (chambres) | 91.3 % |
| SDB (salles de bains) | 89.6 % |
| Année de construction | 75.3 % (dont rôle : 8.6 %) |
| Taxes / évaluation municipale | 72.3 % |
| Estimation Vrai-Prix (rôle) | 100.0 % |

## Synchronisation

- **Dernier sync** : 2026-08-28 22:10 — trouvé 231, +0 / ~1 / -0 — OK
- **Erreurs récentes** : 0 sur les 10 derniers syncs

Voir aussi les [mécanismes transverses](INDEX.md#mécanismes-transverses-tous-connecteurs) (budgets détail, dédup Centris+adresse, jointure rôle vraiprix.db).