# Connecteur Shopify (`shopify`)

*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

- `GET /products.json?limit=250&page=N` — catalogue JSON public de chaque boutique (aucune clé requise).
- Module : `fabrika/connectors/shopify.py`
- Plateformes BD routées ici : `shopify`

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

> Fabri-Ka — Agrégateur de produits québécois
> Auteur : Simon-Pierre Boucher — contact@spboucher.ai
> connectors/shopify.py : connecteur générique Shopify — catalogue complet
>   via l'endpoint public /products.json (paginé, 250 produits/page).

## Boutiques rattachées

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

**Top 5 par volume :**

| Boutique | Domaine | Produits | Dernier sync | Statut |
|---|---|---|---|---|
| Ici & Là - T-shirts et Souvenirs des régions - Acheter québécois | `ici-la.co` | 20 075 | 2026-08-23 15:14 | ok |
| GAGNON - La Grande Quincaillerie | `gagnonlgq.com` | 19 519 | 2026-08-23 15:10 | ok |
| EPIPRESTO | `epipresto.ca` | 13 266 | 2026-08-23 13:59 | ok |
| La Boite à Grains | `laboiteagrains.com` | 10 403 | 2026-08-23 14:00 | ok |
| La Maison du Bleuet | `lamaisondubleuet.com` | 8 652 | 2026-08-23 15:16 | ok |

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

| Indicateur | Valeur |
|---|---|
| Produits actifs | 244 731 |
| Prix | 99.3 % |
| Photos | 96.8 % |
| Description | 90.2 % |
| Détails (variantes/attributs) | 100.0 % |
| — dont avis (rating/review_count) | 0.0 % |
| — dont poids/dimensions | 0.1 % |

## Gotchas

- **Transport curl anti-TLS** : l'empreinte TLS de python-requests déclenche le 429 de Shopify sous volume ; les GET passent par `curl -sS --compressed` en sous-processus.
- **Verrou global 0,7 s** (`_MIN_INTERVAL = 0.7` + lock inter-threads) entre deux requêtes Shopify, avec retry — throttle poli à l'échelle du procédé, pas par boutique.
- Les variantes/prix/images viennent du même JSON ; `details` stocke variants/options/published_at.

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