Metadata-Version: 2.4
Name: iflow-mcp_klavis-ai_youtube
Version: 1.0.0
Summary: YouTube MCP Server - A Model Context Protocol server for YouTube integration
Author-email: Klavis AI <support@klavis.ai>
License: Apache-2.0
Project-URL: Homepage, https://github.com/klavis-ai/klavis
Project-URL: Repository, https://github.com/klavis-ai/klavis
Project-URL: Documentation, https://www.klavis.ai/docs
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: mcp==1.11.0
Requires-Dist: pydantic
Requires-Dist: fastapi
Requires-Dist: uvicorn[standard]
Requires-Dist: aiohttp
Requires-Dist: python-dotenv
Requires-Dist: typing-extensions
Requires-Dist: youtube-transcript-api>=1.2.3
Requires-Dist: google-api-python-client>=2.100.0
Requires-Dist: google-auth>=2.23.0
Requires-Dist: google-auth-oauthlib>=1.1.0
Requires-Dist: google-auth-httplib2>=0.1.0
Requires-Dist: click
Requires-Dist: starlette

# YouTube MCP Server

A Model Context Protocol (MCP) server for YouTube integration. Retrieve video transcripts, details, and metadata using YouTube's Data API.

## 🚀 Quick Start - Run in 30 Seconds

### 🌐 Using Hosted Service (Recommended for Production)

Get instant access to YouTube with our managed infrastructure - **no setup required**:

**🔗 [Get Free API Key →](https://www.klavis.ai/home/api-keys)**

```bash
pip install klavis
# or
npm install klavis
```

```python
from klavis import Klavis

klavis = Klavis(api_key="your-free-key")
server = klavis.mcp_server.create_server_instance("YOUTUBE", "user123")
```

### 🐳 Using Docker (For Self-Hosting)

```bash
# Pull latest image
docker pull ghcr.io/klavis-ai/youtube-mcp-server:latest


# Run YouTube MCP Server
docker run -p 5000:5000 -e API_KEY=$API_KEY \
  ghcr.io/klavis-ai/youtube-mcp-server:latest
```

**API Key Setup:** Get your YouTube Data API key from the [Google Cloud Console](https://console.cloud.google.com/apis/credentials) and enable the YouTube Data API v3.

## 🛠️ Available Tools

- **Video Transcripts**: Retrieve full video transcripts with timestamps
- **Video Details**: Get video metadata including title, description, statistics
- **Video Search**: Search for videos by keywords and filters
- **Channel Information**: Get channel details and video listings
- **Playlist Management**: Access playlist contents and metadata

## 📚 Documentation & Support

| Resource | Link |
|----------|------|
| **📖 Documentation** | [www.klavis.ai/docs](https://www.klavis.ai/docs) |
| **💬 Discord** | [Join Community](https://discord.gg/p7TuTEcssn) |
| **🐛 Issues** | [GitHub Issues](https://github.com/klavis-ai/klavis/issues) |

## 🤝 Contributing

We welcome contributions! Please see our [Contributing Guide](../../CONTRIBUTING.md) for details.

## 📜 License

Apache 2.0 license - see [LICENSE](../../LICENSE) for details.

---

<div align="center">
  <p><strong>🚀 Supercharge AI Applications </strong></p>
  <p>
    <a href="https://www.klavis.ai">Get Free API Key</a> •
    <a href="https://www.klavis.ai/docs">Documentation</a> •
    <a href="https://discord.gg/p7TuTEcssn">Discord</a>
  </p>
</div>
