spb/crea-ka

1# `twitch-decouverte` — connecteur decouverte (palier 3)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 : direct · Créateurs découverts : 262 · touchés : 26267## Description de la source89Connecteur DÉCOUVERTE — streamers Twitch québécois via l'API GQL publique du site officiel (Client-ID public, sans clé) : recherche de chaînes par termes QC + répertoire des diffusions en français. Palier 3 (§9). Filtre conservateur : marqueur québécois OBLIGATOIRE dans le nom, la bio ou le titre du stream.1011- **Notes (registre)** : vague 4 — marqueur québécois OBLIGATOIRE dans nom/bio/titre du stream ; abonnés, avatar, partenaire/affilié, dernier direct et jeu captés à la source ; niche déduite du jeu (Just Chatting → lifestyle, Music → musique…)12- **Signal d'identité** : profil_source (0.98) — la chaîne est le compte d'origine de la fiche (colonne `accounts.signal` / `confidence`)13- **Module** : `creaka/connectors/twitch_decouverte.py` — classe `TwitchDecouverteConnector` (`kind = "discovery"`)1415## Accès1617- **Accès (registre)** : API GQL publique du site officiel de Twitch (Client-ID public web, sans clé) : recherche searchFor par ~43 termes QC paginée + répertoire des diffusions EN DIRECT en français (streams languages:[FR], 20 pages)18- **Type d'accès (code)** : pages HTML publiques19- **Endpoint de base** : —20- **Pagination** : curseur / continuation21- **Backend anti-bot / rendu** : requests direct (session UA CreaKaBot, throttling poli)22- **Politesse** : 1.0 s entre requêtes, timeout 30 s, UA `CreaKaBot/1.0 (+https://www.crea-ka.com/bot)`23- **Authentification** : clé(s) API requise(s) — voir statut/registre2425## Champs récupérés → schéma cible2627Source de **découverte** : produit des fiches `Creator` (tables `creators` + `accounts`). Complétude mesurée sur les 262 créateurs découverts par cette source (champ `doc.source`) ; exemple tiré d'une fiche réelle.2829| Champ du doc créateur | Contenu | Renseigné | Exemple réel |30|---|---|---|---|31| `display_name` | Nom public | 100 % | PlaqueBoyMax |32| `bio` | Bio | 55 % | for business inquiries: [retiré] |33| `region` | Région | 4 % | — |34| `city` | Ville | 4 % | — |35| `niches` | Niches (liste) | 100 % | lifestyle |36| `languages` | Langues (liste) | 100 % | fr |37| `creator_type` | Type de créateur | 100 % | streamer |38| `primary_platform` | Plateforme principale | 100 % | twitch |39| `platforms` | Comptes sociaux (liste) | 100 % | twitch:@plaqueboymax |40| `avatar_url` | Avatar | 100 % | https://static-cdn.jtvnw.net/jtv_user_pictures/14f0fcfd-00d4-4004-9379-93e0c6336f5e-profi… |41| `total_reach` | Portée totale (abonnés cumulés) | 74 % | 2841236 |42| `link_in_bio_url` | Lien-en-bio | 0 % | — |4344## Fréquence & budget4546- **Cadence déclarée (registre)** : quotidienne (watch) — qui est en direct change chaque jour, la couverture s'accumule47- **Cadence observée** (médiane sync_log) : —48- **Dernier passage** : 2026-08-18T14:33:13Z — 262 créateurs, 262 comptes, +262 / ~0, 0 erreur(s), 147 s49- **Throttling** : 1.0 s entre requêtes (`request_delay`)5051## Volumétrie & complétude5253- **Créateurs découverts par la source** (`doc.source`) : 262 · **fiches touchées** (`source_ids`) : 26254- **Complétude clé (découverts)** : niches 100 % · avatar 100 % · portée 74 % · région 4 %55- **Runs journalisés (60 derniers)** : 1, dont 0 avec erreurs5657## Erreurs connues & dépannage5859Aucune erreur ni alerte dans les 60 derniers runs journalisés.6061Rejouer la source seule : `python3 run.py sync twitch-decouverte` · vérifier `sync_log` (`SELECT * FROM sync_log WHERE source='twitch-decouverte' ORDER BY ts DESC LIMIT 5;`).6263## Licence, attribution & conditions6465- **Cadre d'accès (registre)** : API GQL publique du site officiel de Twitch (Client-ID public web, sans clé) : recherche searchFor par ~43 termes QC paginée + répertoire des diffusions EN DIRECT en français (streams languages:[FR], 20 pages)66- **API publique** utilisée selon ses conditions (pas de clé détournée, throttling poli) ; données limitées aux profils publics.67- Retrait sur demande : contact@spboucher.ai (opt-out honoré à la prochaine ingestion).6869## Historique7071- 2026-08-18 — plus ancien passage journalisé dans `sync_log` (fenêtre des 60 derniers).72- 2026-08-18 — vague d'enrichissement : standardisation de la documentation des connecteurs (fiche générée par `scripts/gen_connector_docs.py`).73