Compétence YouTube Data API v3
Wrapper complet basé sur la documentation officielle de l'API YouTube Data v3.
Configuration
Configuration de la clé API
# Option 1 : Variable d'environnement (recommandé)
export YOUTUBE_API_KEY="VOTRE_CLE_API"
# Option 2 : Modifier directement le fichier de configuration
# Modifier ~/.claude/skills/youtube-data-api/scripts/config.py
Obtenir une clé API
- Aller sur Google Cloud Console
- Créer un nouveau projet ou sélectionner un projet existant
- Activer l'API YouTube Data v3
- Créer des identifiants → Clé API
- (Optionnel) Restreindre la clé API à l'API YouTube Data uniquement
Limites de quota
| Type d'opération | Coût du quota (unités) |
|---|---|
| Opérations de lecture (liste) | 1 |
| Requêtes de recherche | 100 |
| Opérations d'écriture (insertion/mise à jour/suppression) | 50 |
| Téléchargement de vidéo | 1600 |
Quota quotidien par défaut : 10 000 unités
Fonctionnalités principales
1. Rechercher des vidéos (Search)
Coût du quota : 100 unités/requête
# Recherche de base
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
--query "Tutoriel Python" \
--max-results 25
# Filtrer par date (la semaine dernière)
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
--query "apprentissage automatique" \
--published-after "7d" \
--type video
# Trier par nombre de vues
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
--query "React hooks" \
--order viewCount \
--type video
# Vidéos HD uniquement
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
--query "Nature 4K" \
--video-definition high \
--type video
# Vidéos avec sous-titres
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
--query "Conférence TED" \
--video-caption closedCaption \
--type video
# Vidéos en direct
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
--query "jeu vidéo" \
--event-type live \
--type video
# Filtrer par région
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
--query "actualités" \
--region-code US \
--relevance-language en
# Filtrer par durée de la vidéo
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
--query "documentaire" \
--video-duration long \
--type video
Référence des paramètres de recherche
| Paramètre | Description | Valeurs |
|---|---|---|
--query, -q | Mots-clés de recherche | Prend en charge les opérateurs booléens (python AND tutorial) |
--type | Type de ressource | video, channel, playlist |
--max-results | Nombre de résultats | 1-50, par défaut 25 |
--order | Ordre de tri | relevance(défaut), date, rating, viewCount, title |
--published-after | Publié après | 1d, 7d, 30d, 1y ou format ISO 8601 |
--published-before | Publié avant | Identique à ci-dessus |
--region-code | Code de région | ISO 3166-1 (ex. US, CN, JP) |
--relevance-language | Langue | ISO 639-1 (ex. en, zh, ja) |
--video-duration | Durée de la vidéo | short(<4min), medium(4-20min), long(>20min) |
--video-definition | Définition | high(HD), standard(SD) |
--video-caption | Sous-titres | closedCaption(a des sous-titres), none(pas de sous-titres) |
--video-dimension | Dimension | 2d, 3d |
--event-type | Statut en direct | live(en cours), completed(terminé), upcoming(à venir) |
--channel-id | Limiter à une chaîne | ID de la chaîne |
--safe-search | Recherche sécurisée | none, moderate, strict |
2. Obtenir les détails d'une vidéo (Videos)
Coût du quota : 1 unité/requête
# Obtenir les détails d'une seule vidéo
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py video \
--id "dQw4w9WgXcQ" \
--parts snippet,statistics,contentDetails
# Obtenir plusieurs vidéos (par lot)
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py video \
--id "dQw4w9WgXcQ,jNQXAC9IVRw,9bZkp7q19f0" \
--parts snippet,statistics
# Obtenir les vidéos tendances
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py video \
--chart mostPopular \
--region-code US \
--max-results 50
# Obtenir les tendances par catégorie
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py video \
--chart mostPopular \
--video-category-id 10 \
--region-code JP
Référence des parties vidéo
| Partie | Contient |
|---|---|
snippet | Titre, description, miniature, informations sur la chaîne, date de publication, tags |
statistics | Nombre de vues, nombre de likes, nombre de commentaires |
contentDetails | Durée, définition, informations sur les sous-titres, restrictions régionales |
status | Statut de téléchargement, confidentialité, licence |
player | HTML du lecteur intégré |
topicDetails | IDs de sujets associés |
recordingDetails | Lieu et date d'enregistrement |
liveStreamingDetails | Informations en direct (heure de début/fin, nombre de spectateurs) |
Référence des IDs de catégorie vidéo
| ID | Catégorie | ID | Catégorie |
|---|---|---|---|
| 1 | Film & Animation | 20 | Jeu vidéo |
| 2 | Autos & Véhicules | 22 | Personnes & Blogs |
| 10 | Musique | 23 | Comédie |
| 15 | Animaux & Animaux | 24 | Divertissement |
| 17 | Sports | 25 | Actualités & Politique |
| 19 | Voyage & Événements | 26 | Tutoriels & Style |
| 27 | Éducation | 28 | Science & Technologie |
3. Obtenir les informations d'une chaîne (Channels)
Coût du quota : 1 unité/requête
# Obtenir par ID de chaîne
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py channel \
--id "UC_x5XG1OV2P6uZZ5FSM9Ttw" \
--parts snippet,statistics,contentDetails
# Obtenir par nom d'utilisateur
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py channel \
--for-username "GoogleDevelopers" \
--parts snippet,statistics
# Obtenir par identifiant (@nom_utilisateur)
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py channel \
--for-handle "@Google" \
--parts snippet,statistics,brandingSettings
Référence des parties de chaîne
| Partie | Contient |
|---|---|
snippet | Nom de la chaîne, description, miniature, pays |
statistics | Nombre d'abonnés, nombre de vidéos, vues totales |
contentDetails | Playlists associées (téléchargements, likes, etc.) |
brandingSettings | Bannière de la chaîne, mots-clés, langue par défaut |
topicDetails | Sujets de la chaîne |
status | Statut de la chaîne (autorisation de téléchargement de vidéos longues, etc.) |
4. Obtenir les playlists (Playlists)
Coût du quota : 1 unité/requête
# Obtenir une playlist par ID
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py playlist \
--id "PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf" \
--parts snippet,contentDetails
# Obtenir toutes les playlists d'une chaîne
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py playlist \
--channel-id "UC_x5XG1OV2P6uZZ5FSM9Ttw" \
--max-results 50
5. Obtenir les vidéos d'une playlist (PlaylistItems)
Coût du quota : 1 unité/requête
# Obtenir toutes les vidéos d'une playlist
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py playlist-items \
--playlist-id "PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf" \
--max-results 50
# Récupération paginée
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py playlist-items \
--playlist-id "PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf" \
--page-token "NEXT_PAGE_TOKEN"
6. Obtenir les commentaires (Comments & CommentThreads)
Coût du quota : 1 unité/requête
# Obtenir tous les commentaires d'une vidéo (niveau supérieur)
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py comments \
--video-id "dQw4w9WgXcQ" \
--max-results 100 \
--order relevance
# Obtenir les commentaires d'une chaîne
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py comments \
--channel-id "UC_x5XG1OV2P6uZZ5FSM9Ttw" \
--max-results 50
# Obtenir les réponses à un commentaire
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py comment-replies \
--parent-id "COMMENT_ID" \
--max-results 50
Options de tri des commentaires
| Tri | Description |
|---|---|
relevance | Par pertinence (défaut) |
time | Par date (les plus récents en premier) |
7. Obtenir les sous-titres (Captions)
Coût du quota : 1 unité/requête (liste), 50 unités (téléchargement)
# Lister toutes les pistes de sous-titres d'une vidéo
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py captions \
--video-id "dQw4w9WgXcQ" \
--list
# Télécharger les sous-titres (nécessite OAuth)
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py captions \
--video-id "dQw4w9WgXcQ" \
--download \
--caption-id "CAPTION_ID" \
--format srt
Remarque : Le téléchargement des sous-titres nécessite l'autorisation du propriétaire de la vidéo (OAuth). Pour les vidéos publiques, utilisez yt-dlp pour obtenir les sous-titres générés automatiquement.
Utiliser yt-dlp pour les sous-titres (Alternative)
# Installer yt-dlp
pip install yt-dlp
# Lister les sous-titres disponibles
yt-dlp --list-subs "https://www.youtube.com/watch?v=VIDEO_ID"
# Télécharger les sous-titres (sans la vidéo)
yt-dlp --write-sub --write-auto-sub --sub-lang en,zh-Hans --skip-download \
"https://www.youtube.com/watch?v=VIDEO_ID"
# Télécharger et convertir au format SRT
yt-dlp --write-sub --write-auto-sub --sub-lang en --sub-format srt --skip-download \
"https://www.youtube.com/watch?v=VIDEO_ID"
8. Obtenir les catégories vidéo (VideoCategories)
Coût du quota : 1 unité/requête
# Obtenir les catégories vidéo pour une région
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py categories \
--region-code US
# Obtenir les catégories pour la Chine
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py categories \
--region-code CN
9. Obtenir les régions et langues prises en charge
Coût du quota : 1 unité/requête
# Obtenir la liste des régions prises en charge
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py regions
# Obtenir la liste des langues prises en charge
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py languages
Exemples de cas d'utilisation courants
Scénario 1 : Obtenir les vidéos tendances sur un sujet de la semaine dernière
# Rechercher des vidéos sur "IA" des 7 derniers jours, triées par nombre de vues
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
--query "IA intelligence artificielle" \
--published-after "7d" \
--order viewCount \
--type video \
--max-results 50 \
--output ai_trending.json
# Obtenir les statistiques détaillées de ces vidéos
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py video \
--ids-from ai_trending.json \
--parts snippet,statistics,contentDetails \
--output ai_trending_details.json
Scénario 2 : Analyser toutes les vidéos d'une chaîne
# 1. Obtenir les informations de la chaîne
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py channel \
--for-handle "@GoogleDevelopers" \
--parts snippet,statistics,contentDetails \
--output channel_info.json
# 2. Obtenir l'ID de la playlist des téléchargements (depuis contentDetails.relatedPlaylists.uploads)
# 3. Obtenir toutes les vidéos téléchargées
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py playlist-items \
--playlist-id "UPLOADS_PLAYLIST_ID" \
--max-results 50 \
--all-pages \
--output channel_videos.json
Scénario 3 : Obtenir des vidéos avec sous-titres
# 1. Rechercher des vidéos
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
--query "Conférence TED motivation" \
--video-caption closedCaption \
--type video \
--max-results 10 \
--output ted_videos.json
# 2. Télécharger les sous-titres avec yt-dlp
for video_id in $(jq -r '.items[].id.videoId' ted_videos.json); do
yt-dlp --write-sub --write-auto-sub --sub-lang en --skip-download \
"https://www.youtube.com/watch?v=$video_id" \
-o "sous-titres/%(id)s.%(ext)s"
done
Scénario 4 : Analyser les commentaires d'une vidéo
# Obtenir tous les commentaires d'une vidéo
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py comments \
--video-id "VIDEO_ID" \
--max-results 100 \
--all-pages \
--output comments.json
# Les données des commentaires incluent :
# - Nom de l'auteur
# - Texte du commentaire
# - Nombre de likes
# - Date de publication
# - Nombre de réponses
Formats de sortie
Toutes les commandes produisent par défaut une sortie JSON ; enregistrez dans un fichier avec le paramètre --output.
# Sortie vers un fichier
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
--query "Python" \
--output results.json
# Format CSV (données tabulaires)
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
--query "Python" \
--format csv \
--output results.csv
# Sortie simple (titres et IDs uniquement)
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
--query "Python" \
--format simple
Pagination
Pour les grands ensembles de données, l'API utilise pageToken pour la pagination :
# Récupération automatique de toutes les pages
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
--query "Python" \
--all-pages \
--max-total 500 \
--output all_results.json
# Pagination manuelle
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
--query "Python" \
--page-token "NEXT_PAGE_TOKEN"
Gestion des erreurs
Codes d'erreur courants
| Code | Description | Solution |
|---|---|---|
| 400 | Mauvaise requête | Vérifier le format des paramètres |
| 401 | Non autorisé | Vérifier la clé API |
| 403 | Quota dépassé ou permissions insuffisantes | Vérifier le quota ou demander une augmentation |
| 404 | Ressource non trouvée | Vérifier que l'ID est correct |
| 429 | Trop de requêtes | Réduire la fréquence des requêtes |
Conseils d'optimisation du quota
- Utilisez le paramètre
fieldspour ne demander que les champs nécessaires - Regroupez les requêtes en utilisant des listes d'IDs séparées par des virgules
- Mettez en cache les résultats pour éviter les requêtes en double
- Utilisez les ETags pour vérifier si la ressource a été mise à jour
# Obtenir uniquement les champs nécessaires (réduit la taille de la réponse)
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py video \
--id "VIDEO_ID" \
--fields "items(id,snippet(title,channelTitle),statistics(viewCount))"
Opérations nécessitant OAuth
Les opérations suivantes nécessitent une autorisation utilisateur (la clé API seule ne suffit pas) :
- Téléchargement de vidéos
- Mise à jour des métadonnées des vidéos
- Suppression de vidéos
- Gestion des playlists
- Publication/suppression de commentaires
- Évaluation de vidéos
Installation
# Cloner le dépôt
mkdir -p ~/.claude/skills/
git clone https://github.com/Yrzhe/youtube-data-api.git ~/.claude/skills/youtube-data-api/
# Installer les dépendances
pip install -r ~/.claude/skills/youtube-data-api/requirements.txt
Licence
MIT