@renoise/video-maker 0.1.0

package/skills/video-download/SKILL.md

@@ -0,0 +1,161 @@
+---
+name: video-download
+description: >
+  Downloads videos from YouTube, TikTok, Douyin, Bilibili, Instagram, XiaoHongShu and 1000+ platforms.
+  Primary: yt-dlp. Fallback: agent-browser + GreenVideo for Douyin/TikTok when yt-dlp fails.
+  Use when user says "download video", "save video", "下载视频", "抓取视频", "无水印下载",
+  or pastes a video URL. Do NOT use for AI video generation or video editing.
+allowed-tools: Bash
+metadata:
+  author: renoise
+  version: 0.2.0
+  category: utility
+  tags: [download, youtube, tiktok, douyin, yt-dlp, greenvideo]
+---
+
+# Video Download
+
+Download videos from YouTube, TikTok, and other platforms to local MP4 files using yt-dlp. Handles format selection, platform-prefixed dedup, and TikTok cookie fallback automatically.
+
+## Prerequisites
+
+Verify yt-dlp is installed:
+
+```bash
+yt-dlp --version
+```
+
+If missing: `brew install yt-dlp` (macOS) or `pip install yt-dlp`.
+
+### Optional (for Douyin/TikTok fallback)
+
+- `agent-browser` installed globally (`npm install -g agent-browser`)
+- Chrome for Testing installed (`agent-browser install`)
+
+## Usage
+
+### Single Video
+
+Run the download script with the video URL:
+
+```bash
+bash ${CLAUDE_SKILL_DIR}/scripts/download-video.sh '<URL>'
+```
+
+The script handles everything automatically:
+- Extracts a platform-prefixed video ID (`yt-dQw4w9WgXcQ`, `tk-7571284267028729101`, `vid-aHR0cHM6Ly93d3`)
+- Saves to `resources/references/<video_id>.mp4`
+- Skips download if file already exists (dedup)
+- Retries TikTok downloads with `--cookies-from-browser chrome` on failure
+- Removes zero-byte leftovers from interrupted downloads
+
+### Custom Output Directory
+
+```bash
+bash ${CLAUDE_SKILL_DIR}/scripts/download-video.sh '<URL>' 'path/to/output'
+```
+
+### Batch Download
+
+Run the script in a loop:
+
+```bash
+for URL in '<URL1>' '<URL2>' '<URL3>'; do
+  bash ${CLAUDE_SKILL_DIR}/scripts/download-video.sh "$URL"
+done
+```
+
+## Script Output
+
+The script prints one of three status lines:
+
+| Output | Meaning |
+|--------|---------|
+| `ALREADY_EXISTS: <path>` | File already downloaded, skipped |
+| `DOWNLOADED: <path>` | Download succeeded |
+| `FAILED: <message>` | Download failed (exit code 1) |
+
+## Troubleshooting
+
+| Error | Solution |
+|-------|----------|
+| `HTTP Error 403` (TikTok/Douyin) | Script auto-retries with cookies. If still failing, use **GreenVideo Fallback** below |
+| `--max-filesize` skipped | Video exceeds 200M limit. Download manually with `-f 'best[height<=720]'` |
+| `is not a valid URL` | Ensure URL is wrapped in single quotes |
+| `Requested formats are incompatible` | yt-dlp auto-transcodes, no action needed |
+
+## Video ID Logic
+
+| Platform | Pattern | Example ID |
+|----------|---------|------------|
+| YouTube | `watch?v=`, `shorts/`, `embed/`, `youtu.be/` → 11-char ID | `yt-dQw4w9WgXcQ` |
+| TikTok | 15+ digit numeric ID in URL | `tk-7571284267028729101` |
+| Other | Base64url of URL, first 16 chars | `vid-aHR0cHM6Ly93d3` |
+
+---
+
+## GreenVideo Fallback (for Douyin/TikTok)
+
+When yt-dlp fails for Douyin or TikTok URLs (common with 403 errors or region-restricted content), use GreenVideo as a browser-based fallback. Requires `agent-browser` (see Prerequisites).
+
+### Decision Logic
+
+```
+User gives URL → Try yt-dlp first
+                   ↓ fails (403 / no result)
+               Is it Douyin/TikTok?
+                   ↓ yes
+               Use agent-browser + GreenVideo
+                   ↓ no
+               Report error, suggest manual download
+```
+
+### Step 1: Open GreenVideo
+
+```bash
+agent-browser open "https://greenvideo.cc/en/"
+```
+
+### Step 2: Paste URL and Parse
+
+```bash
+agent-browser snapshot
+# Find the input textbox ref (e.g., @e63)
+agent-browser fill <input-ref> "<video-url>"
+agent-browser click <start-button-ref>
+```
+
+Wait 5 seconds for parsing to complete, then snapshot to verify results.
+
+### Step 3: Extract Video Direct URL
+
+The video URL is stored in Nuxt state. Extract it with:
+
+```bash
+agent-browser eval "
+(function() {
+  const nuxtData = window.__NUXT__;
+  if (!nuxtData) return 'ERROR: No Nuxt data found';
+  const str = JSON.stringify(nuxtData);
+  const mp4Match = str.match(/https?:[^\\\"]*(?:mp4|video|play|aweme|douyinvod|bilivideo)[^\\\"]{0,500}/g);
+  if (mp4Match && mp4Match.length > 0) return mp4Match[0];
+  return 'ERROR: No video URL found in Nuxt state';
+})()
+"
+```
+
+### Step 4: Download and Cleanup
+
+```bash
+curl -L -o ~/Downloads/<filename>.mp4 "<extracted-video-url>"
+agent-browser close
+```
+
+### GreenVideo Troubleshooting
+
+| Issue | Solution |
+|-------|----------|
+| Parse fails or no result | Check URL is valid and publicly accessible. Some `/user/self` URLs need the direct video URL |
+| No video URL in Nuxt state | Try clicking download button and check for `<video>` elements: `agent-browser eval "document.querySelectorAll('video').length"` |
+| Download fails (403) | Video URLs expire quickly — extract and download immediately. Try adding `-H "Referer: https://greenvideo.cc/"` to curl |
+| agent-browser not responding | Run `agent-browser close` then `agent-browser open "https://greenvideo.cc/en/"` |

package/skills/video-download/scripts/download-video.sh

@@ -0,0 +1,91 @@
+#!/usr/bin/env bash
+# download-video.sh — Download video to resources/references/ with dedup and platform detection
+#
+# Usage:
+#   download-video.sh <URL> [output_dir]
+#
+# Features:
+#   - Extracts platform-prefixed video ID (yt-xxx, tk-xxx, vid-xxx)
+#   - Skips download if file already exists (dedup)
+#   - Auto-retries TikTok with --cookies-from-browser chrome on 403
+#   - Outputs final file path on success
+
+set -euo pipefail
+
+URL="${1:?Usage: download-video.sh <URL> [output_dir]}"
+OUTPUT_DIR="${2:-resources/references}"
+
+# --- Video ID extraction ---
+
+extract_video_id() {
+  local url="$1"
+
+  # YouTube: watch?v=, shorts/, embed/, youtu.be/
+  if [[ "$url" =~ (youtube\.com/(watch\?v=|shorts/|embed/)|youtu\.be/)([\w-]{11}|[A-Za-z0-9_-]{11}) ]]; then
+    local yt_id
+    yt_id=$(echo "$url" | grep -oE '(watch\?v=|shorts/|embed/|youtu\.be/)([A-Za-z0-9_-]{11})' | grep -oE '[A-Za-z0-9_-]{11}$')
+    echo "yt-${yt_id}"
+    return
+  fi
+
+  # TikTok: numeric ID (15+ digits)
+  if [[ "$url" =~ tiktok\.com ]]; then
+    local tk_id
+    tk_id=$(echo "$url" | grep -oE '[0-9]{15,}' | head -1)
+    if [[ -n "$tk_id" ]]; then
+      echo "tk-${tk_id}"
+      return
+    fi
+  fi
+
+  # Fallback: base64url-encoded URL, first 16 chars
+  local b64
+  b64=$(echo -n "$url" | base64 | tr '+/' '-_' | tr -d '=' | head -c 16)
+  echo "vid-${b64}"
+}
+
+VIDEO_ID=$(extract_video_id "$URL")
+OUTPUT="${OUTPUT_DIR}/${VIDEO_ID}.mp4"
+
+# --- Dedup check ---
+
+if [[ -f "$OUTPUT" && $(stat -f%z "$OUTPUT" 2>/dev/null || stat -c%s "$OUTPUT" 2>/dev/null) -gt 0 ]]; then
+  echo "ALREADY_EXISTS: $OUTPUT"
+  exit 0
+fi
+
+# Remove zero-byte leftover from interrupted download
+[[ -f "$OUTPUT" ]] && rm -f "$OUTPUT"
+
+mkdir -p "$OUTPUT_DIR"
+
+# --- Download ---
+
+YT_DLP_ARGS=(
+  -f 'bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best'
+  --merge-output-format mp4
+  --no-playlist
+  --max-filesize 200M
+  -o "$OUTPUT"
+)
+
+echo "Downloading: $URL"
+echo "Output: $OUTPUT"
+
+if yt-dlp "${YT_DLP_ARGS[@]}" "$URL"; then
+  echo "DOWNLOADED: $OUTPUT"
+  exit 0
+fi
+
+# --- TikTok 403 retry with cookies ---
+
+if [[ "$URL" =~ tiktok\.com ]]; then
+  echo "Retrying TikTok with browser cookies..."
+  if yt-dlp "${YT_DLP_ARGS[@]}" --cookies-from-browser chrome "$URL"; then
+    echo "DOWNLOADED: $OUTPUT"
+    exit 0
+  fi
+fi
+
+echo "FAILED: Could not download $URL"
+exit 1