Communitygithub.com

YouTube Data API v3 Skill

Vollständiger Wrapper für die YouTube Data API v3 – Suche nach Videos, Abruf von Video-/Kanal-/Playlist-Details, Kommentare, Untertitel-Download und mehr. Unterstützt Filterung und Sortierung nach Zeit, Aufrufen, Bewertung und vielem mehr.

Was ist YouTube Data API v3 Skill?

Dieses Skill für KI-Agenten wie Claude Code, Cursor oder Codex bietet einen vollständigen Wrapper für die offizielle YouTube Data API v3. Es ermöglicht Entwicklern, programmatisch Videos zu suchen, detaillierte Informationen zu Videos, Kanälen und Playlists abzurufen, Kommentare und Untertitel zu extrahieren sowie auf Trending-Inhalte zuzugreifen. Das Skill unterstützt umfangreiche Filter- und Sortieroptionen, darunter Zeiträume, Ansichten, Bewertungen und Videomerkmale wie HD oder Untertitel. Es ist plattformunabhängig und wird über die Umgebungsvariable `YOUTUBE_API_KEY` konfiguriert. Die Nutzung ist klar dokumentiert, inklusive Quota-Optimierung, Paginierung und Fehlerbehandlung, sodass Entwickler die API effizient und ohne manuelle Requests nutzen können.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht YouTube Data API v3 Skill?

Vollständiger Wrapper basierend auf der offiziellen YouTube Data API v3 Dokumentation.

Konfiguration

API-Key-Setup

# Option 1: Umgebungsvariable (empfohlen)
export YOUTUBE_API_KEY="DEIN_API_KEY_HIER"

# Option 2: Konfigurationsdatei direkt bearbeiten
# Bearbeite ~/.claude/skills/youtube-data-api/scripts/config.py

Einen API-Key erhalten

  1. Gehe zur Google Cloud Console
  2. Erstelle ein neues Projekt oder wähle ein vorhandenes aus
  3. Aktiviere die YouTube Data API v3
  4. Erstelle Anmeldedaten → API-Key
  5. (Optional) Beschränke den API-Key auf die YouTube Data API

Quota-Limits

OperationstypQuota-Kosten (Einheiten)
Leseoperationen (list)1
Suchanfragen100
Schreiboperationen (insert/update/delete)50
Video-Upload1600

Standardmäßiges tägliches Quota: 10.000 Einheiten


Kernfunktionen

1. Videos suchen (Search)

Quota-Kosten: 100 Einheiten/Anfrage

# Einfache Suche
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
    --query "Python Tutorial" \
    --max-results 25

# Nach Zeit filtern (letzte Woche)
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
    --query "Machine Learning" \
    --published-after "7d" \
    --type video

# Nach Aufrufen sortieren
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
    --query "React Hooks" \
    --order viewCount \
    --type video

# Nur HD-Videos
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
    --query "4K Natur" \
    --video-definition high \
    --type video

# Videos mit Untertiteln
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
    --query "TED Talk" \
    --video-caption closedCaption \
    --type video

# Live-Streaming-Videos
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
    --query "Gaming" \
    --event-type live \
    --type video

# Nach Region filtern
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
    --query "Nachrichten" \
    --region-code DE \
    --relevance-language de

# Nach Videolänge filtern
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py search \
    --query "Dokumentation" \
    --video-duration long \
    --type video

Referenz der Suchparameter

ParameterBeschreibungWerte
--query, -qSuchbegriffeUnterstützt boolesche Operatoren (python AND tutorial)
--typeRessourcentypvideo, channel, playlist
--max-resultsAnzahl der Ergebnisse1-50, Standard 25
--orderSortierreihenfolgerelevance(Standard), date, rating, viewCount, title
--published-afterVeröffentlicht nach1d, 7d, 30d, 1y oder ISO 8601 Format
--published-beforeVeröffentlicht vorWie oben
--region-codeRegionscodeISO 3166-1 (z.B. DE, US, JP)
--relevance-languageSpracheISO 639-1 (z.B. de, en, ja)
--video-durationVideolängeshort(<4min), medium(4-20min), long(>20min)
--video-definitionAuflösunghigh(HD), standard(SD)
--video-captionUntertitelclosedCaption(hat Untertitel), none(keine Untertitel)
--video-dimensionDimension2d, 3d
--event-typeLive-Statuslive(streamt), completed(beendet), upcoming(geplant)
--channel-idAuf Kanal beschränkenKanal-ID
--safe-searchSicherheitssuchenone, moderate, strict

2. Video-Details abrufen (Videos)

Quota-Kosten: 1 Einheit/Anfrage

# Einzelne Video-Details abrufen
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py video \
    --id "dQw4w9WgXcQ" \
    --parts snippet,statistics,contentDetails

# Mehrere Videos abrufen (Stapelverarbeitung)
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py video \
    --id "dQw4w9WgXcQ,jNQXAC9IVRw,9bZkp7q19f0" \
    --parts snippet,statistics

# Trending-Videos abrufen
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py video \
    --chart mostPopular \
    --region-code US \
    --max-results 50

# Trending nach Kategorie
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py video \
    --chart mostPopular \
    --video-category-id 10 \
    --region-code JP

Referenz der Video-Teile

TeilEnthält
snippetTitel, Beschreibung, Thumbnails, Kanalinfo, Veröffentlichungszeit, Tags
statisticsAufrufe, Likes, Kommentare
contentDetailsDauer, Auflösung, Untertitel-Info, Regionsbeschränkungen
statusUpload-Status, Datenschutz, Lizenz
playerEingebetteter Player-HTML
topicDetailsVerwandte Themen-IDs
recordingDetailsAufnahmeort, Datum
liveStreamingDetailsLive-Info (Start-/Endzeit, Zuschauerzahl)

Referenz der Videokategorie-IDs

IDKategorieIDKategorie
1Film & Animation20Gaming
2Autos & Fahrzeuge22Menschen & Blogs
10Musik23Comedy
15Haustiere & Tiere24Unterhaltung
17Sport25Nachrichten & Politik
19Reisen & Events26Anleitungen & Styling
27Bildung28Wissenschaft & Technologie

3. Kanalinfo abrufen (Channels)

Quota-Kosten: 1 Einheit/Anfrage

# Nach Kanal-ID abrufen
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py channel \
    --id "UC_x5XG1OV2P6uZZ5FSM9Ttw" \
    --parts snippet,statistics,contentDetails

# Nach Benutzername abrufen
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py channel \
    --for-username "GoogleDevelopers" \
    --parts snippet,statistics

# Nach Handle (@benutzername) abrufen
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py channel \
    --for-handle "@Google" \
    --parts snippet,statistics,brandingSettings

Referenz der Kanal-Teile

TeilEnthält
snippetKanalname, Beschreibung, Thumbnails, Land
statisticsAbonnenten, Videoanzahl, Gesamtaufrufe
contentDetailsVerwandte Playlists (Uploads, Likes, etc.)
brandingSettingsKanalbanner, Schlüsselwörter, Standardsprache
topicDetailsKanalthemen
statusKanalstatus (Berechtigung für lange Videos etc.)

4. Playlists abrufen (Playlists)

Quota-Kosten: 1 Einheit/Anfrage

# Playlist nach ID abrufen
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py playlist \
    --id "PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf" \
    --parts snippet,contentDetails

# Alle Playlists eines Kanals abrufen
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py playlist \
    --channel-id "UC_x5XG1OV2P6uZZ5FSM9Ttw" \
    --max-results 50

5. Playlist-Videos abrufen (PlaylistItems)

Quota-Kosten: 1 Einheit/Anfrage

# Alle Videos in einer Playlist abrufen
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py playlist-items \
    --playlist-id "PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf" \
    --max-results 50

# Seitenweise abrufen
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py playlist-items \
    --playlist-id "PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf" \
    --page-token "NEXT_PAGE_TOKEN"

6. Kommentare abrufen (Comments & CommentThreads)

Quota-Kosten: 1 Einheit/Anfrage

# Alle Kommentare zu einem Video abrufen (Top-Level)
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py comments \
    --video-id "dQw4w9WgXcQ" \
    --max-results 100 \
    --order relevance

# Kommentare zu einem Kanal abrufen
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py comments \
    --channel-id "UC_x5XG1OV2P6uZZ5FSM9Ttw" \
    --max-results 50

# Antworten auf einen Kommentar abrufen
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py comment-replies \
    --parent-id "COMMENT_ID" \
    --max-results 50

Sortieroptionen für Kommentare

SortierungBeschreibung
relevanceNach Relevanz (Standard)
timeNach Zeit (neueste zuerst)

7. Untertitel abrufen (Captions)

Quota-Kosten: 1 Einheit/Anfrage (list), 50 Einheiten (download)

# Alle Untertitelspuren für ein Video auflisten
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py captions \
    --video-id "dQw4w9WgXcQ" \
    --list

# Untertitel herunterladen (erfordert OAuth)
python ~/.claude/skills/youtube-data-api/scripts/youtube_api.py captions \
    --video-id "dQw4w9WgXcQ" \
    --download \
    --caption-id "CAPTION_ID" \
    --format srt

Hinweis: Das Herunterladen von Untertiteln erfordert die Autorisierung des Videoinhabers (OAuth). Für öffentliche Videos verwende yt-dlp, um automatisch generierte Untertitel zu erhalten.

Verwendung von yt-dlp für Untertitel (Alternative)

# Installiere yt-dlp
pip install yt-dlp

# Verfügbare Untertitel auflisten

[...truncated]

Verwandte Skills