Video Material DB（動画素材セマンティックデータベース）

ショート動画の研究とおり

Video Material DB（動画素材セマンティックデータベース）

ショート動画の研究・創作のためのローカルファーストな知識ベースです。動画、字幕、AIによる構造化をPostgreSQLに一元的に保存し、Web インターフェース、REST API、MCP ツールから自然言語で検索できます。素材と分析データはデフォルトでユーザー自身の実行環境に保存されます。

主な機能

• ローカルファイル、フォルダ、または公開動画リンクから素材をインポートします。

• 抖音、TikTok、YoTube、B站などのプラットフォームからクリエイターの動画リストを収集します。

• 動画の前処理、音声の文字起こし、キーフレームの抽収、視覚分析を自動的に行います。

• 人物、シーン、カット、字幕、ストーリー構造、笑いところ、改国型の提案を抽収します。

• pgvectorを用いてセマンティックインデックスを構築し、自然言語で動画、手話、ストーリー要素を検索します。

• FastAPI のWeb インターフェースで素材とバックグラウンドタスターを管理します。

• MCP 経由で Codex などの AI ッールと接続します。

• 素材の電複除去、非同期処理、失敗時の再試行、一括エクスポツートをサポーします。

用シーン

• ショート動画の脚本シェーターがストーリー、字幕、笑いところ、返し、カットの参考を検索します。

• コンテンツ チームが検索可能な動画ケース・ライブラリとクリエイティブ知識ベースを構築します。

• 人気クリエイターのコンテンテ構造、物語のテンポ、視覚表現を分析します。

• 大量の参考動画から、再利用可能な作パターンを発見します。

• AI アシスタントに、構造化され追跡可能な動画研究資料を提供します。

技術構成

• Python 3.11+

• FastAPI

• PostgreSQL + pgvector

• MCP Server

• ffmpeg / ffprobe

• 通义千问互換インターフェース（ASR、画像分析、ベクトル埋め込る）

クイックスタート

完全なインストール手順は INSTALL.md を参照して下さい。素材はデフォルトで、プロジェクトのローカルディレクトリ ./data に保存されます。

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

データベースを起動した後、Web サービスとバックグラウンド分析タスターをそれぞれに実行します。

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

ブラウザで http://127.0.0.1:8000/ を開いてください。

MCP 過入

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

利用可能なツールは、add_video_url、add_local_video、search_videos、search_dialogue、search_jokes、search_story_structure、get_video_detail が含まれます。

データとセキュリティ

公開リポジトリにはプロセス・ソース・コーードのみが含まれます。.env、API キー、動画ファイル、データベース内容、バックアウプ、ローカルマシーン、および各人データはバージョン管理の対象外です。