Skip to main content

Overview

YouTube tool allows you to search videos, get video details, and extract transcripts.

Installation

pip install "praisonai[tools]"

Environment Variables

export YOUTUBE_API_KEY=your_api_key  # Optional for basic features

Quick Start

from praisonai_tools import YouTubeTool

# Initialize
youtube = YouTubeTool()

# Search
results = youtube.search("Python tutorials")
print(results)

Usage with Agent

from praisonaiagents import Agent
from praisonai_tools import YouTubeTool

agent = Agent(
    name="VideoResearcher",
    instructions="You help find and summarize YouTube videos.",
    tools=[YouTubeTool()]
)

response = agent.chat("Find videos about machine learning basics")
print(response)

Available Methods

search(query, max_results=5)

Search YouTube videos.
from praisonai_tools import YouTubeTool

youtube = YouTubeTool()
videos = youtube.search("AI tutorials", max_results=5)

get_video(video_id)

Get video details.
video = youtube.get_video("dQw4w9WgXcQ")

get_transcript(video_id)

Get video transcript.
transcript = youtube.get_transcript("dQw4w9WgXcQ")

Common Errors

ErrorCauseSolution
youtube-transcript-api not installedMissing dependencyRun pip install youtube-transcript-api
Transcript not availableNo captionsTry different video
Rate limitedToo many requestsAdd delays