spb/crea-ka

1# `balados-itunes` — connecteur decouverte (palier 2)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 : 460 · touchés : 46067## Description de la source89Connecteur DÉCOUVERTE — balados québécois via l'API de recherche iTunes/Apple Podcasts (OFFICIELLE, gratuite, sans clé). Palier 2-3 (§9). Filtre conservateur : marqueur québécois requis dans le nom du balado ou de l'artiste.1011- **Notes (registre)** : podcasteurs québécois : nom, artiste, pochette, genre, nb d'épisodes, flux RSS ; marqueur QC requis12- **Signal d'identité** : profil_source (0.98) (colonne `accounts.signal` / `confidence`)13- **Module** : `creaka/connectors/balados_itunes.py` — classe `BaladosItunesConnector` (`kind = "discovery"`)1415## Accès1617- **Accès (registre)** : API de recherche iTunes/Apple Podcasts (officielle, gratuite, sans clé)18- **Type d'accès (code)** : API iTunes Search/Lookup (publique)19- **Endpoint de base** : https://itunes.apple.com/search20- **URLs du module** : https://itunes.apple.com/search21- **Pagination** : réponse unique (pas de pagination)22- **Backend anti-bot / rendu** : requests direct (session UA CreaKaBot, throttling poli)23- **Politesse** : 1.5 s entre requêtes, timeout 30 s, UA `CreaKaBot/1.0 (+https://www.crea-ka.com/bot)`24- **Authentification** : clé(s) API requise(s) — voir statut/registre2526## Champs récupérés → schéma cible2728Source de **découverte** : produit des fiches `Creator` (tables `creators` + `accounts`). Complétude mesurée sur les 460 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 % | Québec Nostalgie : le podcast |33| `bio` | Bio | 97 % | Fidèle à la page Instagram du même nom, Québec Nostalgie : le podcast est un véritable vo… |34| `region` | Région | 8 % | — |35| `city` | Ville | 8 % | — |36| `niches` | Niches (liste) | 100 % | actualite-opinion |37| `languages` | Langues (liste) | 100 % | fr |38| `creator_type` | Type de créateur | 100 % | podcasteur |39| `primary_platform` | Plateforme principale | 100 % | instagram |40| `platforms` | Comptes sociaux (liste) | 100 % | instagram:@quebec_nostalgie, youtube:@UC10F7nTroeQocT2vqf2LoIw, podcast:@1741442896 |41| `avatar_url` | Avatar | 100 % | https://is1-ssl.mzstatic.com/image/thumb/Podcasts211/v4/3a/5f/12/3a5f1256-74a6-f716-ffb8-… |42| `total_reach` | Portée totale (abonnés cumulés) | 1 % | 109741 |43| `link_in_bio_url` | Lien-en-bio | 0 % | https://linktr.ee/QuebecNostalgie |4445Cible d'**enrichissement** : colonnes de la table `accounts` pour la/les plateforme(s) `podcast` (462 comptes en BD, confiance moyenne 0.98).4647| Colonne `accounts` | Contenu | Renseignée | Exemple réel |48|---|---|---|---|49| `handle` | Handle | 100 % | — |50| `url` | URL du profil | 100 % | — |51| `followers` | Abonnés | 0 % | — |52| `verified` | Badge vérifié | 0 % | — |53| `confidence` | Confiance d'identité | 100 % | — |54| `signal` | Signal d'identité | 100 % | — |55| `metrics` | Métriques détaillées (JSON) | 100 % | — |56| `last_checked` | Dernière vérification | 100 % | — |5758## Fréquence & budget5960- **Cadence déclarée (registre)** : quotidienne (watch)61- **Cadence observée** (médiane sync_log) : ≈ 47 min62- **Dernier passage** : 2026-08-18T20:11:39Z — 460 créateurs, 460 comptes, +0 / ~460, 0 erreur(s), 224 s63- **Throttling** : 1.5 s entre requêtes (`request_delay`)6465## Volumétrie & complétude6667- **Créateurs découverts par la source** (`doc.source`) : 460 · **fiches touchées** (`source_ids`) : 46068- **Complétude clé (découverts)** : niches 100 % · avatar 100 % · portée 1 % · région 8 %69- **Comptes `podcast` en BD** : 462 — abonnés 0 % · métriques 100 % · dernière vérification 2026-08-18T20:11:39Z70- **Runs journalisés (60 derniers)** : 10, dont 0 avec erreurs7172## Erreurs connues & dépannage7374Aucune erreur ni alerte dans les 60 derniers runs journalisés.7576Rejouer la source seule : `python3 run.py sync balados-itunes` · vérifier `sync_log` (`SELECT * FROM sync_log WHERE source='balados-itunes' ORDER BY ts DESC LIMIT 5;`).7778## Licence, attribution & conditions7980- **Cadre d'accès (registre)** : API de recherche iTunes/Apple Podcasts (officielle, gratuite, sans clé)81- **API publique** utilisée selon ses conditions (pas de clé détournée, throttling poli) ; données limitées aux profils publics.82- Retrait sur demande : contact@spboucher.ai (opt-out honoré à la prochaine ingestion).8384## Historique8586- 2026-08-17 — plus ancien passage journalisé dans `sync_log` (fenêtre des 60 derniers).87- 2026-08-18 — vague d'enrichissement : standardisation de la documentation des connecteurs (fiche générée par `scripts/gen_connector_docs.py`).88