# `snowball-ig` — connecteur decouverte (palier 1)

_Fiche générée automatiquement par `scripts/gen_connector_docs.py` le 2026-08-18 16:14 — ne pas éditer à la main, régénérer._

**État : actif** · Famille : decouverte (enrichment) · Backend : direct · Créateurs découverts : 0 · touchés : 0

## Description de la source

Connecteur DÉCOUVERTE par boule de neige — exploite les profils reliés (`related_profiles`) captés par l'enrichissement Instagram (instagram-apify) pour créer de nouvelles fiches. C'est le levier d'échelle : chaque profil IG suggère ~10-20 comptes similaires → parcours en largeur qui fait croître le bassin de dizaines de milliers au fil des vagues quotidiennes. Aucune requête réseau (lit la base).

- **Notes (registre)** : levier déchelle : chaque profil IG suggère ~10-20 comptes similaires
- **Signal d'identité** : mention (0.60) — à confirmer par enrichissement (colonne `accounts.signal` / `confidence`)
- **Module** : `creaka/connectors/snowball.py` — classe `SnowballConnector` (`kind = "enrichment"`)

## Accès

- **Accès (registre)** : base interne : profils reliés Instagram (related_profiles) captés par instagram-apify
- **Type d'accès (code)** : pages HTML publiques
- **Endpoint de base** : —
- **Pagination** : réponse unique (pas de pagination)
- **Backend anti-bot / rendu** : requests direct
- **Politesse** : 0.8 s entre requêtes, timeout 30 s, UA `CreaKaBot/1.0 (+https://www.crea-ka.com/bot)`
- **Authentification** : aucune — contenu public / API anonyme

## Champs récupérés → schéma cible

Aucune donnée attribuable à cette source en BD pour l'instant (clés manquantes ou source en attente) — schéma cible : `creators` + `accounts`.

## Fréquence & budget

- **Cadence déclarée (registre)** : quotidienne (parcours en largeur, cap 4000/vague)
- **Cadence observée** (médiane sync_log) : —
- **Throttling** : 0.8 s entre requêtes (`request_delay`)

## Volumétrie & complétude

- **Créateurs découverts par la source** (`doc.source`) : 0 · **fiches touchées** (`source_ids`) : 0
- **Runs journalisés (60 derniers)** : 0, dont 0 avec erreurs

## Erreurs connues & dépannage

Aucune erreur ni alerte dans les 60 derniers runs journalisés.

Rejouer la source seule : `python3 run.py sync snowball-ig` · vérifier `sync_log` (`SELECT * FROM sync_log WHERE source='snowball-ig' ORDER BY ts DESC LIMIT 5;`).

## Licence, attribution & conditions

- **Cadre d'accès (registre)** : base interne : profils reliés Instagram (related_profiles) captés par instagram-apify
- **Profils publics uniquement** : UA identifiable `CreaKaBot/1.0 (+https://www.crea-ka.com/bot; contact@spboucher.ai)`, throttling poli, respect des opt-out (`data/optout.json`) et du volet éthique (`creaka/ethics.py` — mineurs exclus via `is_minor`).
- Retrait sur demande : contact@spboucher.ai (opt-out honoré à la prochaine ingestion).

## Historique

- 2026-08-18 — vague d'enrichissement : standardisation de la documentation des connecteurs (fiche générée par `scripts/gen_connector_docs.py`).