BibiGPT AI video & audio summarizer

bibigpt-skill — 视频摘要 Agent 技能

Claude Code · Codex · ChatGPT · OpenClaw · Cursor。 通过 bibi CLI 或托管 MCP 总结 YouTube、Bilibili、播客和本地文件。

适用于 BibiGPT 的 AI Agent 技能。多个技能，一个 CLI（bibi），一个账户。

技能	适用场景
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

Agent 入口：bibigpt.co/mcp。各主机的手把手安装页面：bibigpt.co/agent（ChatGPT、Claude Code、OpenClaw、WorkBuddy、Doubao Work、QwenWork、DeepSeek Harness）。

使用方式：

1. Agent 插件 — 一次安装即可添加托管 MCP 服务和全部 4 个技能：Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot（见下文）
2. BibiGPT Desktop + CLI 技能 — 安装 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 — 通过直接 HTTP 调用，用于容器、CI 或自定义集成

每个插件首次使用时都会通过 OAuth 登录——无需粘贴 API 密钥。

安装为 Claude Code 插件

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

在 Claude Code 2.1.275 或更高版本中，只需一行：/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 的 marketplace 标签页中安装 bibi。也适用于 Codex IDE 扩展（Settings → Plugins）和 ChatGPT 桌面应用 （Work / Codex）。

在 Gemini CLI 中安装

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

然后运行一次 /mcp auth bibigpt。

在 Cursor 或 GitHub Copilot 中安装

此仓库也是一个 Cursor 插件（.cursor-plugin/plugin.json + .mcp.json），也是面向 GitHub Copilot 的 Agent Plugins 软件包（plugin.json + mcp.json）。 如果没有 marketplace，可直接添加 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/。四个技能都调用同一个 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）工作流：

工作流	功能	触发示例
快速摘要	一个 URL → AI 摘要	"summarize this video", "总结"
深入分析	按章节总结 + 问答	"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。请保留引号 — # 会开始一行 shell 注释。源代码和复制到磁盘的替代方案位于 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 frontmatter 中设置 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. 使用方法

让你的 Agent 总结任意视频、音频 URL 或 本地文件：

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

Agent 会自动检测最合适的模式，并调用相应的工作流。

命令

命令	说明
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 提供 三个可独立更新的层。根据需要更新的内容选择相应层。

层	更新方式	命令	运行时机
技能内容（工作流、参考资料、意图路由器）	通过 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

该技能不会自动更新——Agent 会读取上次获取的内容。需要使用新的 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 小时）——新发布的 Agent 流程会在次日显示。只有分发器本身或嵌入的 SKILL.md 发生变化时，才需要运行 bibi upgrade。

更新 MCP 服务

无需操作——远程 MCP 端点始终提供最新的 meta.mcp.enabled 工具列表。如果看不到新发布的工具，请重启 MCP 客户端（Claude Desktop、Cursor 等），以刷新其 tools/list 缓存。

注意：桌面应用构建通过 build-tauri-desktop-app GitHub Actions 工作流触发。构建成功后，构建产物会上传到 OSS，并自动更新 latest.json 清单——客户端会检查该清单以确认是否有可用更新。

---

远程 MCP 服务（无需安装）

BibiGPT 还在 https://bibigpt.co/api/mcp 提供远程 MCP 服务，可与任何兼容 MCP 的客户端配合使用。采用 Streamable HTTP 传输，并使用 OAuth 2.1 进行身份验证。

可用工具

工具	描述
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——通过界面（推荐）：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"}}}'

在 bibigpt.co/user/integration 获取 API 密钥。

许可证

MIT