spb/crea-ka

1# `x-profil` — connecteur enrichissement (palier 3)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 « x-profil » — abonnés X (Twitter) SANS clé via le service public de syndication (widgets d'intégration officiels) syndication.twitter.com/srv/timeline-profile/screen-name/{handle}, repli page publique x.com/{handle}. Palier 3 (§9). Facebook sondé aussi : page publique bloquée sans clé (HTTP 400) → aucune voie fiable, on passe (documenté dans data/sources.json).1011- **Notes (registre)** : abonnés + abonnements + badge + avatar X. Ancien widget followbutton MORT (vérifié 2026-08-18 : réponse vide) ; page x.com : mur de connexion après ~15-20 req/IP (constaté 2026-08-18) → repli seulement. Facebook : page publique bloquée sans clé (HTTP 400, vérifié 2026-08-18) et Scrapfly non justifié → aucune voie fiable, on passe.12- **Signal d'identité** : aucun nouveau rattachement — métriques du compte déjà rattaché seulement (colonne `accounts.signal` / `confidence`)13- **Module** : `creaka/connectors/x_profil.py` — classe `XProfilConnector` (`kind = "enrichment"`)1415## Accès1617- **Accès (registre)** : requêtes directes (service public de syndication des widgets officiels : syndication.twitter.com/srv/timeline-profile — objet user complet dans __NEXT_DATA__ ; repli très limité page x.com) ; cap 150/passage, re-visite 7 j, délai 2 s18- **Type d'accès (code)** : pages HTML publiques19- **Endpoint de base** : https://syndication.twitter.com/srv/timeline-profile/20- **URLs du module** : https://syndication.twitter.com/srv/timeline-profile/ · https://x.com/{h}21- **Pagination** : réponse unique (pas de pagination)22- **Backend anti-bot / rendu** : requests direct23- **Politesse** : 2.0 s entre requêtes, timeout 15 s, UA `CreaKaBot/1.0 (+https://www.crea-ka.com/bot)`24- **Authentification** : aucune — contenu public / API anonyme2526## Champs récupérés → schéma cible2728Cible d'**enrichissement** : colonnes de la table `accounts` pour la/les plateforme(s) `x` (228 comptes en BD, confiance moyenne 0.88).2930| Colonne `accounts` | Contenu | Renseignée | Exemple réel |31|---|---|---|---|32| `handle` | Handle | 100 % | xqc |33| `url` | URL du profil | 100 % | https://x.com/xqc |34| `followers` | Abonnés | 26 % | 1599135 |35| `verified` | Badge vérifié | 13 % | 1 |36| `confidence` | Confiance d'identité | 100 % | 0.9 |37| `signal` | Signal d'identité | 100 % | cross_link |38| `metrics` | Métriques détaillées (JSON) | 39 % | {"following": 526, "x_checked": "2026-08-18T06:14:55Z", "tweets": 4328, "location": "", "… |39| `last_checked` | Dernière vérification | 100 % | 2026-08-18T19:58:58Z |4041## Fréquence & budget4243- **Cadence déclarée (registre)** : quotidienne (watch), rotation hebdomadaire44- **Cadence observée** (médiane sync_log) : ≈ 3.7 h45- **Dernier passage** : 2026-08-18T17:27:39Z — 28 créateurs, 125 comptes, +0 / ~28, 122 erreur(s), 342 s46- **Throttling** : 2.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 `x` en BD** : 228 — abonnés 26 % · métriques 39 % · dernière vérification 2026-08-18T19:58:58Z52- **Runs journalisés (60 derniers)** : 6, dont 6 avec erreurs5354## Erreurs connues & dépannage5556| Passage | Erreurs | Alerte (sync_log) |57|---|---|---|58| 2026-08-18T17:27:39Z | 122 | — |59| 2026-08-18T13:47:50Z | 127 | — |60| 2026-08-18T09:55:31Z | 146 | — |61| 2026-08-18T06:15:49Z | 1 | — |62| 2026-08-18T06:12:35Z | 171 | — |6364Rejouer la source seule : `python3 run.py sync x-profil` · vérifier `sync_log` (`SELECT * FROM sync_log WHERE source='x-profil' ORDER BY ts DESC LIMIT 5;`).6566## Licence, attribution & conditions6768- **Cadre d'accès (registre)** : requêtes directes (service public de syndication des widgets officiels : syndication.twitter.com/srv/timeline-profile — objet user complet dans __NEXT_DATA__ ; repli très limité page x.com) ; cap 150/passage, re-visite 7 j, délai 2 s69- **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 — date mentionnée au registre (voir notes/statut).75- 2026-08-18 — plus ancien passage journalisé dans `sync_log` (fenêtre des 60 derniers).76- 2026-08-18 — vague d'enrichissement : standardisation de la documentation des connecteurs (fiche générée par `scripts/gen_connector_docs.py`).77