spb/crea-ka

1# `palmares-apple` — 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 : 0 · touchés : 067## Description de la source89Connecteur DÉCOUVERTE — balados québécois dans le TOP 100 canadien d'Apple Podcasts. Mode d'accès : API marketing officielle d'Apple (rss.marketingtools.apple.com, gratuite, sans clé) + lookup iTunes groupé + tête de flux RSS pour l'attribution QC. Palier 2 (§9). V3.1011- **Notes (registre)** : vague 3 — balados QC qui percent dans le top 100 CA (metrics.chart_rank_ca). Palmarès évalués 2026-08-18 : Spotify podcastcharts → API morte (HTTP 500) ; ADISQ → SPA JavaScript + artistes sans liens sociaux ; Bible urbaine → articles en prose sans handles (liaison ambiguë interdite §12) → Apple retenu. Fusion naturelle avec balados-itunes (même clé podcast:collectionId)12- **Signal d'identité** : profil_source (0.98) (colonne `accounts.signal` / `confidence`)13- **Module** : `creaka/connectors/palmares_apple.py` — classe `PalmaresAppleConnector` (`kind = "discovery"`)1415## Accès1617- **Accès (registre)** : API marketing OFFICIELLE d'Apple (rss.marketingtools.apple.com, top 100 podcasts Canada, sans clé) + lookup iTunes groupé + tête de flux RSS pour l'attribution QC18- **Type d'accès (code)** : API iTunes Search/Lookup (publique)19- **Endpoint de base** : https://itunes.apple.com/lookup20- **URLs du module** : https://rss.marketingtools.apple.com/api/v2/ca/podcasts/ · https://itunes.apple.com/lookup21- **Pagination** : réponse unique (pas de pagination)22- **Backend anti-bot / rendu** : requests direct (session UA CreaKaBot, throttling poli)23- **Politesse** : 1.0 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 cible2728Cible d'**enrichissement** : colonnes de la table `accounts` pour la/les plateforme(s) `podcast` (462 comptes en BD, confiance moyenne 0.98).2930| Colonne `accounts` | Contenu | Renseignée | Exemple réel |31|---|---|---|---|32| `handle` | Handle | 100 % | — |33| `url` | URL du profil | 100 % | — |34| `followers` | Abonnés | 0 % | — |35| `verified` | Badge vérifié | 0 % | — |36| `confidence` | Confiance d'identité | 100 % | — |37| `signal` | Signal d'identité | 100 % | — |38| `metrics` | Métriques détaillées (JSON) | 100 % | — |39| `last_checked` | Dernière vérification | 100 % | — |4041## Fréquence & budget4243- **Cadence déclarée (registre)** : quotidienne (watch) — le palmarès bouge chaque jour44- **Cadence observée** (médiane sync_log) : ≈ 21 min45- **Dernier passage** : 2026-08-18T10:35:47Z — 0 créateurs, 0 comptes, +0 / ~0, 0 erreur(s), 209 s46- **Throttling** : 1.0 s entre requêtes (`request_delay`)4748## Volumétrie & complétude4950- **Créateurs découverts par la source** (`doc.source`) : 0 · **fiches touchées** (`source_ids`) : 051- **Comptes `podcast` en BD** : 462 — abonnés 0 % · métriques 100 % · dernière vérification 2026-08-18T20:11:39Z52- **Runs journalisés (60 derniers)** : 3, dont 0 avec erreurs5354## Erreurs connues & dépannage5556| Passage | Erreurs | Alerte (sync_log) |57|---|---|---|58| 2026-08-18T10:35:47Z | 0 | 0 créateur retourné — source possiblement bloquée |59| 2026-08-18T09:58:54Z | 0 | 0 créateur retourné — source possiblement bloquée |6061Rejouer la source seule : `python3 run.py sync palmares-apple` · vérifier `sync_log` (`SELECT * FROM sync_log WHERE source='palmares-apple' ORDER BY ts DESC LIMIT 5;`).6263## Licence, attribution & conditions6465- **Cadre d'accès (registre)** : API marketing OFFICIELLE d'Apple (rss.marketingtools.apple.com, top 100 podcasts Canada, sans clé) + lookup iTunes groupé + tête de flux RSS pour l'attribution QC66- **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 — date mentionnée au registre (voir notes/statut).72- 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