openclaw-youtube

# OpenClaw YouTube 📺

**YouTube SERP Scout for autonomous agents. Powered by AIsa.**

One API key. Rank discovery. Content research. Competitor tracking.

## 🔥 What Can You Do?

### Content Research
```
"Find top-ranking videos about 'AI agents tutorial' to see what's working"
```

### Competitor Tracking
```
"Search for videos from competitor channels about 'machine learning'"
```

### Trend Discovery
```
"What are the top YouTube videos about 'GPT-5' right now?"
```

### Topic Analysis
```
"Find popular videos on 'autonomous driving' to understand audience interest"
```

### Channel Discovery
```
"Search for channels creating content about 'crypto trading'"
```

## Quick Start

```bash
export AISA_API_KEY="your-key"
```

---

## Core Capabilities

### Basic YouTube Search

```bash
# Search for videos
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=AI+agents+tutorial" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

### Search with Country Filter

```bash
# Search in specific country (US)
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=machine+learning&gl=us" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Search in Japan
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=AI&gl=jp&hl=ja" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

### Search with Language Filter

```bash
# Search with interface language
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=python+tutorial&hl=en" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Chinese interface
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=编程教程&hl=zh-CN&gl=cn" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

### Pagination with Filter Token

```bash
# Use sp parameter for pagination or advanced filters
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=AI&sp=<filter_token>" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

---

## Python Client

```bash
# Basic search
python3 {baseDir}/scripts/youtub...

# OpenClaw YouTube 📺

YouTube SERP Scout for autonomous agents. Search top-ranking videos, channels, and trends.

## Features

- **SERP Search**: Find top-ranking videos for any query
- **Country/Language Filters**: Target specific regions
- **Competitor Research**: Track competitor content
- **Trend Discovery**: Find what's popular now

## Quick Start

```bash
export AISA_API_KEY="your-key"

# Basic search
python scripts/youtube_client.py search --query "AI agents tutorial"

# Search with country filter
python scripts/youtube_client.py search --query "machine learning" --country us

# Find top videos
python scripts/youtube_client.py top-videos --query "GPT-5" --count 10

# Competitor research
python scripts/youtube_client.py competitor --name "OpenAI" --topic "tutorial"
```

## Use Cases

1. **Content Research** - Find what's ranking to plan your content
2. **Competitor Tracking** - Monitor competitor YouTube presence
3. **Trend Discovery** - Identify trending topics
4. **Keyword Research** - Discover popular search terms
5. **Audience Research** - Understand regional preferences

## Documentation

See [SKILL.md](SKILL.md) for complete API documentation.