# Connecteur Square Online (`square`)

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

## Mécanique / endpoint

- IDs `user_id`/`site_id` extraits du HTML de la page d'accueil → `GET /app/store/api/v13/editor/users/{user}/sites/{site}/store-pages/…/products` (API storefront publique).
- Module : `fabrika/connectors/square.py`
- Plateformes BD routées ici : `square`

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

> Fabri-Ka — Agrégateur de produits québécois
> Auteur : Simon-Pierre Boucher — contact@spboucher.ai
> connectors/square.py : connecteur générique Square Online (Weebly).
>   Les sites Square Online exposent une API JSON publique côté storefront :
>     /app/store/api/v13/editor/users/<user_id>/sites/<site_id>/products
>   Les identifiants user_id / site_id sont imprimés dans le HTML de chaque
>   page (config JS `user_id: '…'` / `site_id: '…'`). Pagination via
>   meta.pagination.total_pages, 100 produits/page.

## Boutiques rattachées

- Registre `data/stores.json` : **68** boutiques
- En base (table `stores`) : **36** activées, **36** avec produits

**Top 5 par volume :**

| Boutique | Domaine | Produits | Dernier sync | Statut |
|---|---|---|---|---|
| BIZZ coopérative d’alimentation locale | `bizzcoop.com` | 558 | 2026-08-23 15:56 | ok |
| À Outrance | `aoutrance.com` | 303 | 2026-08-23 15:45 | ok |
| Misskikooz | `melissacharette.com` | 280 | 2026-08-23 15:27 | ok |
| ÉCONOMUSÉE® du cidrier | `charlevoixenligne.com` | 213 | 2026-08-23 14:57 | ok |
| Chaga aromatisé - Acheter québécois | `sorcieredepouvoir.com` | 213 | 2026-08-23 13:40 | ok |

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

| Indicateur | Valeur |
|---|---|
| Produits actifs | 2 832 |
| Prix | 99.7 % |
| Photos | 92.5 % |
| Description | 88.5 % |
| Détails (variantes/attributs) | 100.0 % |
| — dont avis (rating/review_count) | 3.6 % |
| — dont poids/dimensions | 0.0 % |

## Gotchas

- Connecteur ajouté en **vague 2** (commit `778d2b6`) — a rendu connectables les boutiques Square jusque-là à 0 produit.
- Deux requêtes minimum par boutique (HTML d'accueil + API).

Voir aussi : [INDEX](INDEX.md) · [transport Scrapfly](scrapfly-transport.md) · [découverte & registre](decouverte-registre.md).