# YouTube Publisher Bot

> Studio de miniatures YouTube et robot de publication : générer, analyser, retoucher
> et publier des miniatures, puis mesurer leur impact réel sur le taux de clic.
> Tout est pilotable par un agent IA via un serveur MCP authentifié en OAuth 2.1.

## Ce que fait le produit

- **Publication YouTube** : envoi de vidéos, planification par créneaux récurrents,
  traitement en lot, suivi du quota API, statistiques par vidéo et par chaîne,
  gestion de plusieurs chaînes connectées.
- **Thumbnail Studio** : génération de miniatures par IA, import de la miniature
  d'une vidéo existante, templates par niche, éditeur avec versions, pinceau de
  masque, calques, outils (détourage, upscale, texte, format 9:16).
- **Analyse gratuite** : score global sur 100, sept sous-scores, points forts et
  faibles, suggestions rédigées comme des instructions d'édition, carte d'attention.
- **Identité de marque** : kits de marque, extraits de prompt, styles visuels
  clonés depuis n'importe quelle miniature YouTube.
- **Mesure** : tests A/B de miniatures sur une vidéo publiée, désignation
  automatique du gagnant, corrélation entre score prédit et CTR observé.

## Serveur MCP

- Endpoint : https://youtube.rapidocms.com/mcp (Streamable HTTP)
- Authentification : OAuth 2.1 avec enregistrement dynamique des clients.
  Chaque agent agit au nom d'un utilisateur réel ; aucune donnée n'est publique.

### Enchaînement recommandé

générer → analyser → éditer → attacher → publier → mesurer

1. `yt_generate_thumbnail`, `yt_extract_youtube_thumbnail` ou `yt_apply_template`
2. `yt_analyze_thumbnail` (gratuit), `yt_compare_thumbnails`
3. `yt_edit_thumbnail`, `yt_inpaint_thumbnail`, `yt_swap_face`, `yt_apply_style`,
   `yt_auto_optimize_thumbnail`, `yt_generate_vertical_variant`
4. `yt_attach_thumbnail_to_video`
5. `yt_publish_video` ou `yt_schedule_video`
6. `yt_start_ab_test` puis `yt_get_thumbnail_insights`

### Chaîne complète pilotable par un agent

trouver un outlier → en tirer une idée → générer titre et miniature → publier →
découper en shorts → distribuer → mesurer → corriger en lot

- Veille : `yt_track_channel`, `yt_list_tracked_channels`, `yt_find_outliers`,
  `yt_analyze_outlier_pattern`, `yt_get_daily_ideas`, `yt_get_video_momentum`.
- Optimisation : `yt_score_video_seo` (gratuit), `yt_generate_titles`,
  `yt_generate_description`, `yt_research_keywords`.
- Audit : `yt_audit_channel`, `yt_get_channel_health_score`.
- Traitement en lot : `yt_create_bulk_job`, `yt_find_replace_descriptions`,
  `yt_get_bulk_job_status`, `yt_retry_failed_items`, `yt_cancel_bulk_job`.
- Shorts : `yt_create_clips_from_video`, `yt_get_clip`, `yt_publish_clip`.
- Distribution : `yt_list_connected_accounts`, `yt_suggest_publishing_slots`,
  `yt_get_publishing_slots`, `yt_schedule_cross_post`.
- Communauté : `yt_list_comments`, `yt_draft_comment_reply`, `yt_reply_to_comment`.
- Mesure : `yt_get_channel_analytics`, `yt_get_video_analytics`, `yt_compare_videos`,
  `yt_generate_report`.

Les scores de clicabilité et de viralité sont des estimations éditoriales, jamais
des mesures. Les horaires suggérés proviennent de l'historique réel de la chaîne.

### Autres outils

Chaînes : `yt_list_channels`, `yt_switch_channel`, `yt_set_favorite_channel`, `yt_get_channel_status`.
Agenda : `yt_list_schedule`, `yt_reschedule_video`, `yt_cancel_scheduled_video`,
`yt_set_schedule_slots`, `yt_list_schedule_slots`, `yt_suggest_slots`, `yt_bulk_schedule`.
Vidéos : `yt_list_videos`, `yt_get_video_status`, `yt_update_video_metadata`,
`yt_delete_video`, `yt_retry_video`, `yt_create_upload_url`, `yt_register_uploaded_video`,
`yt_list_recent_uploads`.
Bibliothèque : `yt_list_thumbnails`, `yt_get_thumbnail`, `yt_list_styles`,
`yt_list_face_models`, `yt_list_brand_kits`, `yt_clone_style_from_url`.
Bibliothèque de prompts : `yt_list_prompts`, `yt_get_prompt` (avec `values`, renvoie
le corps déjà substitué et les variables requises manquantes), `yt_create_prompt`
(variables détectées à partir des `[crochets]`, refus des secrets et des doublons),
`yt_update_prompt`, `yt_delete_prompt` (suppression réversible 30 jours),
`yt_toggle_prompt_favorite`. Enchaînement : trouver un prompt → le remplir avec le
contexte de la conversation → l'exécuter → enregistrer la formulation qui a marché.
Mesure et budget : `yt_get_channel_analytics`, `yt_get_video_analytics`,
`yt_get_quota_status`, `yt_get_credit_balance`.

## Notes pour les agents

- Tous les outils sont préfixés `yt_`. Les anciens noms sans préfixe restent
  acceptés jusqu'au 31 décembre 2026, mais sont dépréciés.
- Les outils `yt_list_*` sont paginés : `limit` (défaut 25, max 100) et
  `cursor`, avec `total_count`, `has_more` et `next_cursor` en réponse.

- Les opérations IA consomment des crédits ; vérifiez `yt_get_credit_balance` avant une série.
- L'analyse est gratuite : analysez avant et après chaque édition.
- Chaque édition crée une nouvelle version, jamais un écrasement.
- Les outils renvoient des URL d'aperçu signées, valables une heure : affichez-les.
- Un envoi de vidéo coûte environ 1600 unités de quota YouTube sur 10000 par jour,
  une mise à jour de miniature 50 unités.