{
  "schemaVersion": "1.0",
  "item": {
    "slug": "youtube-playlist",
    "name": "Youtube Playlist",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/therohitdas/youtube-playlist",
    "canonicalUrl": "https://clawhub.ai/therohitdas/youtube-playlist",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/youtube-playlist",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=youtube-playlist",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/tapi-auth.js"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/youtube-playlist"
    },
    "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/youtube-playlist",
    "agentPageUrl": "https://openagent3.xyz/skills/youtube-playlist/agent",
    "manifestUrl": "https://openagent3.xyz/skills/youtube-playlist/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/youtube-playlist/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "YouTube Playlist",
        "body": "Browse playlists and fetch transcripts via TranscriptAPI.com."
      },
      {
        "title": "Setup",
        "body": "If $TRANSCRIPT_API_KEY is not set, help the user create an account (100 free credits, no card):\n\nStep 1 — Register: Ask user for their email.\n\nnode ./scripts/tapi-auth.js register --email USER_EMAIL\n\n→ OTP sent to email. Ask user: \"Check your email for a 6-digit verification code.\"\n\nStep 2 — Verify: Once user provides the OTP:\n\nnode ./scripts/tapi-auth.js verify --token TOKEN_FROM_STEP_1 --otp CODE\n\nAPI key saved to ~/.openclaw/openclaw.json. See File Writes below for details. Existing file is backed up before modification.\n\nManual option: transcriptapi.com/signup → Dashboard → API Keys."
      },
      {
        "title": "File Writes",
        "body": "The verify and save-key commands save the API key to ~/.openclaw/openclaw.json (sets skills.entries.transcriptapi.apiKey and enabled: true). Existing file is backed up to ~/.openclaw/openclaw.json.bak before modification.\n\nTo use the API key in terminal/CLI outside the agent, add to your shell profile manually:\nexport TRANSCRIPT_API_KEY=<your-key>"
      },
      {
        "title": "API Reference",
        "body": "Full OpenAPI spec: transcriptapi.com/openapi.json — consult this for the latest parameters and schemas."
      },
      {
        "title": "GET /api/v2/youtube/playlist/videos — 1 credit/page",
        "body": "Paginated playlist video listing (100 per page). Accepts playlist — a YouTube playlist URL or playlist ID.\n\n# First page\ncurl -s \"https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PL_PLAYLIST_ID\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\"\n\n# Next pages\ncurl -s \"https://transcriptapi.com/api/v2/youtube/playlist/videos?continuation=TOKEN\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\"\n\nParamRequiredValidationplaylistconditionalPlaylist URL or ID (PL/UU/LL/FL/OL prefix)continuationconditionalnon-empty string\n\nProvide exactly one of playlist or continuation, not both.\n\nAccepted playlist ID prefixes:\n\nPL — user-created playlists\nUU — channel uploads playlist\nLL — liked videos\nFL — favorites\nOL — other system playlists\n\nResponse:\n\n{\n  \"results\": [\n    {\n      \"videoId\": \"abc123xyz00\",\n      \"title\": \"Playlist Video Title\",\n      \"channelId\": \"UCuAXFkgsw1L7xaCfnd5JJOw\",\n      \"channelTitle\": \"Channel Name\",\n      \"channelHandle\": \"@handle\",\n      \"lengthText\": \"10:05\",\n      \"viewCountText\": \"1.5M views\",\n      \"thumbnails\": [{ \"url\": \"...\", \"width\": 120, \"height\": 90 }],\n      \"index\": \"0\"\n    }\n  ],\n  \"playlist_info\": {\n    \"title\": \"Best Science Talks\",\n    \"numVideos\": \"47\",\n    \"description\": \"Top science presentations\",\n    \"ownerName\": \"TED\",\n    \"viewCount\": \"5000000\"\n  },\n  \"continuation_token\": \"4qmFsgKlARIYVVV1...\",\n  \"has_more\": true\n}\n\nPagination flow:\n\nFirst request: ?playlist=PLxxx — returns first 100 videos + continuation_token\nNext request: ?continuation=TOKEN — returns next 100 + new token\nRepeat until has_more: false or continuation_token: null"
      },
      {
        "title": "Workflow: Playlist → Transcripts",
        "body": "# 1. List playlist videos\ncurl -s \"https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PL_PLAYLIST_ID\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\"\n\n# 2. Get transcript from a video in the playlist\ncurl -s \"https://transcriptapi.com/api/v2/youtube/transcript\\\n?video_url=VIDEO_ID&format=text&include_timestamp=true&send_metadata=true\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\""
      },
      {
        "title": "Extract playlist ID from URL",
        "body": "From https://www.youtube.com/playlist?list=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf, the playlist ID is PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf. You can also pass the full URL directly to the playlist parameter."
      },
      {
        "title": "Errors",
        "body": "CodeMeaningAction400Both or neither paramsProvide exactly one of playlist or continuation402No creditstranscriptapi.com/billing404Playlist not foundCheck if playlist is public408TimeoutRetry once422Invalid playlist formatMust be a valid playlist URL or ID\n\n1 credit per page. Free tier: 100 credits, 300 req/min."
      }
    ],
    "body": "YouTube Playlist\n\nBrowse playlists and fetch transcripts via TranscriptAPI.com.\n\nSetup\n\nIf $TRANSCRIPT_API_KEY is not set, help the user create an account (100 free credits, no card):\n\nStep 1 — Register: Ask user for their email.\n\nnode ./scripts/tapi-auth.js register --email USER_EMAIL\n\n\n→ OTP sent to email. Ask user: \"Check your email for a 6-digit verification code.\"\n\nStep 2 — Verify: Once user provides the OTP:\n\nnode ./scripts/tapi-auth.js verify --token TOKEN_FROM_STEP_1 --otp CODE\n\n\nAPI key saved to ~/.openclaw/openclaw.json. See File Writes below for details. Existing file is backed up before modification.\n\nManual option: transcriptapi.com/signup → Dashboard → API Keys.\n\nFile Writes\n\nThe verify and save-key commands save the API key to ~/.openclaw/openclaw.json (sets skills.entries.transcriptapi.apiKey and enabled: true). Existing file is backed up to ~/.openclaw/openclaw.json.bak before modification.\n\nTo use the API key in terminal/CLI outside the agent, add to your shell profile manually: export TRANSCRIPT_API_KEY=<your-key>\n\nAPI Reference\n\nFull OpenAPI spec: transcriptapi.com/openapi.json — consult this for the latest parameters and schemas.\n\nGET /api/v2/youtube/playlist/videos — 1 credit/page\n\nPaginated playlist video listing (100 per page). Accepts playlist — a YouTube playlist URL or playlist ID.\n\n# First page\ncurl -s \"https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PL_PLAYLIST_ID\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\"\n\n# Next pages\ncurl -s \"https://transcriptapi.com/api/v2/youtube/playlist/videos?continuation=TOKEN\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\"\n\nParam\tRequired\tValidation\nplaylist\tconditional\tPlaylist URL or ID (PL/UU/LL/FL/OL prefix)\ncontinuation\tconditional\tnon-empty string\n\nProvide exactly one of playlist or continuation, not both.\n\nAccepted playlist ID prefixes:\n\nPL — user-created playlists\nUU — channel uploads playlist\nLL — liked videos\nFL — favorites\nOL — other system playlists\n\nResponse:\n\n{\n  \"results\": [\n    {\n      \"videoId\": \"abc123xyz00\",\n      \"title\": \"Playlist Video Title\",\n      \"channelId\": \"UCuAXFkgsw1L7xaCfnd5JJOw\",\n      \"channelTitle\": \"Channel Name\",\n      \"channelHandle\": \"@handle\",\n      \"lengthText\": \"10:05\",\n      \"viewCountText\": \"1.5M views\",\n      \"thumbnails\": [{ \"url\": \"...\", \"width\": 120, \"height\": 90 }],\n      \"index\": \"0\"\n    }\n  ],\n  \"playlist_info\": {\n    \"title\": \"Best Science Talks\",\n    \"numVideos\": \"47\",\n    \"description\": \"Top science presentations\",\n    \"ownerName\": \"TED\",\n    \"viewCount\": \"5000000\"\n  },\n  \"continuation_token\": \"4qmFsgKlARIYVVV1...\",\n  \"has_more\": true\n}\n\n\nPagination flow:\n\nFirst request: ?playlist=PLxxx — returns first 100 videos + continuation_token\nNext request: ?continuation=TOKEN — returns next 100 + new token\nRepeat until has_more: false or continuation_token: null\nWorkflow: Playlist → Transcripts\n# 1. List playlist videos\ncurl -s \"https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PL_PLAYLIST_ID\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\"\n\n# 2. Get transcript from a video in the playlist\ncurl -s \"https://transcriptapi.com/api/v2/youtube/transcript\\\n?video_url=VIDEO_ID&format=text&include_timestamp=true&send_metadata=true\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\"\n\nExtract playlist ID from URL\n\nFrom https://www.youtube.com/playlist?list=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf, the playlist ID is PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf. You can also pass the full URL directly to the playlist parameter.\n\nErrors\nCode\tMeaning\tAction\n400\tBoth or neither params\tProvide exactly one of playlist or continuation\n402\tNo credits\ttranscriptapi.com/billing\n404\tPlaylist not found\tCheck if playlist is public\n408\tTimeout\tRetry once\n422\tInvalid playlist format\tMust be a valid playlist URL or ID\n\n1 credit per page. Free tier: 100 credits, 300 req/min."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/therohitdas/youtube-playlist",
    "publisherUrl": "https://clawhub.ai/therohitdas/youtube-playlist",
    "owner": "therohitdas",
    "version": "1.4.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/youtube-playlist",
    "downloadUrl": "https://openagent3.xyz/downloads/youtube-playlist",
    "agentUrl": "https://openagent3.xyz/skills/youtube-playlist/agent",
    "manifestUrl": "https://openagent3.xyz/skills/youtube-playlist/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/youtube-playlist/agent.md"
  }
}