46 lines
1.5 KiB
Markdown
46 lines
1.5 KiB
Markdown
---
|
|
name: youtube-search
|
|
description: Search YouTube and get video metadata using YouTube Data API v3. Use when asked to find videos, search YouTube, get info about a video, or list videos by topic or channel. Requires YOUTUBE_API_KEY in ~/.openclaw/.env.
|
|
---
|
|
|
|
# YouTube Search
|
|
|
|
## Setup
|
|
|
|
API key stored in `~/.openclaw/.env` as `YOUTUBE_API_KEY`.
|
|
|
|
## Scripts
|
|
|
|
### Search videos
|
|
```bash
|
|
YOUTUBE_API_KEY=$(grep YOUTUBE_API_KEY ~/.openclaw/.env | cut -d= -f2) \
|
|
python3 skills/youtube-search/scripts/youtube_search.py search "<query>" [<max_results>] [<lang>]
|
|
```
|
|
Returns JSON: title, channel, published, description (200 chars), url, video_id.
|
|
|
|
Default: max_results=5, lang=ru (relevanceLanguage, not filter — results may include other languages).
|
|
|
|
### Get video info
|
|
```bash
|
|
YOUTUBE_API_KEY=$(grep YOUTUBE_API_KEY ~/.openclaw/.env | cut -d= -f2) \
|
|
python3 skills/youtube-search/scripts/youtube_search.py info "<video_id>"
|
|
```
|
|
Returns: title, channel, published, full description, views, likes, duration (ISO 8601), url.
|
|
|
|
## Quota
|
|
|
|
- Default: 10,000 units/day (resets midnight PT)
|
|
- `search.list` = 100 units per call → 100 searches/day max
|
|
- `videos.list` = 1 unit per call
|
|
|
|
## Usage patterns
|
|
|
|
- **Find videos**: use `search` with descriptive query
|
|
- **Video details**: use `info` with video_id from search results
|
|
- **Russian content**: use `lang=ru` (default)
|
|
- **English content**: use `lang=en`
|
|
|
|
## Presenting results
|
|
|
|
Format results as a numbered list with title, channel, date and URL. For video info, include views, duration and description summary.
|