--- name: youtube-1035789c319a version: 1.0.1 description: | The most comprehensive YouTube skill for AI agents. Extract transcripts for FREE (zero API quota!), search with filters, batch video details, read comments, download videos/audio. We analyzed 15+ YouTube tools and built the one that does everything. homepage: https://github.com/openclaw/openclaw repository: https://github.com/openclaw/openclaw metadata: { "openclaw": { "emoji": "📺", "requires": { "bins": ["uv"] }, "install": [ { "id": "uv-brew", "kind": "brew", "formula": "uv", "bins": ["uv"], "label": "Install uv (brew)", }, { "id": "ytdlp-brew", "kind": "brew", "formula": "yt-dlp", "bins": ["yt-dlp"], "label": "Install yt-dlp for downloads (optional)", }, ], }, } --- # YouTube Research Pro **The most comprehensive YouTube skill for AI agents.** We analyzed 15+ YouTube MCP servers and found each does one thing well, but none does everything. So we built the skill we wished existed. ## Why This Skill? | What Others Do | What We Do | |----------------|------------| | Transcripts OR search OR downloads | **All three, unified** | | Burn API quota on transcripts | **FREE transcripts** (zero quota) | | Single video at a time | **Batch operations** (50 videos) | | Basic search | **Filtered search** (date, duration, order) | | Text output only | **JSON export** for pipelines | ### The Killer Feature: FREE Transcripts Most tools use the YouTube Data API for transcripts = **100 quota units per request**. Daily limit is 10,000 units = only ~100 transcripts/day. **We use `youtube-transcript-api`** — extracts directly from YouTube's frontend. **Zero API quota. Unlimited transcripts.** ## Quick Reference | Command | Quota | What it does | |---------|-------|--------------| | `transcript VIDEO` | **FREE** | Get video transcript | | `transcript-list VIDEO` | **FREE** | List available languages | | `download VIDEO` | **FREE** | Download video (yt-dlp) | | `download-audio VIDEO` | **FREE** | Extract audio only | | `search QUERY` | 100 | Search videos | | `video ID [ID...]` | 1/video | Get details (batch!) | | `comments VIDEO` | 1 | Get comments + replies | | `channel [ID]` | 1-3 | Channel statistics | ## Setup (One Time) ```bash # 1. Get credentials from Google Cloud Console # - Create OAuth 2.0 Client ID (Desktop app) # - Download JSON # 2. Save credentials mkdir -p ~/.config/youtube-skill mv ~/Downloads/client_secret*.json ~/.config/youtube-skill/credentials.json # 3. Authenticate uv run {baseDir}/scripts/youtube.py auth ``` ## Transcripts (FREE!) ```bash # Plain text transcript uv run {baseDir}/scripts/youtube.py transcript VIDEO_ID # With timestamps uv run {baseDir}/scripts/youtube.py transcript VIDEO_ID --timestamps # Specific language (falls back to available) uv run {baseDir}/scripts/youtube.py transcript VIDEO_ID -l es # List what's available uv run {baseDir}/scripts/youtube.py transcript-list VIDEO_ID # JSON output uv run {baseDir}/scripts/youtube.py transcript VIDEO_ID --json ``` Works with URLs too: ```bash uv run {baseDir}/scripts/youtube.py transcript "https://youtube.com/watch?v=dQw4w9WgXcQ" ``` ## Search ```bash # Basic search uv run {baseDir}/scripts/youtube.py search "AI news 2026" # With filters uv run {baseDir}/scripts/youtube.py search "tutorial" -l 20 --order date uv run {baseDir}/scripts/youtube.py search "lecture" --duration long uv run {baseDir}/scripts/youtube.py search "news" --published-after 2026-01-01T00:00:00Z ``` ## Video Details (Batch Supported) ```bash # Single video uv run {baseDir}/scripts/youtube.py video dQw4w9WgXcQ # Multiple videos at once (up to 50) uv run {baseDir}/scripts/youtube.py video id1 id2 id3 id4 id5 # JSON output for processing uv run {baseDir}/scripts/youtube.py video id1 id2 --json ``` ## Comments ```bash # Top comments uv run {baseDir}/scripts/youtube.py comments VIDEO_ID # With replies uv run {baseDir}/scripts/youtube.py comments VIDEO_ID --replies # Recent comments uv run {baseDir}/scripts/youtube.py comments VIDEO_ID --order time -l 50 ``` ## Downloads (requires yt-dlp) ```bash # Video (best quality) uv run {baseDir}/scripts/youtube.py download VIDEO_ID # Specific resolution uv run {baseDir}/scripts/youtube.py download VIDEO_ID -r 720p # With subtitles uv run {baseDir}/scripts/youtube.py download VIDEO_ID -s en # Audio only (MP3) uv run {baseDir}/scripts/youtube.py download-audio VIDEO_ID # Audio as M4A uv run {baseDir}/scripts/youtube.py download-audio VIDEO_ID -f m4a ``` ## User Data ```bash uv run {baseDir}/scripts/youtube.py subscriptions uv run {baseDir}/scripts/youtube.py playlists uv run {baseDir}/scripts/youtube.py playlist-items PLAYLIST_ID uv run {baseDir}/scripts/youtube.py liked uv run {baseDir}/scripts/youtube.py channel ``` ## Command Aliases | Full | Alias | |------|-------| | `transcript` | `tr` | | `search` | `s` | | `video` | `v` | | `comments` | `c` | | `download` | `dl` | | `download-audio` | `dla` | ## Use Cases **Research:** Fetch transcript → analyze with LLM → extract insights **Learning:** Batch transcripts from playlist → create study notes **Monitoring:** Search recent videos → extract transcripts → track trends **Podcasts:** Download audio for offline listening **Analysis:** Get channel stats → compare competitors ## Multi-Account ```bash uv run {baseDir}/scripts/youtube.py -a work subscriptions uv run {baseDir}/scripts/youtube.py -a personal liked ``` ## Why We Built This We surveyed the landscape: - **kimtaeyoon83/mcp-server-youtube-transcript** (463⭐) — Great transcripts, no search - **kevinwatt/yt-dlp-mcp** (211⭐) — Great downloads, no transcripts - **dannySubsense/youtube-mcp-server** (9⭐) — Most functions, but uses paid API for transcripts - **kirbah/mcp-youtube** (9⭐) — Batch ops, but no free transcripts **None combined free transcripts + search + downloads + batch ops.** Now one does. --- Source attribution: kbarbel640-del Original project: https://github.com/openclaw/openclaw License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2026 clawdbot Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: kbarbel640-del Original project: https://github.com/openclaw/openclaw Attribution basis: Recorded upstream repository Fields of work: Marketing, Content & Media Roles: Content Marketer, Social Media Manager, Influencer Marketer, Marketing Analyst, Video Producer Specialties: Specialty not specified Tools: Youtube Transcript Api, Yt Dlp Country applicability: Country not specified Classification basis: Source category, role and specialization labels Instruction SHA-256: 6da296ba00e871e2a01671d27f5353c5e62c51e71e741a8cdba168e237847b3d