English Français العربية

io.github.BrightWayAI/video-analyzer

السجل الرسمي الوسائط والتصميم

Analyze videos: extract frames, transcribe audio, generate storyboard breakdowns.

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع io.github.BrightWayAI/video-analyzer؟

  • Frame Extraction — Scene-detection-based keyframe selection (or fixed intervals)
  • Audio Transcription — Timestamped transcription via OpenAI Whisper
  • Visual Analysis — Per-frame descriptions using Claude Vision
  • Stylistic Fingerprint v3 — 8-field deterministic classification (rendering class, world type, character strategy, narrative structure, visual abstraction, visual density, camera language, tonal positioning)
  • Storyboard Output — Combined shot-by-shot breakdown as .docx or .md

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package video-analyzer-mcp
Claude Code 
claude mcp add video-analyzer -- uvx video-analyzer-mcp==0.1.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "video-analyzer": {
            "command": "uvx",
            "args": [
                "video-analyzer-mcp==0.1.2"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Video Analyzer
  2. Features
  3. MCP Server
  4. Standalone Usage
  5. Prerequisites
  6. Stylistic Fingerprint Fields
  7. License

Video Analyzer

Analyze videos and generate storyboard breakdowns. Extracts frames via scene detection, transcribes audio with Whisper, analyzes visuals with Claude Vision, and computes 8-field stylistic fingerprints.

Features

  • Frame Extraction — Scene-detection-based keyframe selection (or fixed intervals)
  • Audio Transcription — Timestamped transcription via OpenAI Whisper
  • Visual Analysis — Per-frame descriptions using Claude Vision
  • Stylistic Fingerprint v3 — 8-field deterministic classification (rendering class, world type, character strategy, narrative structure, visual abstraction, visual density, camera language, tonal positioning)
  • Storyboard Output — Combined shot-by-shot breakdown as .docx or .md

MCP Server

This project includes an MCP (Model Context Protocol) server so you can use video analysis directly from Claude Desktop or Claude Code.

Install via Claude Code
claude mcp add video-analyzer -s user -- uvx video-analyzer-mcp
Install via Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "video-analyzer": {
      "command": "uvx",
      "args": ["video-analyzer-mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "your-key-here"
      }
    }
  }
}
MCP Tools
ToolDescription
video_analyzeFull pipeline: download, extract frames, transcribe, analyze, fingerprint, storyboard
video_extract_framesExtract representative frames using scene detection or fixed intervals
video_transcribeTranscribe audio with OpenAI Whisper
video_fingerprintGenerate 8-field Stylistic Fingerprint v3 classification
video_check_depsVerify all required dependencies are installed

Standalone Usage

pip install -r requirements.txt
python3 analyze_video.py "https://youtube.com/watch?v=..." --output-dir ./output

Prerequisites

  • Python 3.10+
  • FFmpeg — brew install ffmpeg (macOS) or apt-get install ffmpeg (Linux)
  • ANTHROPIC_API_KEY — set as an environment variable

Stylistic Fingerprint Fields

  1. Rendering Class — Stylized 3D, Flat 2D, Minimalist Line Art, Textured 2D, Mixed Media, Photoreal
  2. World Type — Stylized Real-World, Abstract Concept Space, Data/Presentation Space, Fictional Metaphor Universe
  3. Character Strategy — None, Mascot-Led, Single Narrator, Single Protagonist Arc, Ensemble Cast
  4. Narrative Structure — Direct Explanation, Step-by-Step, Problem-Solution, Analogy, Myth-Busting, etc.
  5. Visual Abstraction Index — 1 (Photorealistic) to 5 (Maximum Abstraction)
  6. Visual Density — Minimal, Sparse, Moderate, High
  7. Camera/Editing Language — Cinematic, Social Vertical Punch, Presentation Deck, Static Slides, etc.
  8. Tonal Positioning — Institutional, Corporate Professional, Gen Z Social, Child-Friendly, Dark Editorial

License

MIT

الأسئلة الشائعة

ما هو io.github.BrightWayAI/video-analyzer؟

Analyze videos: extract frames, transcribe audio, generate storyboard breakdowns.

كيف أثبّت io.github.BrightWayAI/video-analyzer؟

يعمل على جهازك. في Claude Code: claude mcp add video-analyzer -- uvx video-analyzer-mcp==0.1.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.BrightWayAI/video-analyzer إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.BrightWayAI/video-analyzer مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.BrightWayAI/video-analyzer؟

ينشره BrightWayAI. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.