# Video Extract

Video Extract — an MCP server that downloads videos from YouTube, TikTok, WeChat and hundreds of other platforms, extracts transcripts and keyframes. Everything runs locally, no API keys.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12 repo stars
- Author: yanlingLabs
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/yanlingLabs/video-extract-mcp
- Updated: 2026-10-21
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/video-extract

## What it does

The server takes a video link — YouTube, TikTok, Instagram, X, Facebook, Twitch, Vimeo, Reddit, WeChat Channels, a direct `.mp4` or `.m3u8` — and downloads the entire file or just the section you specify by timecode. It then extracts a transcript: first attempts to fetch published captions from the platform, and if none exist, performs local speech recognition via Whisper or SenseVoice. Keyframes are selected by scene boundaries, sharpness, on-screen text appearance and visual similarity — instead of thousands of near-identical stills, the agent receives a few dozen meaningful frames.

For private or age-restricted videos, you can provide browser cookies — the server will pass access checks and download content unavailable anonymously. Long tasks run in the background and report progress over HTTP, even if the client stops waiting.

Requires `ffmpeg`, `ffprobe`, `yt-dlp`, Deno, `tesseract` with Chinese language data, and Node ≥ 22.12 in `PATH`. Without them, the server will not start.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `VIDEO_EXTRACT_COOKIES_FROM_BROWSER`, `VIDEO_EXTRACT_MODELS_DIR`, `VIDEO_EXTRACT_MAX_CONCURRENCY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env VIDEO_EXTRACT_COOKIES_FROM_BROWSER=<VIDEO_EXTRACT_COOKIES_FROM_BROWSER> --env VIDEO_EXTRACT_MODELS_DIR=<VIDEO_EXTRACT_MODELS_DIR> --env VIDEO_EXTRACT_MAX_CONCURRENCY=<VIDEO_EXTRACT_MAX_CONCURRENCY> --transport stdio video-extract -- npx -y @yanlinglabs/video-extract-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add video-extract --env VIDEO_EXTRACT_COOKIES_FROM_BROWSER=<VIDEO_EXTRACT_COOKIES_FROM_BROWSER> --env VIDEO_EXTRACT_MODELS_DIR=<VIDEO_EXTRACT_MODELS_DIR> --env VIDEO_EXTRACT_MAX_CONCURRENCY=<VIDEO_EXTRACT_MAX_CONCURRENCY> -- npx -y @yanlinglabs/video-extract-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "video-extract": {
            "command": "npx",
            "args": [
                "-y",
                "@yanlinglabs/video-extract-mcp"
            ],
            "env": {
                "VIDEO_EXTRACT_COOKIES_FROM_BROWSER": "<VIDEO_EXTRACT_COOKIES_FROM_BROWSER>",
                "VIDEO_EXTRACT_MODELS_DIR": "<VIDEO_EXTRACT_MODELS_DIR>",
                "VIDEO_EXTRACT_MAX_CONCURRENCY": "<VIDEO_EXTRACT_MAX_CONCURRENCY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "video-extract": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@yanlinglabs/video-extract-mcp"
            ],
            "env": {
                "VIDEO_EXTRACT_COOKIES_FROM_BROWSER": "<VIDEO_EXTRACT_COOKIES_FROM_BROWSER>",
                "VIDEO_EXTRACT_MODELS_DIR": "<VIDEO_EXTRACT_MODELS_DIR>",
                "VIDEO_EXTRACT_MAX_CONCURRENCY": "<VIDEO_EXTRACT_MAX_CONCURRENCY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e VIDEO_EXTRACT_COOKIES_FROM_BROWSER=<VIDEO_EXTRACT_COOKIES_FROM_BROWSER> -e VIDEO_EXTRACT_MODELS_DIR=<VIDEO_EXTRACT_MODELS_DIR> -e VIDEO_EXTRACT_MAX_CONCURRENCY=<VIDEO_EXTRACT_MAX_CONCURRENCY> video-extract npx -y @yanlinglabs/video-extract-mcp
```
Replace <…> with your own values

## When to use it
- download videos from YouTube, TikTok, Instagram, WeChat Channels and hundreds of other platforms
- get a video transcript — published captions or local speech recognition
- extract keyframes by scene changes and text appearance, without duplicates
- download private or restricted videos using browser cookies
- run long video analysis in the background with progress reports

## Example prompts
- Download the video from this link and give me the transcript
- Extract keyframes from the video in `lecture.mp4`
- Get video information — title, creator, duration and chapter list — without downloading

## Similar
- [Video URL Analyzer](https://affpapa.org/en/nevibecode/mcp/video-url-analyzer.md) — MCP server · ★ 5 repo stars
- [claude-video-vision](https://affpapa.org/en/nevibecode/plugins/claude-video-vision.md) — plugin · ★ 1523 repo stars
- [video-lens](https://affpapa.org/en/nevibecode/skills/video-lens.md) — skill · 1500 installs
- [video-subtitle-cutter](https://affpapa.org/en/nevibecode/skills/video-subtitle-cutter.md) — skill · 1 install
- [varg-music-video](https://affpapa.org/en/nevibecode/skills/varg-music-video.md) — skill · ★ 1596 repo stars
- [watch-video](https://affpapa.org/en/nevibecode/plugins/watch-video.md) — plugin · ★ 9 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
