Skip to main content
Glama
arjunprabhulal

mcp-youtube-search

MCP YouTube Search

A Python package for searching YouTube videos via SerpAPI, with an MCP server implementation.

Installation

Install from PyPI:

pip install mcp-youtube-search

Related MCP server: YouTube MCP Server

Requirements

Usage

Set your API key

You can set your SerpAPI API key in one of two ways:

  1. Set it as an environment variable:

    export SERP_API_KEY="your_api_key_here"
  2. Or create a .env file with the following content:

    SERP_API_KEY=your_api_key_here

As a Python library

from mcp_youtube_search.search import YouTubeSearch

# Initialize with API key
search = YouTubeSearch(api_key="your_api_key_here")  # or omit to use env var

# Search for videos
results = search.search("python tutorial", max_results=5)

# Process results
for video in results["results"]:
    print(f"Title: {video['title']}")
    print(f"Link: {video['link']}")
    print(f"Channel: {video['channel']}")
    print(f"Views: {video['views']}")
    print(f"Duration: {video['duration']}")
    print(f"Published: {video['published_date']}")
    print("---")

As a command-line tool

Search for videos:

mcp-youtube-search search "python tutorial" --max-results 5

Run as an MCP server:

mcp-youtube-search server

MCP Server Integration

The package can be used as an MCP server for integration with AI assistants:

from mcp_youtube_search.mcp_server import run_server

# Run the server with an optional API key (or use env var)
run_server(api_key="your_api_key_here")

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    F
    maintenance
    Enables AI assistants to search YouTube for videos, channels, and playlists while retrieving detailed analytics and metrics through the YouTube Data API v3. Supports advanced filtering options and provides comprehensive statistics for content discovery and analysis.
    1
    MIT
  • F
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables searching across multiple search engines (Google, Bing, YouTube, DuckDuckGo, etc.) and retrieving parsed search results via SerpApi integration.
    -