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
- Gehe zur Google Cloud Console
- Erstelle ein neues Projekt oder wähle ein vorhandenes aus
- Aktiviere die YouTube Data API v3
- Erstelle Anmeldedaten → API-Key
- (Optional) Beschränke den API-Key auf die YouTube Data API
Quota-Limits
| Operationstyp | Quota-Kosten (Einheiten) |
|---|---|
| Leseoperationen (list) | 1 |
| Suchanfragen | 100 |
| Schreiboperationen (insert/update/delete) | 50 |
| Video-Upload | 1600 |
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
| Parameter | Beschreibung | Werte |
|---|---|---|
--query, -q | Suchbegriffe | Unterstützt boolesche Operatoren (python AND tutorial) |
--type | Ressourcentyp | video, channel, playlist |
--max-results | Anzahl der Ergebnisse | 1-50, Standard 25 |
--order | Sortierreihenfolge | relevance(Standard), date, rating, viewCount, title |
--published-after | Veröffentlicht nach | 1d, 7d, 30d, 1y oder ISO 8601 Format |
--published-before | Veröffentlicht vor | Wie oben |
--region-code | Regionscode | ISO 3166-1 (z.B. DE, US, JP) |
--relevance-language | Sprache | ISO 639-1 (z.B. de, en, ja) |
--video-duration | Videolänge | short(<4min), medium(4-20min), long(>20min) |
--video-definition | Auflösung | high(HD), standard(SD) |
--video-caption | Untertitel | closedCaption(hat Untertitel), none(keine Untertitel) |
--video-dimension | Dimension | 2d, 3d |
--event-type | Live-Status | live(streamt), completed(beendet), upcoming(geplant) |
--channel-id | Auf Kanal beschränken | Kanal-ID |
--safe-search | Sicherheitssuche | none, 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
| Teil | Enthält |
|---|---|
snippet | Titel, Beschreibung, Thumbnails, Kanalinfo, Veröffentlichungszeit, Tags |
statistics | Aufrufe, Likes, Kommentare |
contentDetails | Dauer, Auflösung, Untertitel-Info, Regionsbeschränkungen |
status | Upload-Status, Datenschutz, Lizenz |
player | Eingebetteter Player-HTML |
topicDetails | Verwandte Themen-IDs |
recordingDetails | Aufnahmeort, Datum |
liveStreamingDetails | Live-Info (Start-/Endzeit, Zuschauerzahl) |
Referenz der Videokategorie-IDs
| ID | Kategorie | ID | Kategorie |
|---|---|---|---|
| 1 | Film & Animation | 20 | Gaming |
| 2 | Autos & Fahrzeuge | 22 | Menschen & Blogs |
| 10 | Musik | 23 | Comedy |
| 15 | Haustiere & Tiere | 24 | Unterhaltung |
| 17 | Sport | 25 | Nachrichten & Politik |
| 19 | Reisen & Events | 26 | Anleitungen & Styling |
| 27 | Bildung | 28 | Wissenschaft & 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
| Teil | Enthält |
|---|---|
snippet | Kanalname, Beschreibung, Thumbnails, Land |
statistics | Abonnenten, Videoanzahl, Gesamtaufrufe |
contentDetails | Verwandte Playlists (Uploads, Likes, etc.) |
brandingSettings | Kanalbanner, Schlüsselwörter, Standardsprache |
topicDetails | Kanalthemen |
status | Kanalstatus (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
| Sortierung | Beschreibung |
|---|---|
relevance | Nach Relevanz (Standard) |
time | Nach 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]