bozhu-skill は何をしますか？
概要
抖音ブロガー蒸留フレームワーク — 入力されたブロガーのリンクから、動画の自動ダウンロード、OCR/音声分析を実行し、創作の秘訣を抽出します。Hermes Agent のスキルとして統合可能です。
機能
- 動画自動ダウンロード: ブロガーのホームページリンクから全動画を自動取得
- OCR分析: 動画内のテキスト（字幕、オーバーレイテキストなど）を抽出
- 音声分析: 音声認識（ASR）による発言内容のテキスト化
- 創作心法抽出: 抽出データからパターン分析と自然言語処理によりクリエイターの戦略を体系化
- Hermes Agent統合: エージェントスキルとして簡単に組み込み可能
使用方法
Hermes Agent での統合
hermes skill install zou0613/bozhu-skill
スタンドアロン実行
python main.py --url [ブロガーの抖音URL]
出力例
分析結果は output/ ディレクトリに以下の形式で保存されます：
{
"author": "ブロガー名",
"videos_analyzed": 10,
"extracted_principles": [
{
"principle": "冒頭3秒でフックを作る",
"evidence": [
"動画ID 123: 「今すぐ見ないと損」というテロップ",
"動画ID 456: 「知らないとヤバい」という冒頭文言"
],
"frequency": "high"
}
]
}
必要条件
- Python 3.8以上
ffmpeg: 動画から音声抽出のために必要（brew install ffmpegまたはapt install ffmpeg）- OpenAI APIキー（オプション、高度な創作心法抽出に利用）
インストール
git clone https://github.com/zou0613/bozhu-skill.git
cd bozhu-skill
pip install -r requirements.txt
環境変数
| 変数名 | 説明 | 必須 |
|---|---|---|
OPENAI_API_KEY | OpenAI APIキー | 任意（高度な抽出に利用） |
DEFAULT_CRAWL_LIMIT | デフォルトのクロール動画数（デフォルト: 10） | いいえ |
アーキテクチャ
入力 (ブロガーURL)
↓
動画ダウンローダー
↓
OCRモジュール ← フレーム抽出
↓
ASRモジュール ← 音声抽出 (ffmpeg)
↓
創作心法抽出器
↓
出力 (JSON)
注意事項
- 抖音の利用規約を遵守してください。著作権で保護されたコンテンツの無断使用は禁止されています。
- このツールは教育・分析目的でのみ使用し、スクレイピング速度は適切に制御してください。
- Hermes Agent での統合には
hermes-cliがインストールされている必要があります。
ライセンス
MIT
コントリビューション
バグ報告や機能提案は、GitHub Issues または Pull Request でお願いします。