Skip to main content

​
YouTube

Search YouTube videos and extract transcripts/captions. Transcript extraction works without an API key; search requires a YouTube Data API v3 key.

​
Quick Start

import { Agent, openai, YouTubeToolkit } from "@radaros/core";

const yt = new YouTubeToolkit();

const agent = new Agent({
  name: "video-researcher",
  model: openai("gpt-4o"),
  instructions: "Extract and summarize YouTube video transcripts.",
  tools: [...yt.getTools()],
});

const result = await agent.run(
  "Get the transcript of https://www.youtube.com/watch?v=dQw4w9WgXcQ"
);

​
Config

​
apiKey
string
YouTube Data API v3 key for search. Falls back to YOUTUBE_API_KEY env var.
​
enableSearch
boolean
default:"true"
Enable the youtube_search tool (requires API key).
​
enableTranscript
boolean
default:"true"
Enable the youtube_transcript tool (no API key needed).

​
Tools

ToolDescription
youtube_transcriptGet captions/transcript for a YouTube video by URL or ID. No API key needed.
youtube_searchSearch YouTube for videos. Returns titles, channels, and URLs. Requires API key.

​
Environment Variables

export YOUTUBE_API_KEY="AIza..."
Get an API key from the Google Cloud Console.