Communitygithub.com

Yrzhe/claude-skills

Wrapper complet pour YouTube Data API v3 : recherche de vidéos, détails des vidéos/chaines/playlists, commentaires, sous-titres, etc. Prend en charge le filtrage et le tri par date, vues, évaluation et plus.

Qu'est-ce que claude-skills ?

Cette compétence fournit un wrapper complet pour l'API YouTube Data v3, permettant d'interagir avec YouTube directement depuis des outils d'IA comme Claude Code, Cursor ou Codex. Elle couvre toutes les fonctionnalités essentielles : recherche de vidéos avec filtres avancés (date, durée, définition, sous-titres, live), récupération des détails des vidéos (statistiques, contenu, légendes), informations sur les chaînes, playlists, commentaires et téléchargement de sous-titres. Utile pour les développeurs qui souhaitent analyser des tendances, collecter des données de commentaires, ou générer des rapports sur le contenu YouTube. Le script utilise une clé API unique et prend en charge la pagination, les formats de sortie JSON/CSV, et l'optimisation des quotas. Il fonctionne sur toutes les plateformes supportant Python et nécessite l'activation de l'API YouTube Data v3 sur Google Cloud Console.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Yrzhe/claude-skills/tree/HEAD/plugins/youtube-data-api/skills/youtube-data-api

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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

  1. Aller sur Google Cloud Console
  2. Créer un nouveau projet ou sélectionner un projet existant
  3. Activer l'API YouTube Data v3
  4. Créer des identifiants → Clé API
  5. (Optionnel) Restreindre la clé API à l'API YouTube Data uniquement

Limites de quota

Type d'opérationCoût du quota (unités)
Opérations de lecture (liste)1
Requêtes de recherche100
Opérations d'écriture (insertion/mise à jour/suppression)50
Téléchargement de vidéo1600

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ètreDescriptionValeurs
--query, -qMots-clés de recherchePrend en charge les opérateurs booléens (python AND tutorial)
--typeType de ressourcevideo, channel, playlist
--max-resultsNombre de résultats1-50, par défaut 25
--orderOrdre de trirelevance(défaut), date, rating, viewCount, title
--published-afterPublié après1d, 7d, 30d, 1y ou format ISO 8601
--published-beforePublié avantIdentique à ci-dessus
--region-codeCode de régionISO 3166-1 (ex. US, CN, JP)
--relevance-languageLangueISO 639-1 (ex. en, zh, ja)
--video-durationDurée de la vidéoshort(<4min), medium(4-20min), long(>20min)
--video-definitionDéfinitionhigh(HD), standard(SD)
--video-captionSous-titresclosedCaption(a des sous-titres), none(pas de sous-titres)
--video-dimensionDimension2d, 3d
--event-typeStatut en directlive(en cours), completed(terminé), upcoming(à venir)
--channel-idLimiter à une chaîneID de la chaîne
--safe-searchRecherche sécuriséenone, 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

PartieContient
snippetTitre, description, miniature, informations sur la chaîne, date de publication, tags
statisticsNombre de vues, nombre de likes, nombre de commentaires
contentDetailsDurée, définition, informations sur les sous-titres, restrictions régionales
statusStatut de téléchargement, confidentialité, licence
playerHTML du lecteur intégré
topicDetailsIDs de sujets associés
recordingDetailsLieu et date d'enregistrement
liveStreamingDetailsInformations en direct (heure de début/fin, nombre de spectateurs)

Référence des IDs de catégorie vidéo

IDCatégorieIDCatégorie
1Film & Animation20Jeu vidéo
2Autos & Véhicules22Personnes & Blogs
10Musique23Comédie
15Animaux & Animaux24Divertissement
17Sports25Actualités & Politique
19Voyage & Événements26Tutoriels & Style
27Éducation28Science & 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

PartieContient
snippetNom de la chaîne, description, miniature, pays
statisticsNombre d'abonnés, nombre de vidéos, vues totales
contentDetailsPlaylists associées (téléchargements, likes, etc.)
brandingSettingsBannière de la chaîne, mots-clés, langue par défaut
topicDetailsSujets de la chaîne
statusStatut 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

TriDescription
relevancePar pertinence (défaut)
timePar 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

CodeDescriptionSolution
400Mauvaise requêteVérifier le format des paramètres
401Non autoriséVérifier la clé API
403Quota dépassé ou permissions insuffisantesVérifier le quota ou demander une augmentation
404Ressource non trouvéeVérifier que l'ID est correct
429Trop de requêtesRéduire la fréquence des requêtes

Conseils d'optimisation du quota

  1. Utilisez le paramètre fields pour ne demander que les champs nécessaires
  2. Regroupez les requêtes en utilisant des listes d'IDs séparées par des virgules
  3. Mettez en cache les résultats pour éviter les requêtes en double
  4. 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

Skills associés