# `tavily-seed` — connecteur decouverte (palier 3)

_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 : actif** · Famille : decouverte (discovery) · Backend : direct · Créateurs découverts : 0 · touchés : 0

## Description de la source

Connecteur DÉCOUVERTE à grande échelle — graines de créateurs québécois moissonnées par le Tavily scout (outils/creator-harvest.py du dépôt groupe-ka-connecteurs) : handles sociaux extraits des pages d'annuaires/palmarès/agences QC. Dataset local (aucune requête ici) : data/seed/qc_creator_seeds.jsonl. L'enrichissement (Apify) vérifie ensuite l'existence et remplit nom/abonnés/contenu.

- **Notes (registre)** : expansion massive du bassin ; existence vérifiée ensuite par lenrichissement Apify
- **Signal d'identité** : listes_medias (0.85) (colonne `accounts.signal` / `confidence`)
- **Module** : `creaka/connectors/tavily_seed.py` — classe `TavilySeedConnector` (`kind = "discovery"`)

## Accès

- **Accès (registre)** : dataset local moissonné par le Tavily scout (outils/creator-harvest.py) : handles extraits des annuaires/palmarès/agences QC
- **Type d'accès (code)** : dataset local compilé (data/seed)
- **Endpoint de base** : —
- **Pagination** : réponse unique (pas de pagination)
- **Backend anti-bot / rendu** : requests direct
- **Politesse** : 0.8 s entre requêtes, timeout 30 s, UA `CreaKaBot/1.0 (+https://www.crea-ka.com/bot)`
- **Authentification** : aucune — contenu public / API anonyme

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

Aucune donnée attribuable à cette source en BD pour l'instant (clés manquantes ou source en attente) — schéma cible : `creators` + `accounts`.

## Fréquence & budget

- **Cadence déclarée (registre)** : par vague (re-moisson périodique)
- **Cadence observée** (médiane sync_log) : —
- **Throttling** : 0.8 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
- **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.

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

## Licence, attribution & conditions

- **Cadre d'accès (registre)** : dataset local moissonné par le Tavily scout (outils/creator-harvest.py) : handles extraits des annuaires/palmarès/agences QC
- **Données compilées** de listes et palmarès médias **publics** ; seuls des faits publics (nom, handle, audience approximative) sont conservés.
- 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`).