AzureAICommunity.Agent.Middleware.YouTube 1.0.0

<div align="center">

📺 AzureAICommunity – YouTube Video Middleware (.NET)

Search YouTube videos directly from your AI agent pipeline using the YouTube Data API v3.

Let your AI agent find and return YouTube videos — with a single line of middleware.

Getting Started · Configuration · Usage · How It Works · Type Reference · Contributing

</div>

Overview

AzureAICommunity.Agent.Middleware.YouTube is a plug-and-play YouTube search layer for AI agent pipelines built on Microsoft.Agents.AI and Microsoft.Extensions.AI. It exposes a SearchVideos AI tool that accepts a natural-language query, a result count, and an offset, and returns matching YouTube watch URLs with titles and descriptions — all driven by the YouTube Data API v3.

✨ Features

📦 Installation

dotnet add package AzureAICommunity.Agent.Middleware.YouTube

🚀 Quick Start

using AzureAICommunity.Agent.Middleware.YouTube;
using Microsoft.Agents.AI;
using Microsoft.Extensions.AI;
using OllamaSharp;

var apiKey = Environment.GetEnvironmentVariable("YOUTUBE_API_KEY")!;

YouTubeConfig youTubeConfig = new YouTubeConfig
{
    ApiKey       = apiKey,
    ChannelId    = Environment.GetEnvironmentVariable("YOUTUBE_CHANNEL_ID") ?? string.Empty,
    MaxResults   = 25,
    DefaultCount = 5
};

var tools = YouTubeTools.Create(youTubeConfig);

IChatClient ollamaClient = new OllamaApiClient("http://localhost:11434/", "llama3.2");

AIAgent originalAgent = new ChatClientAgent(ollamaClient,
    instructions: """
        You are a helpful assistant with access to YouTube search.
        When the user asks for videos, always call the YouTube search tool.
        Always include the full watch URL (https://www.youtube.com/watch?v=...) in the results.
        """,
    tools: tools);

AIAgent agent = new AIAgentBuilder(originalAgent)
    .UseYouTubeSearch()
    .Build();

var response = await agent.RunAsync("Find me tutorials on Learn Microsoft AI");
Console.WriteLine(response);

⚙️ Configuration

All settings are provided through a YouTubeConfig instance:

YouTubeConfig config = new YouTubeConfig
{
    ApiKey       = Environment.GetEnvironmentVariable("YOUTUBE_API_KEY")!,
    ChannelId    = "UCxxxxxxxxxxxxxx",   // Leave empty to search all of YouTube
    MaxResults   = 25,
    DefaultCount = 5,
    LoggerFactory = loggerFactory        // Optional; pass null to silence logs
};

🧑‍💻 Usage

Middleware Pipeline

Register the middleware on an AIAgentBuilder so the agent automatically intercepts and handles SearchVideos tool calls:

var tools = YouTubeTools.Create(youTubeConfig);

AIAgent agent = new AIAgentBuilder(
        new ChatClientAgent(ollamaClient, instructions: "...", tools: tools))
    .UseYouTubeSearch()
    .Build();

var response = await agent.RunAsync("Find me tutorials on Learn Microsoft AI");
Console.WriteLine(response);

🔑 Getting a YouTube Data API v3 Key

1. Go to Google Cloud Console.
2. Create or select a project and enable the YouTube Data API v3.
3. Under Credentials, create an API key.
4. Store the key in an environment variable:

# Windows PowerShell
$env:YOUTUBE_API_KEY = "YOUR_API_KEY_HERE"

# Linux / macOS
export YOUTUBE_API_KEY="YOUR_API_KEY_HERE"

⚠️ Never commit your API key to source control.

🤝 Contributing

Contributions are welcome! Please open an issue to discuss what you'd like to change before submitting a pull request.

📁 Repository: https://github.com/rvinothrajendran/AgentFramework

1. Fork the repository
2. Create a feature branch (git checkout -b feature/my-feature)
3. Commit your changes (git commit -m 'Add my feature')
4. Push to the branch (git push origin feature/my-feature)
5. Open a Pull Request

👤 Author

Built and maintained by Vinoth Rajendran.

• 🐙 GitHub: github.com/rvinothrajendran — follow for more projects!
• 📺 YouTube: youtube.com/@VinothRajendran — subscribe for tutorials and demos!

📄 License

MIT