BibiGPT YouTube Video Summarizer

bibigpt-skill — 動画要約エージェントスキル

Claude Code · Codex · ChatGPT · OpenClaw · Cursor. bibi CLI またはホステッド MCP を使って、YouTube、Bilibili、ポッドキャスト、ローカルファイルを要約します。

BibiGPT の AI エージェントスキルです。複数のスキル、1 つの CLI（bibi）、1 つのアカウント。

スキル	使用する場面
bibi	動画を見る：要約、文字起こし、チャプター
bibi-library	保存済みの動画、メモ、コレクション、ライブラリ内検索
bibi-feed	チャンネルの登録、最新動画の取得、視聴済みとしてマーク
bibi-vision	フレーム／OCR／スライド、マインドマップ

npx skills add JimmyLv/bibigpt-skill では引き続き bibi がインストールされます（既存のオンボーディング）。--skill を使って別のスキルを追加します。

npx skills add JimmyLv/bibigpt-skill --skill bibi-library
npx skills add JimmyLv/bibigpt-skill --skill bibi-feed
npx skills add JimmyLv/bibigpt-skill --skill bibi-vision

エージェント向けの案内ページ：bibigpt.co/mcp。ホストごとの手動インストールページ：bibigpt.co/agent（ChatGPT、Claude Code、OpenClaw、WorkBuddy、Doubao Work、QwenWork、DeepSeek Harness）。

利用方法：

1. エージェントプラグイン — 1 回のインストールで、ホステッド MCP サーバーと 4 つすべてのスキルを追加します：Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot（以下を参照）
2. BibiGPT Desktop + CLI Skill — bibi CLI をインストールします。Claude Code／OpenClaw／Codex／WorkBuddy／QwenWork／Doubao Work／DeepSeek Harness で動作します
3. リモート MCP サーバー — インストール不要で、あらゆる MCP クライアント（Claude、ChatGPT、Cursor など）で動作します：https://bibigpt.co/api/mcp
4. OpenAPI — コンテナー、CI、カスタム連携向けの直接 HTTP 呼び出し

すべてのプラグインは、初回使用時に OAuth でサインインします。貼り付ける API キーは不要です。

Claude Code プラグインとしてインストール

/plugin marketplace add JimmyLv/bibigpt-skill
/plugin install bibi@bibigpt

Claude Code 2.1.275 以降では、次の 1 行でインストールできます：/plugin install bibi --marketplace JimmyLv/bibigpt-skill。

Codex プラグインとしてインストール

ターミナルから：

codex plugin marketplace add JimmyLv/bibigpt-skill
codex plugin add bibi@bibigpt

または Codex セッション内で /plugin marketplace add JimmyLv/bibigpt-skill を実行し、 /plugins のマーケットプレースタブから bibi をインストールします。Codex の IDE 拡張機能（Settings → Plugins）と ChatGPT デスクトップアプリ （Work / Codex）でも動作します。

Gemini CLI にインストール

gemini extensions install https://github.com/JimmyLv/bibigpt-skill

次に、/mcp auth bibigpt を 1 回実行します。

Cursor または GitHub Copilot にインストール

このリポジトリは Cursor プラグイン（.cursor-plugin/plugin.json + .mcp.json）であり、 GitHub Copilot 向けの Agent Plugins パッケージ（plugin.json + mcp.json）でもあります。 マーケットプレースを使わない場合は、MCP サーバーを直接追加します。

{ "mcpServers": { "bibigpt": { "url": "https://bibigpt.co/api/mcp" } } }

このサーバーは公式 MCP Registry にも io.github.JimmyLv/bibigpt として登録されています。

---

スキルの構成

skills/
├── bibi/                 # Watch: summarize / subtitle / chapter
├── bibi-library/         # Saved videos, notes, collections
├── bibi-feed/            # Channel subscribe + latest feed
└── bibi-vision/          # Frames, OCR, mind map

各ディレクトリには SKILL.md（意図とトリガー）、references/（認証、CLI）、複数ステップの手順がある場合は workflows/ が含まれます。4 つのスキルはすべて同じ bibi バイナリを呼び出します。video-cli という別の npm パッケージはありません。

skills/bibi/
├── SKILL.md                        # Watch-video router — library/feed/vision go to siblings
├── scripts/
│   └── bibi-check.sh              # Auto-detect CLI vs API mode
├── references/
│   ├── cli.md                     # CLI command reference
│   ├── api.md                     # OpenAPI endpoint reference
│   ├── endpoints.md               # Auto-generated OpenAPI dump
│   ├── installation.md            # Setup & auth guide
│   └── supported-platforms.md     # URL types & platform limits
└── workflows/
    ├── quick-summary.md           # Paste URL → get AI summary
    ├── deep-dive.md               # Chapter breakdown + follow-up Q&A
    ├── transcript-extract.md      # Subtitle/transcript extraction
    ├── article-rewrite.md         # Video → blog/公众号图文/小红书
    ├── batch-process.md           # Multi-URL batch processing
    ├── research-compile.md        # Multi-source topic synthesis
    ├── export-notes.md            # Save to Notion/Obsidian/local
    └── visual-analysis.md         # Kept as fallback; prefer skill `bibi-vision`

ワークフロー

bibi（watch-video）のワークフロー：

ワークフロー	内容	トリガーの例
クイック要約	1 つの URL → AI 要約	"summarize this video", "总结"
詳細分析	チャプターごとの要約 + Q&A	"chapter summary", "分章节总结"
文字起こしの抽出	タイムスタンプ付きの字幕原文	"get subtitles", "获取字幕"
記事への書き換え	動画 → 洗練された記事	"turn into article", "AI改写"
一括処理	複数の URL を一度に処理	"batch summarize", "批量总结"
調査の統合	複数のソースを横断した統合	"compare these videos", "综合分析"
メモのエクスポート	Notion／Obsidian／ファイルに保存	"save to Notion", "导出笔记"

残りの用途は別のスキルが担当します：bibi-library（保存済みライブラリ／メモ／コレクション）、bibi-feed（チャンネル／最新動画）、bibi-vision（フレーム／マインドマップ）。

---

クイックスタート

1. デスクトップアプリをインストールする

curl -fsSL https://bibigpt.co/install.sh | bash

macOS（Homebrew を自動的に使用）、Linux（AppImage をダウンロード）で動作し、Windows も検出して winget の使用を案内します。

または、プラットフォームごとに手動でインストールできます。

• macOS：brew install --cask jimmylv/bibigpt/bibigpt（Homebrew tap）
• Windows：winget install BibiGPT --source winget または bibigpt.co/download/desktop からダウンロード
• Linux：bibigpt.co/download/desktop から .deb / .AppImage をダウンロード

次にログインします：bibi auth login（ブラウザーで OAuth を開き、トークンを自動的に保存します）。

2. スキルをインストールする

Claude Code

npx skills add JimmyLv/bibigpt-skill

OpenClaw

npx skills add JimmyLv/bibigpt-skill --agents OpenClaw --yes

DeepSeek Harness

dsh plugin --profile web add "github:JimmyLv/bibigpt-skill#path:/dsh-plugin"

プロファイルを再起動すると、Skills の下に /bibi が表示されます。引用符はそのまま残してください。 # はシェルコメントの開始文字です。ソースとディスクにコピーする代替方法は dsh-plugin/ にあります。skills/bibi を ~/.agents/skills/bibi にコピーしても動作します（Claude Code と共有されます）。

WorkBuddy（Tencent）

ダウンロード：workbuddy.cn。スキルは ~/.workbuddy/skills/<name>/SKILL.md にあります。

npx skills add JimmyLv/bibigpt-skill -g -y

WorkBuddy のカスタムスキルでは、SKILL.md のフロントマターに agent_created: true が必要です（このリポジトリには含まれています）。その後、/reload-skills を実行するか、アプリを再起動してください。

代替方法：skills/bibi を ~/.workbuddy/skills/bibi にコピーします。

手順：https://bibigpt.co/agent/workbuddy

豆包工作 / Doubao Work

デスクトップアプリをダウンロード：doubao.com/download/desktop。 Doubao Work にはファイルシステム上のスキルディレクトリが公開されていません。~/.doubao/skills を作成しないでください。

デスクトップのサイドバーで 技能 · 连接器 · 伙伴 を開き、bibi という名前のスキルを作成して、 skills/bibi/SKILL.md を貼り付けます。

手順：https://bibigpt.co/agent/doubao

千问工作 / QwenWork

アプリ：qwenwork.cn。スキルディレクトリ：~/.qwenworkcn/skills/。 以下を QwenWork に貼り付けます。

Please download https://github.com/JimmyLv/bibigpt-skill and copy skills/bibi to ~/.qwenworkcn/skills/bibi

QwenWork はチャットからスキルをクローンして読み込みます。ドキュメント： https://help.aliyun.com/zh/qwenwork/skills

手順：https://bibigpt.co/agent/qwenwork

3. 使い方

エージェントに、動画、音声 URL、またはローカルファイルの要約を依頼します。

> Summarize this video: https://www.youtube.com/watch?v=xxxxx
> Summarize this local file: /path/to/meeting-recording.mp4

エージェントが最適なモードを自動的に検出し、適切なワークフローに振り分けます。

コマンド

コマンド	説明
bibi summarize "<URL>"	動画／音声 URL を要約します
bibi summarize "/path/to/file.mp4"	ローカルの音声／動画ファイルを要約します
bibi summarize "<INPUT>" --async	非同期モード（長時間の動画向け）
bibi summarize "<INPUT>" --chapter	チャプターごとに要約します
bibi summarize "<INPUT>" --subtitle	字幕／トランスクリプトのみを取得します
bibi summarize "<INPUT>" --json	完全な JSON 出力
bibi auth check	認証状態を確認します
bibi auth login	ブラウザーで OAuth ログインします（トークンを自動的に保存します）
bibi check-update	新しいバージョンを確認します
bibi upgrade	最新バージョンをダウンロードしてインストールします（エイリアス：self-update）

---

更新

BibiGPT には、個別に更新できるレイヤーが3つあります。更新したい内容に合ったものを選んでください。

レイヤー	更新内容	コマンド	実行するタイミング
スキルコンテンツ（ワークフロー、リファレンス、インテントルーター）	npm 配布、手動	npx skills update JimmyLv/bibigpt-skill	週次、または変更履歴に新しい MCP ツール／ワークフローが追加されたとき
bibi デスクトップ CLI（バイナリ＋埋め込み SKILL.md＋マニフェストディスパッチャー）	セルフアップデートまたはパッケージマネージャー	bibi upgrade (または brew upgrade --cask bibigpt / winget upgrade BibiGPT)	変更履歴に CLI の変更が記載されたとき
リモート MCP サーバー（https://bibigpt.co/api/mcp）	常に最新、サーバー側	自動 — 新しいツールを利用するには MCP クライアントを再起動します	手動での更新は不要です。サーバー側で自動的に反映されます

スキルを更新する

npx skills update JimmyLv/bibigpt-skill

このスキルは自動更新されません。エージェントは、最後に取得した内容を読み込みます。新しい BibiGPT の機能、修正されたワークフロー、新たに追加された MCP ツールを反映したいときは、もう一度実行してください。クリーンインストールするには、次のコマンドを実行します。

npx skills remove JimmyLv/bibigpt-skill && npx skills add JimmyLv/bibigpt-skill

GitHub Releases ページで、各バージョンの変更内容を確認できます。

bibi CLI を更新する

bibi check-update    # peek at the latest published version
bibi upgrade         # download and install (uses brew on macOS, installer on Windows)

または、パッケージマネージャーから更新します：brew upgrade --cask bibigpt ／ winget upgrade BibiGPT --source winget ／ bibigpt.co/download/desktopから新たにダウンロードします。

マニフェストはホットキャッシュされ、組み込まれてはいません。 bibi upgradeを実行しなくても、CLI ディスパッチャーは最初の呼び出し時にhttps://bibigpt.co/api/cli-manifest.jsonを取得します（TTL は24時間）。新しくリリースされたエージェントの手順は、翌日には利用できるようになります。bibi upgradeが必要なのは、ディスパッチャー自体または組み込みのSKILL.mdが変更された場合のみです。

MCP サーバーを更新する

更新は不要です。リモート MCP エンドポイントは、常に最新のmeta.mcp.enabledツールリストを提供します。新しくリリースされたツールが表示されない場合は、MCP クライアントを再起動してください（Claude Desktop、Cursor など）。これにより、クライアントのtools/listキャッシュが更新されます。

注：デスクトップアプリのビルドは、GitHub Actions のbuild-tauri-desktop-appワークフローを通じて実行されます。ビルドが成功すると、アーティファクトが OSS にアップロードされ、latest.jsonマニフェストが自動的に更新されます。クライアントは、このマニフェストを確認してアップデートの有無を判断します。

---

リモート MCP サーバー（インストール不要）

BibiGPT はhttps://bibigpt.co/api/mcpにリモート MCP サーバーも提供しています。MCP 対応のクライアントなら、どれでも利用できます。OAuth 2.1 認証を使用したストリーミング可能な HTTP トランスポートに対応しています。

利用可能なツール

ツール	説明
summarize_video	動画またはポッドキャストの URL を要約します
summarize_video_with_config	カスタムプロンプト、モデル、言語を指定して要約します
summarize_by_chapter	チャプターごとに要約します
get_subtitle	タイムスタンプ付きの文字起こし／字幕を取得します
create_summary_task	長時間の動画向けに非同期タスクを作成します
get_task_status	非同期タスクのステータスを確認します

Claude Code

プロジェクトのルートにある.mcp.jsonに追加します。

{
  "mcpServers": {
    "bibigpt": {
      "type": "http",
      "url": "https://bibigpt.co/api/mcp"
    }
  }
}

または、CLI から追加します。

claude mcp add --transport http bibigpt https://bibigpt.co/api/mcp

OpenAI Codex

~/.codex/config.toml（またはプロジェクトのルートにある.codex/config.toml）を編集します。

[mcp_servers.bibigpt]
url = "https://bibigpt.co/api/mcp"

API キー認証を使用する場合：

[mcp_servers.bibigpt]
url = "https://bibigpt.co/api/mcp"
bearer_token_env_var = "BIBIGPT_API_KEY"

Claude Desktop

方法 A — UI（推奨）：Settings → Connectors → Add Connector → https://bibigpt.co/api/mcpを貼り付けます。

方法 B — 設定ファイル（macOS の場合は~/Library/Application Support/Claude/claude_desktop_config.json、Windows の場合は%APPDATA%\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "bibigpt": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://bibigpt.co/api/mcp"]
    }
  }
}

Cursor

プロジェクトのルートにある.cursor/mcp.jsonに追加するか、Cursor Settings → MCP で設定します。

{
  "mcpServers": {
    "bibigpt": {
      "url": "https://bibigpt.co/api/mcp",
      "type": "streamable-http"
    }
  }
}

VS Code（GitHub Copilot）

ワークスペースに.vscode/mcp.jsonを追加します。

{
  "servers": {
    "bibigpt": {
      "type": "http",
      "url": "https://bibigpt.co/api/mcp"
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.jsonに追加します。

{
  "mcpServers": {
    "bibigpt": {
      "serverUrl": "https://bibigpt.co/api/mcp"
    }
  }
}

ChatGPT

1. Settings → Apps & Connectors → Advanced settings → Developer modeを有効にします
2. Settings → Apps & Connectors → Create connectorを選択します
3. URL にhttps://bibigpt.co/api/mcpを入力します
4. プロンプトが表示されたら、OAuth 認証を完了します

Manus

Settings → Connectors → Add Connectors → Custom MCP → +Add Custom MCP を選択します。

サーバー URL を入力します：https://bibigpt.co/api/mcp

LobeChat

Settings → Plugin Settings → Custom Plugins → Quick Import JSON を選択します。

{
  "type": "mcp:streamable-http",
  "url": "https://bibigpt.co/api/mcp",
  "metadata": {
    "title": "BibiGPT",
    "description": "AI Video & Audio Summarizer"
  }
}

API キーを直接使用する（OAuth を省略）

BibiGPT の API キーをお持ちの場合は、OAuth を省略して Bearer トークンを直接使用できます。

# List available tools (no auth needed for discovery)
curl -X POST https://bibigpt.co/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Summarize a video (requires auth)
curl -X POST https://bibigpt.co/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"summarize_video","arguments":{"url":"https://www.youtube.com/watch?v=xxxxx"}}}'

API キーは bibigpt.co/user/integrationで取得できます。

ライセンス

MIT