Yt

zeropointrepo/youtube-skills/clawhub/yt

by zeropointrepo4f7994b94e7dNo license1K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 2 days ago

Use when YouTube is relevant: pasted video links or IDs, @handles, quick video lookups, summaries, channel latest uploads, topic search, or any request involving YouTube content — even if YouTube is not mentioned explicitly. Covers transcripts, search, and channel latest. Not for uploads or account management.

Instructions onlyResearch & Analysis
AI-generated overview

Fetches YouTube transcripts, search results, and channel latest uploads through the TranscriptAPI service.

What it does
This skill gives an agent instructions for calling the TranscriptAPI HTTP endpoints to retrieve YouTube video transcripts, search videos or channels, list a channel's latest uploads, and resolve @handles to channel IDs. It documents required headers, request parameters, credit costs, and error codes. It produces transcript text, search result lists, and channel upload metadata such as view counts and publish dates.
When to use it
Use it when a request involves YouTube content, such as pasted video links or IDs, @handles, video summaries, channel latest uploads, or topic searches. It is not intended for uploading videos or managing accounts.
Requirements
Internet access to transcriptapi.com and a TRANSCRIPT_API_KEY environment variable (starts with sk_) for all API requests; a free account provides 100 credits. Requests must send an Authorization bearer header and a User-Agent header. No additional runtimes or dependencies are needed, and the skill ships no scripts, only a reference document for key setup.

yt

Quick YouTube lookup via TranscriptAPI.com.

Setup

If $TRANSCRIPT_API_KEY is not set, read references/auth-setup.md [blocked] and follow the instructions there to get and store the key.

Required Headers

Every request needs two headers:

  • Authorization: Bearer $TRANSCRIPT_API_KEY
  • User-Agent: your agent's name and version if known (e.g. HermesAgent/0.11.0, ClaudeCode/1.0). Version is optional — agent name alone is fine. Do not omit this header or send a bare default — Cloudflare will return a 403 (error code 1010) and block the request.

API Reference

Full OpenAPI spec: transcriptapi.com/openapi.json — consult this for the latest parameters and schemas.

Transcript — 1 credit

bash
curl -s "https://transcriptapi.com/api/v2/youtube/transcript\?video_url=VIDEO_URL&format=text&include_timestamp=true&send_metadata=true" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

Search — 1 credit

bash
curl -s "https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=10" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"
ParamDefaultValues
q—1-200 chars (required)
typevideovideo, channel
limit201-50

Channel latest — FREE

bash
curl -s "https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

Returns last 15 videos with exact view counts and publish dates. Accepts @handle, channel URL, or UC... ID.

Resolve handle — FREE

bash
curl -s "https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TED" \  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \  -H "User-Agent: YourAgent/1.0"

Use to convert @handle to UC... channel ID.

Errors

CodeMeaningAction
401Bad API keyCheck key
402No creditstranscriptapi.com/billing
403/1010Cloudflare blockAdd or fix User-Agent header
404Not foundNo captions or resource doesn't exist
408TimeoutRetry once

Free tier: 100 credits. Search and transcript cost 1 credit. Channel latest and resolve are free.

Source and attribution

Source:zeropointrepo/youtube-skillsinclawhub/ytat commit4f7994b

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

Yt · clawhub/yt Agent Skill | SourceWeft