u2-downloader

SKILL.md

# YouTube Video Downloader Skill

Download any YouTube video in various resolutions with a simple command. Supports 360p, 480p, 720p, 1080p, best quality, and audio-only extraction.

## Quick Install

Just tell OpenClaw:

> **"帮我安装这个 skill：https://clawhub.ai/XJouska/u2-downloader"**

OpenClaw will ask you for an **API Key**. Follow these steps to get one:

1. Go to [https://u2foru.site](https://u2foru.site) and register an account
2. Navigate to the **API Keys** page (or visit [https://u2foru.site/?page=apikeys](https://u2foru.site/?page=apikeys))
3. Click **Generate** to create your API Key (format: `sk-yt-xxxxx`)
4. Copy the key and paste it to OpenClaw when prompted

That's it! You're ready to use the skill.

## Usage

Once installed, just tell OpenClaw what you want. For example:

> "帮我下载这个 YouTube 视频：https://youtube.com/watch?v=dQw4w9WgXcQ"

> "Download this video in 1080p: https://youtube.com/watch?v=xxxxx"

Supported resolutions: 360p, 480p, 720p (default), 1080p, best, audio-only.

## Authentication

All API calls require an API Key in the Authorization header:

```
Authorization: Bearer sk-yt-xxxxx
```

Get your API Key at: https://u2foru.site/?page=apikeys

## Endpoints

### POST /api/v1/skill/download

Download a YouTube video.

**Request:**
```json
{
  "youtube_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "resolution": "720"
}
```

**Parameters:**
- `youtube_url` (required): YouTube video URL
- `resolution` (optional): "360", "480", "720", "1080", "best", "audio". Default: "720"

**Response (success):**
```json
{
  "success": true,
  "download_url": "https://oss-bucket.aliyuncs.com/skill/abc123/video.mp4",
  "video_title": "Video Title",
  "video_duration": 212,
  "file_size": 52428800,
  "resolution": "720",
  "processing_time": 45.2
}
```

### GET /api/v1/skill/balance

Check account status.

**Response:**
```json
{
  "username": "user123"
}
```

### GET /api/v1/skill/health

Health check (no authentication required).

**Response:**
```json
{
  "status": "healthy",
  "service": "YouTube Video Downloader Skill",
  "version": "1.0.0"
}
```

## Error Codes

| Code | Meaning |
|------|---------|
| 200  | Success |
| 401  | Invalid or missing API Key |
| 400  | Invalid request (bad URL, etc.) |
| 500  | Server error |

## Example (curl)

```bash
# Download a video
curl -X POST https://u2foru.site/api/v1/skill/download \
  -H "Authorization: Bearer sk-yt-xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"youtube_url": "https://youtube.com/watch?v=dQw4w9WgXcQ", "resolution": "720"}'
```

## Example (Python)

```python
import requests

API_KEY = "sk-yt-xxxxx"
BASE_URL = "https://u2foru.site"

# Download
resp = requests.post(
    f"{BASE_URL}/api/v1/skill/download",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"youtube_url": "https://youtube.com/watch?v=dQw4w9WgXcQ", "resolution": "720"}
)
data = resp.json()
if data["success"]:
    print(f"Download URL: {data['download_url']}")
```