bilibili-collection-downloader は何をしますか?
Bilibili クリエイターの動画をコレクションごとに分類・アーカイブ。QRコードログイン・増分更新対応。Claude/AIエージェントのスキルとして即利用可能。
概要
このツールは、指定されたBilibiliクリエイターの全動画をコレクション(再生リスト)ごとにローカルディレクトリにダウンロード・アーカイブします。QRコードログインによる認証をサポートし、増分更新(前回実行時以降の新しい動画のみをダウンロード)にも対応しています。Claude Codeやその他のAIエージェントでスキルとして直接呼び出せます。
前提条件
- Python 3.8+
ffmpegがシステムにインストールされていることyou-getおよび関連パッケージ(pip install you-get)
インストール
git clone https://github.com/Langni/bilibili-collection-downloader.git
cd bilibili-collection-downloader
pip install -r requirements.txt
使い方
基本コマンド
python main.py --uid <クリエイターUID> --output <出力ディレクトリ>
QRコードログイン(オプション)
初回実行時または認証が必要な場合:
python main.py --uid <UID> --login
ターミナルにQRコードが表示されるので、Bilibiliアプリでスキャンしてログインします。
増分更新
python main.py --uid <UID> --output <出力ディレクトリ> --incremental
前回の実行以降に公開された新しい動画のみをダウンロードします。実行ログは .bilibili_downloader_log.json に保存されます。
AIエージェントスキルとして使用
Claude CodeなどのAIエージェントでこのスキルを使用するには、エージェントの設定ファイルにスキルへの参照を追加してください(例:.claude/skills/)。
例:
{
"skills": ["Langni/bilibili-collection-downloader"]
}
主な機能
- 指定したBilibiliクリエイターの全動画をコレクションごとに自動ダウンロード
- QRコードログイン(Bilibiliアプリでスキャン)
- 増分更新(新しい動画のみを効率的にダウンロード)
- コレクション名をディレクトリ名として使用した整理されたファイル構造
- ダウンロード進捗の表示
- エラーハンドリングとリトライ機構
- Claude/AIエージェントスキルとしての呼び出しに対応
出力ディレクトリ構造
<出力ディレクトリ>/
├── コレクション名1/
│ ├── 動画タイトル1.mp4
│ ├── 動画タイトル2.mp4
│ └── ...
├── コレクション名2/
│ └── ...
├── 未分類/ (コレクションに属さない動画)
└── .bilibili_downloader_log.json (増分更新用ログ)
注意点
- Bilibiliの利用規約を遵守してください。
- 大量の動画を一度にダウンロードする場合は、適切なレート制限をかけてください。
- QRコードログインはセッションcookieをローカルに保存します。セキュリティにご注意ください。
ライセンス
MIT License