spb/crea-ka

1# `kick-decouverte` — connecteur decouverte (palier 4)23_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._45**État : actif** · Famille : decouverte (discovery) · Backend : Scrapfly · Créateurs découverts : 119 · touchés : 11967## Description de la source89Connecteur DÉCOUVERTE — streamers Kick québécois via l'API publique de recherche du site (kick.com/api/search) + fiche v2 par chaîne (liens sociaux AUTO-DÉCLARÉS par le créateur → cross_link 0.90). Mode d'accès : Scrapfly ASP sans render_js (Cloudflare bloque les requêtes directes — 403). Palier 4 (§9/§10).1011- **Notes (registre)** : vague 4 — marqueur québécois requis dans pseudo/slug/bio ; la fiche v2 expose les liens sociaux remplis par le créateur lui-même : meilleure matière première du rattachement §12.112- **Signal d'identité** : profil_source (0.98) pour la chaîne Kick ; cross_link (0.90) pour les liens sociaux AUTO-DÉCLARÉS du profil v2 (instagram/x/youtube/tiktok/facebook/discord) (colonne `accounts.signal` / `confidence`)13- **Module** : `creaka/connectors/kick_decouverte.py` — classe `KickDecouverteConnector` (`kind = "discovery"`)1415## Accès1617- **Accès (registre)** : Scrapfly ASP sans render_js (Cloudflare bloque le direct) : kick.com/api/search par ~27 termes QC + fiche v2 par chaîne retenue (cap 120/passage — budget Scrapfly)18- **Type d'accès (code)** : pages HTML publiques19- **Endpoint de base** : https://kick.com/api/search?searched_word={term}20- **URLs du module** : https://kick.com/api/search?searched_word={term} · https://kick.com/api/v2/channels/{slug}21- **Pagination** : réponse unique (pas de pagination)22- **Backend anti-bot / rendu** : Scrapfly (asp + render_js — contournement anti-bot)23- **Politesse** : 1.5 s entre requêtes, timeout 30 s, UA `CreaKaBot/1.0 (+https://www.crea-ka.com/bot)`24- **Authentification** : aucune — contenu public / API anonyme2526## Champs récupérés → schéma cible2728Source de **découverte** : produit des fiches `Creator` (tables `creators` + `accounts`). Complétude mesurée sur les 119 créateurs découverts par cette source (champ `doc.source`) ; exemple tiré d'une fiche réelle.2930| Champ du doc créateur | Contenu | Renseigné | Exemple réel |31|---|---|---|---|32| `display_name` | Nom public | 100 % | juandemontreal |33| `bio` | Bio | 28 % | Gracias por seguirme hasta aqui tmb............ |34| `region` | Région | 0 % | — |35| `city` | Ville | 0 % | — |36| `niches` | Niches (liste) | 100 % | gaming |37| `languages` | Langues (liste) | 100 % | fr |38| `creator_type` | Type de créateur | 100 % | streamer |39| `primary_platform` | Plateforme principale | 100 % | tiktok |40| `platforms` | Comptes sociaux (liste) | 100 % | tiktok:@juandemontrealoficial, instagram:@juandemontreal, kick:@juandemontreal |41| `avatar_url` | Avatar | 40 % | https://files.kick.com/images/user/36432333/profile_image/conversion/2e63a30c-e041-4915-9… |42| `total_reach` | Portée totale (abonnés cumulés) | 56 % | 23455724 |43| `link_in_bio_url` | Lien-en-bio | 0 % | — |4445## Fréquence & budget4647- **Cadence déclarée (registre)** : quotidienne (watch)48- **Cadence observée** (médiane sync_log) : —49- **Dernier passage** : 2026-08-18T14:42:46Z — 120 créateurs, 188 comptes, +119 / ~1, 0 erreur(s), 573 s50- **Throttling** : 1.5 s entre requêtes (`request_delay`)5152## Volumétrie & complétude5354- **Créateurs découverts par la source** (`doc.source`) : 119 · **fiches touchées** (`source_ids`) : 11955- **Complétude clé (découverts)** : niches 100 % · avatar 40 % · portée 56 % · région 0 %56- **Runs journalisés (60 derniers)** : 1, dont 0 avec erreurs5758## Erreurs connues & dépannage5960Aucune erreur ni alerte dans les 60 derniers runs journalisés.6162Rejouer la source seule : `python3 run.py sync kick-decouverte` · vérifier `sync_log` (`SELECT * FROM sync_log WHERE source='kick-decouverte' ORDER BY ts DESC LIMIT 5;`).6364## Licence, attribution & conditions6566- **Cadre d'accès (registre)** : Scrapfly ASP sans render_js (Cloudflare bloque le direct) : kick.com/api/search par ~27 termes QC + fiche v2 par chaîne retenue (cap 120/passage — budget Scrapfly)67- **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`).68- Retrait sur demande : contact@spboucher.ai (opt-out honoré à la prochaine ingestion).6970## Historique7172- 2026-08-18 — plus ancien passage journalisé dans `sync_log` (fenêtre des 60 derniers).73- 2026-08-18 — vague d'enrichissement : standardisation de la documentation des connecteurs (fiche générée par `scripts/gen_connector_docs.py`).74