# Send Youtube Transcript Api to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "youtube-transcript-api", "name": "Youtube Transcript Api", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/volodstaimi/youtube-transcript-api", "canonicalUrl": "https://clawhub.ai/volodstaimi/youtube-transcript-api", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/youtube-transcript-api", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=youtube-transcript-api", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "youtube-transcript-api", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-11T10:44:07.764Z", "expiresAt": "2026-05-18T10:44:07.764Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=youtube-transcript-api", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=youtube-transcript-api", "contentDisposition": "attachment; filename=\"youtube-transcript-api-0.1.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "youtube-transcript-api" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/youtube-transcript-api" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/youtube-transcript-api", "downloadUrl": "https://openagent3.xyz/downloads/youtube-transcript-api", "agentUrl": "https://openagent3.xyz/skills/youtube-transcript-api/agent", "manifestUrl": "https://openagent3.xyz/skills/youtube-transcript-api/agent.json", "briefUrl": "https://openagent3.xyz/skills/youtube-transcript-api/agent.md" } } ``` ## Documentation ### YouTube Transcript API Skill Use this skill when the user wants to extract transcripts from YouTube videos, transcribe videos without captions, translate video content, or process multiple videos in batch. ### When to Use User asks to get a transcript/subtitles/captions from a YouTube video User wants to transcribe a YouTube video that has no captions (ASR) User wants to translate a YouTube video transcript to another language User needs to process multiple YouTube videos at once User wants to build an AI/LLM pipeline that uses YouTube video content User wants to repurpose video content into text (blog posts, summaries, etc.) ### API Overview Base URL: https://youtubetranscript.dev/api/v2 Authentication: Bearer token via Authorization: Bearer YOUR_API_KEY Users can get a free API key at youtubetranscript.dev. ### Endpoints MethodEndpointDescriptionPOST/api/v2/transcribeExtract transcript from a single videoPOST/api/v2/batchExtract transcripts from up to 100 videosGET/api/v2/jobs/{job_id}Check status of an ASR jobGET/api/v2/batch/{batch_id}Check status of a batch request ### Request Fields FieldRequiredDescriptionvideoYes (single)YouTube URL or 11-character video IDvideo_idsYes (batch)Array of IDs or URLs (up to 100)languageNoISO 639-1 code (e.g., "es", "fr"). Omit for best availablesourceNoauto (default), manual, or asrformatNotimestamp, paragraphs, or wordswebhook_urlNoURL for async delivery (required for source="asr") ### Credit Costs MethodCostSpeedNative Captions1 credit5–10 secondsTranslation1 credit per 2,500 chars5–10 secondsASR (Audio)1 credit per 90 seconds2–20 minutes (async) ### Basic Transcript Extraction (Python) import requests API_KEY = "your_api_key" response = requests.post( "https://youtubetranscript.dev/api/v2/transcribe", headers={ "Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json", }, json={"video": "dQw4w9WgXcQ"} ) data = response.json() for segment in data["data"]["transcript"]: print(f"[{segment['start']:.1f}s] {segment['text']}") ### Basic Transcript Extraction (JavaScript/Node.js) const response = await fetch("https://youtubetranscript.dev/api/v2/transcribe", { method: "POST", headers: { Authorization: \`Bearer ${API_KEY}\`, "Content-Type": "application/json", }, body: JSON.stringify({ video: "dQw4w9WgXcQ" }), }); const { data } = await response.json(); console.log(data.transcript); ### Using the Node.js SDK npm install youtube-audio-transcript-api import { YouTubeTranscript } from "youtube-audio-transcript-api"; const yt = new YouTubeTranscript({ apiKey: "your_api_key" }); // Simple extraction const result = await yt.getTranscript("dQw4w9WgXcQ"); // With translation const translated = await yt.transcribe({ video: "dQw4w9WgXcQ", language: "es", }); // Batch (up to 100 videos) const batch = await yt.batch({ video_ids: ["dQw4w9WgXcQ", "jNQXAC9IVRw", "9bZkp7q19f0"], }); ### Basic Transcript Extraction (cURL) curl -X POST https://youtubetranscript.dev/api/v2/transcribe \\ -H "Authorization: Bearer YOUR_API_KEY" \\ -H "Content-Type: application/json" \\ -d '{"video": "dQw4w9WgXcQ"}' ### Batch Processing (up to 100 videos) curl -X POST https://youtubetranscript.dev/api/v2/batch \\ -H "Authorization: Bearer YOUR_API_KEY" \\ -H "Content-Type: application/json" \\ -d '{"video_ids": ["dQw4w9WgXcQ", "jNQXAC9IVRw", "9bZkp7q19f0"]}' ### Translation Add "language": "es" (or any ISO 639-1 code) to get the transcript translated: curl -X POST https://youtubetranscript.dev/api/v2/transcribe \\ -H "Authorization: Bearer YOUR_API_KEY" \\ -H "Content-Type: application/json" \\ -d '{"video": "dQw4w9WgXcQ", "language": "es"}' ### ASR Transcription (videos without captions) For videos that don't have captions, use ASR with a webhook: curl -X POST https://youtubetranscript.dev/api/v2/transcribe \\ -H "Authorization: Bearer YOUR_API_KEY" \\ -H "Content-Type: application/json" \\ -d '{"video": "VIDEO_ID", "source": "asr", "webhook_url": "https://yoursite.com/webhook"}' This returns immediately with status: "processing". Results are delivered to the webhook URL when ready. Poll with GET /api/v2/jobs/{job_id} if not using webhooks. ### Error Handling HTTP StatusError CodeDescription400invalid_requestInvalid JSON or missing required fields401invalid_api_keyMissing or invalid API key402payment_requiredInsufficient credits404no_captionsNo captions available and ASR not used429rate_limit_exceededToo many requests — check Retry-After header ### Important Notes Always ask the user for their API key if they haven't provided one. Free keys are available at youtubetranscript.dev. Omitting the language parameter returns the best available transcript without translation (saves credits). ASR is async — always use a webhook URL or poll the jobs endpoint. Batch endpoint accepts both YouTube URLs and 11-character video IDs. Re-fetching an already-owned transcript costs 0 credits. ### Resources Website Full API Docs & OpenAPI Spec npm SDK Pricing ## Trust - Source: tencent - Verification: Indexed source record - Publisher: volodstaimi - Version: 0.1.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-11T10:44:07.764Z - Expires at: 2026-05-18T10:44:07.764Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/youtube-transcript-api) - [Send to Agent page](https://openagent3.xyz/skills/youtube-transcript-api/agent) - [JSON manifest](https://openagent3.xyz/skills/youtube-transcript-api/agent.json) - [Markdown brief](https://openagent3.xyz/skills/youtube-transcript-api/agent.md) - [Download page](https://openagent3.xyz/downloads/youtube-transcript-api)