Tiktok Video Analyzer

# Video Analyzer Skill

Analyze any video by dropping a URL. Works with TikTok, YouTube, Instagram, Twitter/X, and 1000+ other sites. Transcribes the audio locally and answers any question about the content.

---

## When to Use This Skill

Activate when the user:
- Shares a video URL (tiktok.com, youtube.com, instagram.com, twitter.com, x.com, etc.)
- Asks "what is this video about", "summarize this", "what are they teaching", "what's the hook", etc.
- Asks a question about a previously saved video

---

## ⚠️ CRITICAL RULES — READ BEFORE ANYTHING ELSE

**Rule 1 — FIRST MESSAGE IS ALWAYS THIS, NO EXCEPTIONS:**

Use the `message` tool to send this BEFORE running any exec command:
> 📡 Video received, analyzing...

This must be a `message` tool call, not your final reply text. Using the message tool sends it immediately to the user while you continue processing. If you put it in your reply text instead, the user won't see it until everything is done — which defeats the purpose entirely.

Do NOT reference conversation history, prior testing, or anything from the current session. Every URL is treated fresh.

**Rule 2 — NEVER GO SILENT**
The user MUST receive a message every 30-60 seconds while processing. Silence = broken.
- After download step: send "📥 Downloaded! Transcribing now..."
- If anything takes more than 30 seconds: send "⏳ Still working..."

**Rule 3 — NO PERSONAL COMMENTARY. EVER.**
Do NOT add ANY of the following:
- "This appears to be the video we already tested"
- "I recognize this URL" / "you've sent this before"
- "Heads up — this is the same link"
- Any footnote, parenthetical, or aside about the URL or prior usage

Just run the skill and give the answer. End with the save prompt. Nothing else.
If the transcript is cached: say "📚 Found in your library!" then answer. That's it.

**Rule 4 — First-run warning**
If the transcripts folder is empty (first ever run), warn upfront:
> ⚠️ First time running — downloading the AI model (~150MB). Takes 2-4 min...

# 🎥 Video Analyzer — OpenClaw Skill

> Drop any TikTok, YouTube, or Instagram link → ask anything about the video → get instant answers.

Built for [OpenClaw](https://openclaw.ai) users. Works on Mac, Windows, Linux, and VPS.

---

## What It Does

You drop a video link into your OpenClaw chat. The skill downloads just the audio, transcribes it locally on your machine, and lets you ask anything about it:

> "What's the main point of this video?"
> "What formula did they teach?"
> "Summarize the first 3 tips"
> "What's the hook they used?"

You can also **save transcripts** to your personal library and ask follow-up questions later without re-downloading.

---

## 🔒 Security & Privacy

**Your data never leaves your machine.** Here's exactly what happens:

1. `yt-dlp` downloads only the **audio track** of the video to a temporary folder
2. `faster-whisper` transcribes it **locally on your CPU** — no cloud, no API calls
3. The temporary audio file is deleted automatically after transcription
4. Transcripts you choose to save go into a **local folder on your machine only**
5. Your video library never syncs anywhere

The only thing that touches the internet is downloading the video itself (same as opening it in a browser). Everything else — transcription, analysis, storage — runs entirely on your hardware.

**What we can NOT see:** Your videos, your transcripts, your questions, your library. None of it.

---

## Works With

- TikTok
- YouTube
- Instagram
- Twitter / X
- Reddit videos
- Vimeo
- 1000+ other sites (powered by yt-dlp)

---

## Install

### Mac / Local Machine

```bash
# Install dependencies (one time only)
brew install ffmpeg gh
pip3 install faster-whisper yt-dlp --break-system-packages

# Add the skill to OpenClaw
gh repo clone holl4ndtv/tiktok-analyzer ~/.openclaw/skills/tiktok-analyzer
```

### VPS / Linux Server

```bash
# Install dependencies (one time only)
apt install -y ffmpeg
pip install faster-whisper yt-dlp --break-system-packages

# Add the ski...