SPB Git forge

spb/crea-ka

Public

Créa·Ka — annuaire public cross-plateforme des créateurs de contenu québécois (crea-ka.com)

52commits 1branches 0releases
11.3 MBsize
maindefault branch
19 days agolast push
Python 73.6% HTML 13.2% TypeScript 6% JavaScript 4.5% CSS 1.7% Dockerfile 0.6%
4.3 KB · 76 lines markdown
Rendered Raw Blame History
1# `balados-rss` — connecteur enrichissement (palier 1)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 : enrichissement (enrichment) · Backend : direct · Créateurs découverts : 0 · touchés : 067## Description de la source89Connecteur ENRICHISSEMENT « balados-rss » — lecture directe des flux RSS auto-déclarés des balados (AUCUNE clé requise). Palier 1 (§9). Cap 150 flux/passage, re-visite 7 j, timeout court, fetch parallèle poli (les flux vivent presque tous sur des hôtes différents).1011- **Notes (registre)** : nb d'épisodes réels, date du dernier épisode (détection dormant >12 mois), pochette → avatar, description → bio, catégories iTunes → niches, <link> → compte site-web/plateforme. Substitut sans clé de Podcast Index.12- **Signal d'identité** : cross_link (0.90) pour le lien officiel <link> du flux (colonne `accounts.signal` / `confidence`)13- **Module** : `creaka/connectors/balados_rss.py` — classe `BaladosRssConnector` (`kind = "enrichment"`)1415## Accès1617- **Accès (registre)** : requêtes directes (flux RSS auto-déclarés des balados — AUCUNE clé) ; cap 150 flux/passage, re-visite 7 j, timeout court, fetch parallèle poli18- **Type d'accès (code)** : flux RSS publics19- **Endpoint de base** : http://www.itunes.com/dtds/podcast-1.0.dtd}20- **URLs du module** : http://www.itunes.com/dtds/podcast-1.0.dtd}21- **Pagination** : réponse unique (pas de pagination)22- **Backend anti-bot / rendu** : requests direct (session UA CreaKaBot, throttling poli)23- **Politesse** : 0.2 s entre requêtes, timeout 12 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) — rotation complète des 433 balados en ~3 jours, puis hebdomadaire44- **Cadence observée** (médiane sync_log) : ≈ 3.6 h45- **Dernier passage** : 2026-08-18T13:48:02Z — 8 créateurs, 36 comptes, +0 / ~8, 5 erreur(s), 12 s46- **Throttling** : 0.2 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)** : 6, dont 5 avec erreurs5354## Erreurs connues & dépannage5556| Passage | Erreurs | Alerte (sync_log) |57|---|---|---|58| 2026-08-18T13:48:02Z | 5 | — |59| 2026-08-18T09:55:43Z | 5 | — |60| 2026-08-18T06:17:19Z | 5 | — |61| 2026-08-18T06:17:07Z | 5 | — |62| 2026-08-18T06:16:42Z | 5 | — |6364Rejouer la source seule : `python3 run.py sync balados-rss` · vérifier `sync_log` (`SELECT * FROM sync_log WHERE source='balados-rss' ORDER BY ts DESC LIMIT 5;`).6566## Licence, attribution & conditions6768- **Cadre d'accès (registre)** : requêtes directes (flux RSS auto-déclarés des balados — AUCUNE clé) ; cap 150 flux/passage, re-visite 7 j, timeout court, fetch parallèle poli69- **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`).70- Retrait sur demande : contact@spboucher.ai (opt-out honoré à la prochaine ingestion).7172## Historique7374- 2026-08-18 — plus ancien passage journalisé dans `sync_log` (fenêtre des 60 derniers).75- 2026-08-18 — vague d'enrichissement : standardisation de la documentation des connecteurs (fiche générée par `scripts/gen_connector_docs.py`).76