Spécifications — Scripts d'automatisation CEBTG

Infrastructure générale

• Notion — CMS et bases de données
• kDrive Infomaniak — stockage des fichiers PDF
• kCalendar Infomaniak — calendrier des cours (CalDAV)
• Bullet.so — publication web (tibetain.cebtg.ch)
• Tally Pro — formulaires d'inscription
• YouTube — replays des cours (chaîne @falcolito)
• Anthropic API — génération des résumés automatiques (Claude)
• Webshare — proxy résidentiel rotatif (contournement blocage YouTube)

Environnement d'exécution

source ~/venv-cebtg/bin/activate

~/Documents/MesScripts/kDrive - Notion/

pip install yt-dlp requests anthropic youtube-transcript-api

{
  "notion": {
    "token": "secret_...",
    "db_replays_youtube": "740058cf0fa1470cb93e4de1c43d0efb",
    "db_ressources": "90340df9fcbb480f80d86b7b7c473dc3"
  },
  "anthropic": {
    "api_key": "sk-ant-..."
  },
  "options": {
    "dry_run": true,
    "log_file": "sync_local_ftp_notion.log",
    "log_file_youtube": "sync_youtube_notion.log",
    "log_file_summaries": "sync_youtube_summaries.log",
    "miniature_largeur_px": 400,
    "caldav_horizon_jours": 90
  }
}

Bases de données Notion

Script 1 — sync_local_ftp_notion.py

cd ~/Documents/MesScripts/kDrive\ -\ Notion
source ~/venv-cebtg/bin/activate

# ✅ CAS HABITUEL — ajout de nouveaux PDFs (ignore les 250 déjà dans Notion)
python3 sync_local_ftp_notion.py --sync --new-only

# ✅ CAS HABITUEL — un seul PDF précis
python3 sync_local_ftp_notion.py --sync --file Tib1/2025-2026/sujet/lecon-06.pdf

# Simulation préalable (sans --sync) — voir ce qui serait traité
python3 sync_local_ftp_notion.py --new-only

# Sync complète (tous les PDFs — MET À JOUR les existants aussi — lent, ~20-30 min)
python3 sync_local_ftp_notion.py --sync

# Test de connexion FTP uniquement
python3 sync_local_ftp_notion.py --ftp-test

• dry_run: true dans config.json → le script simule sans rien modifier (recommandé par défaut)
• L'option --sync est toujours nécessaire pour une exécution réelle
• L'option --new-only est indépendante : elle filtre les PDFs déjà présents dans Notion, quelle que soit la présence de --sync
• ⚠️ Erreur fréquente : --new-only seul (sans --sync) = simulation uniquement des nouveaux. Il faut toujours combiner --sync --new-only pour le workflow quotidien.

• Lit les PDFs dans /Users/jm/kDrive/Cours de tibétain/Tibétain/
• Les uploade sur le FTP Infomaniak (579j3l.ftp.infomaniak.com, user 579j3l_cebtg_jm) vers sites/cebtg.ch/cours/
• Génère une miniature PNG de la première page via PyMuPDF
• Crée ou met à jour la fiche dans Ressources Pédagogiques (pivot : kDrive Path)
• URL publique des PDFs : https://cebtg.ch/cours/TibX/AAAA-AAAA/sujet/lecon-NN.pdf

Tibétain/
  Tib1/
    2021-2022/
      tchenrezi-1/
    2025-2026/
      dakayeshe/
      bodhicaryavatara/
  Tib2/
    2022-2023/
      sutra-du-coeur/
    2023-2024/
      sutra-pousse-de-riz-1/
    2024-2025/
      sutra-pousse-de-riz-2/
    2025-2026/
      sutra-pousse-de-riz-3/
  Tib3/
    2023-2024/
      sangtcheu-meunlam-1/

1. Créer le dossier sur le Mac : Tibétain/TibX/AAAA-AAAA/nom-du-sujet/
2. Attendre la synchronisation kDrive
3. Déposer les PDFs dans ce dossier
4. Lancer python3 sync_local_ftp_notion.py --sync --new-only

Script 2 — sync_caldav_notion.py

1. Aller sur github.com/falco36/cebtg-scripts
2. Onglet Actions → Sync CalDAV Notion
3. Bouton Run workflow → Run workflow (vert)

cd ~/Documents/MesScripts/kDrive\ -\ Notion
source ~/venv-cebtg/bin/activate
python3 sync_caldav_notion.py --dry-run   # simulation
python3 sync_caldav_notion.py             # sync réelle

• ICS_URL — URL export ICS kCalendar Infomaniak
• NOTION_TOKEN — token API Notion
• NOTION_DB_COURS_A_VENIR — ID base Cours à venir
• FTP_HOST / FTP_USER / FTP_PASS / FTP_REMOTE_BASE — accès FTP Infomaniak

• Télécharge le calendrier ICS depuis Infomaniak
• Détecte les cours dans les 90 prochains jours
• Crée ou met à jour les fiches dans "Cours à venir" (pivot : CalDAV UID)
• Archive les fiches des cours disparus du calendrier
• Génère et uploade agenda.html sur le FTP Infomaniak

Script 3 — sync_youtube_notion.py

cd ~/Documents/MesScripts/kDrive\ -\ Notion
source ~/venv-cebtg/bin/activate

# ✅ CAS HABITUEL — une seule nouvelle vidéo (quelques secondes)
python3 sync_youtube_notion.py --video VIDEO_ID

# Nouvelles vidéos uniquement — ignore les 323 existantes (rapide)
python3 sync_youtube_notion.py --new-only

# Simulation sans écriture
python3 sync_youtube_notion.py --dry-run

# Sync complète de toutes les playlists (rare — ~15-20 min)
python3 sync_youtube_notion.py

• Si une fiche a déjà un bloc vidéo embarquée → le corps n'est pas réécrit
• Utilise Video ID comme pivot (pas de doublons)
• Parse la date depuis le titre YouTube ("le 08.04.26")
• Déduit l'année scolaire depuis la date

Script 4 — sync_youtube_summaries.py

cd ~/Documents/MesScripts/kDrive\ -\ Notion
source ~/venv-cebtg/bin/activate
python3 sync_youtube_summaries.py                    # toutes les vidéos récentes (6 mois)
python3 sync_youtube_summaries.py --dry-run          # simulation sans écriture
python3 sync_youtube_summaries.py --force            # réécrire les résumés existants
python3 sync_youtube_summaries.py --video VIDEO_ID   # une seule vidéo

• Filtre les fiches Notion des 6 derniers mois sans résumé
• Extrait les sous-titres automatiques YouTube via youtube-transcript-api
• Utilise le proxy Webshare résidentiel rotatif pour contourner les blocages YouTube
• Envoie le transcript (~7000 mots) à l'API Claude Anthropic avec un prompt pédagogique
• Insère le résumé dans la fiche Notion sous forme de callout (brun)

Bonjour,

Écrit l'embed vidéo YouTube dans le corps de chaque page Notion

Dans cette leçon… (10-15 lignes pédagogiques)

Pour ajouter une nouvelle playlist : modifier la liste PLAYLISTS dans le script (ligne ~37).

Bon replay et bonne étude !

Si vous souhaitez recevoir les supports PDF de cette leçon, merci de vous inscrire. [lien vers /inscription/]

• Host : p.webshare.io, Port : 80
• Rotation automatique parmi 10 proxies résidentiels
• Compte : lxgnpjsa / voir config.json
• En cas de blocage persistant : attendre quelques heures et relancer

• Clé API Anthropic dans config.json → champ anthropic.api_key
• Crédit API Anthropic approvisionné (console.anthropic.com)

Script 5 — populate_sujet_relation.py

• Après la création d'un nouveau sujet dans la base Sujets (renseigner sa Clé Chapitre/Section d'abord)
• Après l'ajout de nouvelles leçons via Script 1 pour un sujet existant
• Après correction d'un champ Chapitre/Section (utiliser --force)

cd ~/Documents/MesScripts/kDrive\ -\ Notion
source ~/venv-cebtg/bin/activate
python populate_sujet_relation.py --dry-run  # simulation — affiche ce qui sera fait
python populate_sujet_relation.py             # exécution réelle
python populate_sujet_relation.py --force     # écrase les relations déjà renseignées

• Compare Chapitre/Section (Ressources) avec Clé Chapitre/Section (Sujets)
• Remplit la relation Sujet dans chaque fiche Ressource correspondante
• Le rollup Nombre de leçons se met à jour automatiquement dans Notion
• Ne touche pas aux fiches déjà reliées sauf si --force

Make.com — Automatisation segments Bullet

curl -X POST https://hook.eu2.make.com/9g5lhui4lebgncwy9wjh4rm2k11ic66k \
  -H "Content-Type: application/json" \
  -d '{"type":"checkout.session.completed","data":{"object":{"metadata":{"segment":"NOM_DU_SEGMENT"},"customer_details":{"email":"EMAIL_DE_TEST"}}}}'

Webhook — bullet-webhook.php

• Détecte les payloads de vérification Bullet (name = "testURL") → répond 200 OK sans toucher Notion
• Pour un vrai événement : cherche le contact par email dans Contacts JM
• Si trouvé : met à jour Tib niveau, Cours/Stages, Soutien, Dernière interaction
• Si nouveau contact : crée la fiche complète

GitHub Actions — Pistes pour la suite

• Script 3 sync_youtube_notion.py — que des appels API YouTube + Notion → parfait pour GitHub Actions. Déclenchement hebdomadaire ou manuel après chaque replay publié.
• Script 4 sync_youtube_summaries.py — idem, API Anthropic + Notion → adaptable. Penser à surveiller la consommation API Anthropic.
• Script 1 sync_local_ftp_notion.py — lit les fichiers locaux kDrive → restera sur Mac (GitHub Actions n'a pas accès au disque local).

Workflow après chaque séance

1. YouTube publie la vidéo
2. python3 sync_youtube_notion.py → sync la nouvelle fiche (30 sec)
3. python3 sync_youtube_summaries.py → génère le résumé automatique (30 sec)
4. Publish dans Bullet → la fiche apparaît sur le site avec vidéo + résumé

Workflow après chaque PDF

1. Déposer le PDF dans kDrive (/Tibétain/TibX/AAAA-AAAA/sujet/)
2. python3 sync_local_ftp_notion.py --sync --new-only → upload FTP + création fiche Notion (ignore les PDFs déjà synchronisés)
3. Publish dans Bullet