# youtube-mcp-server

Serveur MCP (Model Context Protocol) exposant tes données YouTube
personnelles (chaîne, vidéos, analytics) comme outils utilisables
depuis ChatGPT, Claude, ou tout autre client compatible MCP.

## Outils exposés

- `get_channel_stats` — abonnés, vues totales, nombre de vidéos
- `list_my_videos` — dernières vidéos publiées
- `get_video_analytics` — vues, likes, durée de visionnage sur une période
- `get_audience_retention` — courbe de rétention, timestamps et principales chutes d'une vidéo
- `search_my_videos` — recherche dans tes propres vidéos
- `get_search_keywords` — requêtes YouTube Search qui apportent des vues
- `get_search_traffic_trend` — évolution quotidienne du trafic provenant de YouTube Search
- `get_audience_demographics` — répartition de l'audience par âge et genre

### Analyse de la rétention

`get_audience_retention` interroge une vidéo à la fois avec la dimension
`elapsedVideoTimeRatio` et les métriques `audienceWatchRatio` et
`relativeRetentionPerformance`. La réponse contient normalement jusqu'à 100
points proportionnels, leur timestamp calculé à partir de la durée de la vidéo,
ainsi que les dix baisses les plus fortes entre deux segments consécutifs.

Paramètres requis :

- `videoId` — identifiant YouTube de la vidéo
- `startDate` — début de la période au format `YYYY-MM-DD`
- `endDate` — fin de la période au format `YYYY-MM-DD`

Pour rapprocher les baisses du script, utiliser `timestamp` ou `elapsedSeconds`
avec une transcription horodatée et examiner également les secondes qui
précèdent chaque baisse.

## Installation

```bash
npm install
```

## Configuration

1. Les 4 premières variables d'environnement (`GOOGLE_CLIENT_ID`,
   `GOOGLE_CLIENT_SECRET`, `GOOGLE_REDIRECT_URI`, `MCP_AUTH_TOKEN`)
   doivent déjà être configurées dans Vercel (Settings > Environment
   Variables).

2. **Obtenir le refresh token** (une seule fois) :
   - Déploie ce projet sur Vercel
   - Visite `https://<ton-domaine>.vercel.app/api/oauth/start`
   - Connecte-toi avec ton compte Google (celui lié à ta chaîne YouTube)
   - Accepte les permissions demandées
   - Copie le `refresh_token` affiché sur la page de callback
   - Ajoute-le comme variable d'environnement `YOUTUBE_REFRESH_TOKEN`
     dans Vercel, puis **redéploie** le projet

## Connexion depuis ChatGPT / Claude

Ajoute un connecteur MCP personnalisé avec :
- **URL** : `https://<ton-domaine>.vercel.app/api/mcp`
- **Header d'authentification** : `Authorization: Bearer <ton MCP_AUTH_TOKEN>`

## Sécurité

- Ne commite jamais de fichier `.env` contenant de vraies valeurs
  (voir `.env.example` pour la liste des variables nécessaires)
- Le `MCP_AUTH_TOKEN` protège l'accès à `/api/mcp` — ne le partage
  avec personne
- Le `refresh_token` n'est affiché qu'une seule fois lors du premier
  flow OAuth