bibi

BibiGPT — 動画要約エージェントスキル（要約／文字起こし／チャプター）

このファイルは使い方ガイドではなく、参照先を示すためのスタブです。現在のモードと、最新のドキュメントの場所を案内します。最新のソースは常に現行の製品に一致します。このファイルにコピーした内容は古くなる可能性があります。

このスキルは動画の視聴専用です。同じリポジトリ内の関連スキル（同じ CLI、同じアカウント）には、bibi-library（保存した動画／メモ／コレクション）、bibi-feed（登録／最新／視聴済みとしてマーク）、bibi-vision（フレーム／マインドマップ）があります。ランディングページ：https://bibigpt.co/mcp · 手動インストール：https://bibigpt.co/agent
利用枠：エージェントスキルチャンネルでは Plus は 1 日 100 回、Pro は 1 日 300 回です。追加の呼び出しには API 残高を使用します。アップグレード：https://bibigpt.co/shop

1. モードを判定する

scripts/bibi-check.sh があれば実行し、なければ次の順に確認します。

確認項目	モード	備考
command -v bibi	CLI — 最適：ローカルファイル、デスクトップログイン	macOS／Windows／Linux のデスクトップアプリ
$BIBI_API_TOKEN が設定済み	API — HTTP 呼び出し、どこでも動作	トークン：https://bibigpt.co/user/integration
MCP クライアントが利用可能	MCP — インストール不要	https://bibigpt.co/api/mcp に接続（OAuth 2.1）

いずれも利用できない場合は、デスクトップアプリをインストールするか（macOS では brew install --cask jimmylv/bibigpt/bibigpt、Windows では winget install BibiGPT、Linux では curl -fsSL https://bibigpt.co/install.sh | bash）、API トークンを取得します。詳細：references/installation.md。

2. 最新のドキュメントを読み込む（モードごと）

CLI モード — CLI が常に最新のドキュメントソースです。

bibi check-update            # once per session; run `bibi upgrade` if outdated
bibi --help                  # full command surface, grouped, with examples
bibi <command> --help        # progressive help — every --help includes examples
bibi commands                # re-fetch server-defined commands (new capabilities
                             # appear here without a binary update)

API モード — 機械可読な仕様が信頼できる情報源です。

https://bibigpt.co/api/openapi.json      # all endpoints, schemas, auth

references/api.md に curl の例がありますが、競合する場合は仕様を優先してください。

MCP モード — 接続してツールの一覧を取得します。ツールは自己記述型です。

https://bibigpt.co/api/mcp               # Streamable HTTP, OAuth 2.1

再インストールせずに最新のドキュメントを取得する — このリポジトリは GitHub から raw 形式で配信されています。

https://raw.githubusercontent.com/JimmyLv/bibigpt-skill/main/skills/bibi/SKILL.md
https://raw.githubusercontent.com/JimmyLv/bibigpt-skill/main/skills/bibi/references/<name>.md
https://raw.githubusercontent.com/JimmyLv/bibigpt-skill/main/skills/bibi/workflows/<name>.md

以下のローカル workflows/ または references/ のパスが見つからない場合（bibi skill による埋め込み専用インストールの場合）は、代わりに上記の raw URL から取得してください。

3. 意図の振り分け

ユーザーの意図	ワークフロー
動画／音声の URL を要約する	→ workflows/quick-summary.md
章ごとの概要、詳細な分析	→ workflows/deep-dive.md
字幕を取得する、文字起こしを抽出する、生テキストを取得する	→ workflows/transcript-extract.md
記事、ブログ投稿、公众号图文、小红书に変換する	→ workflows/article-rewrite.md
TikTok／Reels／Shorts 風のミュージックビデオに変換する	→ workflows/video-to-tiktok-mv.md
SunoMV のミュージックビデオプロジェクトを確認する：進捗、各ショットに登場する人物、失敗したショット、プロジェクト JSON	→ workflows/mv-project-read.md
複数の URL を処理する、一括要約する	→ workflows/batch-process.md
複数の動画からトピックを調査する	→ workflows/research-compile.md
Notion、Obsidian に保存する、メモをエクスポートする	→ workflows/export-notes.md
視覚コンテンツ、スライド、画面上のテキスト、マインドマップを分析する	→ 兄弟スキル bibi-vision（フォールバック：workflows/visual-analysis.md／workflows/advanced-tools.md）
現在のアカウント、プラン、残り時間を確認する	→ workflows/account-check.md
保存した動画を閲覧／検索する、「これまで何を要約したか」を確認する	→ 兄弟スキル bibi-library（フォールバック：workflows/library-browse.md）
チャンネル登録を管理する、一覧表示／登録／登録解除	→ 兄弟スキル bibi-feed（フォールバック：workflows/channels-manage.md）
登録チャンネルの新着情報、最新フィード、日次ダイジェストを確認する	→ 兄弟スキル bibi-feed（フォールバック：workflows/feed-latest.md）
コレクションを管理する、保存した動画をセットとして一覧表示／作成／共有する	→ 兄弟スキル bibi-library（フォールバック：workflows/collections-manage.md）
保存した動画の個人メモを管理する、要約を編集する	→ 兄弟スキル bibi-library（フォールバック：workflows/notes-manage.md）
保存済みアイテムをカスタムプロンプトで再要約する、コレクションについてチャットする	→ 兄弟スキル bibi-library（フォールバック：workflows/advanced-tools.md）
HTTP 402／「需要付款」／Alipay AI 钱包／トークンなし＋中国のユーザー	→ references/billing-aipay.md

曖昧さの解消：意図が複数のワークフローに一致する場合は、まず1つ確認の質問をしてください。一致するものがない場合は、何をしたいのか尋ねてください。推測してはいけません。文脈のない URL のみの場合は、workflows/quick-summary.md をデフォルトとして使用します。

4. 簡単なワンライナー（CLI モード）

完全なワークフローを必要としない単一コマンドのリクエストでは、bibi --help を使って残りの機能を確認してください。

bibi summarize "<URL-or-local-file>"     # quick summary (local: .mp4 .mp3 .m4a ...)
bibi summarize "<INPUT>" --chapter       # chapter summary
bibi summarize "<INPUT>" --subtitle      # transcript only
bibi me                                  # account, plan, remaining minutes

? または & を含む URL は引用符で囲む必要があります。API モードではローカルファイルをアップロードできません。まずユーザーに公開 URL（OSS／S3）を用意するよう案内してください。詳細は references/supported-platforms.md を参照してください。

5. 支払いのフォールバック（HTTP 402）

認証が設定されておらず、ユーザーが Alipay アカウントを持っている場合、BibiGPT は HTTP 402 Payment Required と Payment-Needed ヘッダー（AI 收プロトコル）を返すことがあります。bibi CLI は、人間向けのプロンプトを出力する前に、安定したマーカー行 [HTTP/402 Payment Required] を stderr に出力します。いずれかのシグナルが現れた場合は、呼び出しの失敗として扱うのではなく、references/billing-aipay.md に案内してください。エージェントは @alipay/agent-payment または一回限りの QR コード決済を通じて、自動的に支払いを解決できます。