# `wikidata-qc` — 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 : 73 · touchés : 73

## Description de la source

Connecteur DÉCOUVERTE — créateurs québécois recensés dans Wikidata (personnes nées ou résidant au Québec, occupation créateur, avec handles sociaux curés P2003/P7085/P2397/P5797/P2002). Mode d'accès : API SPARQL publique de Wikidata (gratuite, conforme). Palier 3 (§9).

- **Notes (registre)** : humoristes, youtubeurs, vidéastes web, streamers, podcasteurs notables ; is_minor levé via l'année de naissance publique
- **Signal d'identité** : base_publique (0.85) (colonne `accounts.signal` / `confidence`)
- **Module** : `creaka/connectors/wikidata_qc.py` — classe `WikidataQcConnector` (`kind = "discovery"`)

## Accès

- **Accès (registre)** : API SPARQL publique Wikidata (nés/résidant au Québec, occupation créateur, handles sociaux curés)
- **Type d'accès (code)** : API SPARQL publique (Wikidata)
- **Endpoint de base** : https://query.wikidata.org/sparql
- **URLs du module** : https://query.wikidata.org/sparql · https://www.youtube.com/channel/{handle}
- **Pagination** : réponse unique (pas de pagination)
- **Backend anti-bot / rendu** : requests direct (session UA CreaKaBot, throttling poli)
- **Politesse** : 2.0 s entre requêtes, timeout 90 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

Source de **découverte** : produit des fiches `Creator` (tables `creators` + `accounts`). Complétude mesurée sur les 73 créateurs découverts par cette source (champ `doc.source`) ; exemple tiré d'une fiche réelle.

| Champ du doc créateur | Contenu | Renseigné | Exemple réel |
|---|---|---|---|
| `display_name` | Nom public | 100 % | Nigel Braun |
| `bio` | Bio | 78 % | Capturing the natural beauty of chemistry Find me on YouTube: @NileRed/@NileBlue |
| `region` | Région | 18 % | — |
| `city` | Ville | 18 % | — |
| `niches` | Niches (liste) | 100 % | lifestyle |
| `languages` | Langues (liste) | 100 % | fr |
| `creator_type` | Type de créateur | 100 % | influenceur |
| `primary_platform` | Plateforme principale | 100 % | youtube |
| `platforms` | Comptes sociaux (liste) | 99 % | youtube:@nilered, tiktok:@nilered, instagram:@nile.red |
| `avatar_url` | Avatar | 75 % | https://scontent-yyz1-1.cdninstagram.com/v/t51.2885-19/441008830_1124225362150102_4410959… |
| `total_reach` | Portée totale (abonnés cumulés) | 67 % | 22759897 |
| `link_in_bio_url` | Lien-en-bio | 19 % | — |

## Fréquence & budget

- **Cadence déclarée (registre)** : hebdomadaire
- **Cadence observée** (médiane sync_log) : ≈ 32 min
- **Dernier passage** : 2026-08-18T10:36:26Z — 83 créateurs, 172 comptes, +0 / ~83, 0 erreur(s), 39 s
- **Throttling** : 2.0 s entre requêtes (`request_delay`)

## Volumétrie & complétude

- **Créateurs découverts par la source** (`doc.source`) : 73 · **fiches touchées** (`source_ids`) : 73
- **Complétude clé (découverts)** : niches 100 % · avatar 75 % · portée 67 % · région 18 %
- **Runs journalisés (60 derniers)** : 10, dont 1 avec erreurs

## Erreurs connues & dépannage

| Passage | Erreurs | Alerte (sync_log) |
|---|---|---|
| 2026-08-18T05:55:35Z | 1 | — |

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

## Licence, attribution & conditions

- **Cadre d'accès (registre)** : API SPARQL publique Wikidata (nés/résidant au Québec, occupation créateur, handles sociaux curés)
- **Licence** : données Wikidata sous CC0 — réutilisation libre, mention « Source : Wikidata » affichée par courtoisie.
- Retrait sur demande : contact@spboucher.ai (opt-out honoré à la prochaine ingestion).

## Historique

- 2026-08-17 — plus ancien passage journalisé dans `sync_log` (fenêtre des 60 derniers).
- 2026-08-18 — vague d'enrichissement : standardisation de la documentation des connecteurs (fiche générée par `scripts/gen_connector_docs.py`).