# `podcastindex` — connecteur enrichissement (palier 2)

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.

État : prêt — clés requises · Famille : enrichissement (enrichment) · Backend : direct · Créateurs découverts : 0 · touchés : 0

# Description de la source

Connecteur ENRICHISSEMENT « podcastindex » — API Podcast Index (OFFICIELLE, gratuite ; clé + secret requis, inscription gratuite : https://api.podcastindex.org). Palier 2 (§9, §10). Sans clés : passage sauté PROPREMENT (SkipSource, comme twitch).

Notes (registre) : episodeCount, lastUpdateTime, itunesId, image, catégories des balados par feed_url. En attendant les clés, balados-rss couvre les mêmes champs sans clé.
Signal d'identité : api_officielle (0.95) (colonne accounts.signal / confidence)
Module : creaka/connectors/podcastindex.py — classe PodcastIndexConnector (kind = "enrichment")

# Accès

Accès (registre) : API Podcast Index (officielle, GRATUITE — inscription requise : https://api.podcastindex.org ; PODCASTINDEX_API_KEY/SECRET dans .env) — sauté proprement sans clés
Type d'accès (code) : API JSON
Endpoint de base : https://api.podcastindex.org/api/1.0/podcasts/byfeedurl
URLs du module : https://api.podcastindex.org · https://api.podcastindex.org/api/1.0/podcasts/byfeedurl
Pagination : réponse unique (pas de pagination)
Backend anti-bot / rendu : requests direct (session UA CreaKaBot, throttling poli)
Politesse : 0.4 s entre requêtes, timeout 30 s, UA CreaKaBot/1.0 (+https://www.crea-ka.com/bot)
Authentification : clé(s) API requise(s) — voir statut/registre

# Champs récupérés → schéma cible

Cible d'enrichissement : colonnes de la table accounts pour la/les plateforme(s) podcast (462 comptes en BD, confiance moyenne 0.98).

Colonne `accounts`	Contenu	Renseignée	Exemple réel
`handle`	Handle	100 %	—
`url`	URL du profil	100 %	—
`followers`	Abonnés	0 %	—
`verified`	Badge vérifié	0 %	—
`confidence`	Confiance d'identité	100 %	—
`signal`	Signal d'identité	100 %	—
`metrics`	Métriques détaillées (JSON)	100 %	—
`last_checked`	Dernière vérification	100 %	—

# Fréquence & budget

Cadence déclarée (registre) : quotidienne (watch), re-visite 7 j par balado
Cadence observée (médiane sync_log) : —
Throttling : 0.4 s entre requêtes (request_delay)

# Volumétrie & complétude

Créateurs découverts par la source (doc.source) : 0 · fiches touchées (source_ids) : 0
Comptes podcast en BD : 462 — abonnés 0 % · métriques 100 % · dernière vérification 2026-08-18T20:11:39Z
Runs journalisés (60 derniers) : 0, dont 0 avec erreurs

# Erreurs connues & dépannage

Aucune erreur ni alerte dans les 60 derniers runs journalisés.

Statut du registre : prêt — clés requises

Rejouer la source seule : python3 run.py sync podcastindex · vérifier sync_log (SELECT * FROM sync_log WHERE source='podcastindex' ORDER BY ts DESC LIMIT 5;).

# Licence, attribution & conditions

Cadre d'accès (registre) : API Podcast Index (officielle, GRATUITE — inscription requise : https://api.podcastindex.org ; PODCASTINDEX_API_KEY/SECRET dans .env) — sauté proprement sans clés
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).
Retrait sur demande : contact@spboucher.ai (opt-out honoré à la prochaine ingestion).

# Historique

2026-08-18 — vague d'enrichissement : standardisation de la documentation des connecteurs (fiche générée par scripts/gen_connector_docs.py).

# podcastindex — connecteur enrichissement (palier 2)