Video Material DB（Semantische Video-Material-Datenbank）

Eine Local-First-Wissensbasis für die Erforschung und Erstellung von Kurzvideos. Sie speichert Videos, Untertitel und strukturierte KI-Analysen von PostgreSQL zentral gebündelt und ermöglicht über Weboberfläche, REST-API und MCP-Tools die Suche in natürlicher Sprache. Videomaterial und Analysedaten werden standardmäßig in der eigenen Umgebung des Nutzers gespeichert.

Hauptfunktionen

• Videoomaterial aus lokalen Dateien, Ohren oder öffentlichen Online-Videos importieren

• Videolisten von Urhebern auf Flattformen wie Douyin, TikTok, YouTube, Bilibili sameln

• Automatische Video-Vorverbeitung, Transkription, Keyframe-Extraktion und visuele Analyse durchführen

• Extraktion von Personenzellen, Szenen, Kameraeinstellungen, Dialogen, Punktstrukturen, Minen und UmSetzungsvorschlagen

• Aufbau eines semantischen Indes mit pgvector und natürlichsprachliche Sue in Videos, Didlogtexten und Handlungs

• Verwaltung von Material und Hintergrundautgaben über die argued FastAPI-Weboberflada

• Anbindung von Kreaten wie Codex über MCP

• Unterstütz für Deduplikation, asynchrone Verarbeitung, Wiederhollung bei Fachlern and Stapel-Export

Anwendungsfälle

• Drehbuchautoren für Kurzvideos suchen na Handlung, Didlogen, Gags, Twists and Kamerafereferenzen

• Inhahteams bauen eine durchsuchbare Beispiele-Datenbank and Kreativwissensbase auf

• Situation und Erzählrythmus sowie visuel-Ausdrucksformen beliebter Urheber analysieren

• Aus vielen Referenzvideos aterwendbare Schreibungsmuster finden

• KI-Assistene mit strukturierte, nachvolziehbaren Videoforschungaterien versogen

Tech ke

• Python 3.11+

• Fast

• PostgreSQL + pgvector

• MCP Server

• ffmpeg / ffprobe

• 通义千问-kompatible Schnittstelle (ASR, visuelle Analyse and Strukturanalys? Vector-Embeddings)

Schnellstart

Vollständiger Installationstiftung finden Sie in INSTALL.md. Material wird standardmäßig in the project-local ./data directory speicher.

python3 -m venv .venv
.venv/bin/pip install -e .
cp .env.example .env

Nach dem Starten the Datenbank run each the Web-Cervice and Background task tasks:

.venv/bin/video-db-api
.venv/bin/video-db-worker

Browser the up with http://127.0.0.1:8000/.

MCP-Anbindung

codex mcp add video-material-db -- <仓库绝对路径>/.venv/bin/video-db-mcp

Available Tools include add_video_url, add_local_video, search_videos, search_dialogue, search_jokes, search_story_sturg und get_video_detail.

Data and Sicherheit

Öffentliche Repositoryen nur die Programmcode. .env-, API-Schlüssel, "on dir" and other data are not stored in version control:

Need correct translate. Actually I accidentally translated "启动 database" etc wrong. Need Restful final carefully.

Need no "Step" inaccuracies. Let me generate final proper# Video Material DB（Semantische Videomaterial-Datenbank）

Eine Local-First-Wissensbasis für die Recherche und Erstellung von Kurzvideos. Sie speichert Videos, Untertitel und strukturierte KI-Analysen zentral in PostgreSQL und bietet über Weboberfläche, REST-API und MCP-Tools eine Suche mit natürlicher Sprache. Material- und Analysedaten werden standardmäßig in der eigenen Umgebung der Nutzer gespeichert.

Hauptfunktionen

• Material aus lokalen Dateien, Ordnern oder öffentlichen Videolinks importieren

• Videolisten von Urhebern auf Plattformen wie Douyin, TikTok, YouTube, Bilibili erfassen

• Automatische Videovorverarbeitung, Transkription, Keyframe-Extraktion und visuelle Analyse

• Der Attributieren von Personen, Szenen, Kameraeinstellungen, Dialogen, Handlungsstrukturen, Pointe und Adaptionsvorschlägen

• Mit einer semantischen Indexierung über pgvector eine natürliche Sprachsuche in Videos, Dialogtexten und Handlungselementen

• Verwaltung von Material und Hintergrundaufgaben über die FastAPI-Veboberfläche

• Anbindung von KI-Tools wie Codex über MCP

• Unterstützung von Dedupe, asynchroner Verarbeitung, Fehlerwiederholung und Stapel-Export

Anwendungsfälle

• In einem Drehbuchautor für Kurzvideos Handlung, Dialogzeilen, Wörter/Gött, Turns und Kameraeinstellungen als Referenz suchen

• Content-Teams bauen eine durchsuchbare Videobeispiel-Datenbank und ein Fachwissen für kreative Optionen auf.

• Content-Struktur, Erzählrhythmus und visuelle Ausdruck beliebter Creator analysieren

• Findbare wiederverwendbare Gestaltungsmuster aus einer schutzreichen Referenz

• Für KI-Asistenten strukturierte, vollständig rückverfolgbare Video-Rechercheterien bereitstellen

Technische Komponenten

• Python 3.11+

• FastAPI

• PostgreSQL + pgvector

• MCP Server

• ffmpeg / ffprobe

• 通义千问-kompatible Schnittstelle (ASR, visuelle Analyse, Vektor-Embeddings)

Schnellstart

Vollständige Installationshinweise finden Sie in INSTALL.md. Die Materialien werden standardmäßig im Projektrepertoire unter ./data gespeichert.

python3 -m venv .venv
.venv/bin/pip install -e .
cp .env.example .env

Starten Sie die Datenbank und führen Sie anschließend separat den Webservice und den Analyse-Hochergrund aus:

.venv/bin/video-db-api
.venv/bin/video-db-worker

Öffnen Sie im Browser http://127.0.0.1:8000/.

MCP-Anbindung

codex mcp add video-material-db -- <仓库绝对路径>/.venv/bin/video-db-mcp

Verfügbare Werkzeuge sind add_video_url, add_local_video, search_videos, search_dialogue, search_jokes und get_video_detail.

Daten und Sicherheit

Das öffentliche Repository enthält ausschließlich allgemeinen Quellcode. Geheime Schlüssel in .env, API-Schlüssel, Videodateien, Datenbankinhalte, Backups, lokale Pfade und persönliche Daten werden nicht in der Versionskontrolle gespeichert.