mcpField
Y
yt

yt

github.com/zeropointrepoProductivity1.1k701 installsUpdated 5w ago
Repository

About yt

yt is a skill for quick YouTube lookup through TranscriptAPI.com. It helps agents search videos or channels, retrieve transcripts, and check recent channel uploads.

Key features

  1. 01Search videos or channels
  2. 02Retrieve video transcripts
  3. 03View a channel's latest 15 videos
  4. 04Resolve handles to channel IDs

Use cases

  1. 01Quickly find YouTube videos
  2. 02Read a video's transcript
  3. 03Check recent uploads and view counts
  4. 04Convert a channel handle to its ID

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/zeropointrepo/youtube-skills --skill yt

After installing, type/ytin Claude Code to confirm it loaded.

Bundled filesreferences/auth-setup.mdreferences/curl-examples.md

Details

From the project README

yt

Quick YouTube lookup via TranscriptAPI.com.

Setup

If $TRANSCRIPT_API_KEY is not set, read references/auth-setup.md 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

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

Search — 1 credit

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

Channel latest — FREE

GET https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
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

GET https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
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.

Copy-paste examples

Every request in this file as a ready-to-run one-liner: references/curl-examples.md

Comments

Markdown supported