youtube-channels-automation

# youtube-channels-automation

YouTube チャンネル運営を自動化するツールキット。Analytics データ収集、AI コンテンツ生成、動画アップロード、メタデータ管理をまとめて提供します。

> [!WARNING]
> **移行告知（2026-07-02 / 2026-07-08 改訂）**: 本 Python 版は**メンテナンスモード**（バグ修正のみ、新機能なし）です。後継の TypeScript 製 **`tayk`**（npm パッケージ）は別リポジトリで開発中で、実運用カバレッジに達した時点で cutover（main ブランチからの Python コード削除）を判断します。**具体的な期日は設けません**。cutover 実施後は branch 参照の `uv add git+https://` は取得不可になります（git tag は残ります）。詳細・マイルストーン・移行手順は [`docs/migration/python-to-tayk.md`](docs/migration/python-to-tayk.md) を参照してください。

> **新規利用者の方へ**: セットアップ手順は [`ONBOARDING.md`](ONBOARDING.md) を参照してください。

## Features

- **Analytics 収集・分析** - YouTube Analytics API からデータを自動収集し、CTR・エンゲージメント分析レポートを生成
- **AI 音楽生成** - Google Lyria RealTime API / Suno プロンプト生成で楽曲を自動作成
- **AI 動画生成** - Google Veo で動画を生成、FFmpeg で静止画＋音声から MP4 を合成
- **AI 画像生成** - Gemini API でサムネイル・カバー画像を自動生成
- **YouTube 自動アップロード** - 動画・サムネイル・メタデータを一括アップロード
- **メタデータ生成** - チャンネル設定に基づくタイトル・説明文・タグ・多言語ローカライゼーションの自動生成
- **ベンチマーク分析** - 競合チャンネルのパフォーマンス比較
- **プレイリスト管理** - プレイリストの自動作成・動画追加
- **Analytics dashboard** - `yt-dashboard` で収集済みチャンネル指標をローカル横断表示（[利用手順](docs/dashboard.md)）
- **運用者向け公開ドキュメント（公開リリースノート）** - 「はじめる」「使う」「リリースノート」の区分で、セットアップ、OAuth、skill / workflow、dashboard、workspace 移行、本体と Chrome 拡張の更新内容を掲載（[公開サイト](https://youtube-automation-release-notes.pages.dev/) / [掲載原本](ONBOARDING.md)）

> **個別 skill のカタログ**: `yt-skills sync` で配布される全 46 skill の「なにができるか」一覧は [`docs/features.md`](docs/features.md) を参照。
>
> **workflow 系 skill の使い分け**: 利用者入口は `/wf-new` `/wf-next` `/wf-status` の 3 種です。`workflow-state.json` の扱いは [`docs/workflow-cheatsheet.md`](docs/workflow-cheatsheet.md) を参照。
>
> **自前動画素材を結合する場合**: fps が違う素材を FFmpeg concat する際の注意点は [`docs/media-concat-fps.md`](docs/media-concat-fps.md) を参照。

## Architecture

```
youtube-channels-automation/      # ← このリポジトリ
├── src/
│   └── youtube_automation/       # インストール対象パッケージ
│       ├── application/         # ユースケースと実行フロー
│       ├── commands/             # yt-* CLI の入口（機能別、channel-init テンプレート含む）
│       ├── configuration/        # 設定モデル・loader・canonical 境界
│       ├── core/                 # 共通エラーと基盤契約
│       ├── domains/              # ドメインロジック
│       ├── infrastructure/      # 外部連携・互換 facade
│       └── auth/                 # OAuth 2.0 認証
├── .claude/skills/               # Claude Code スキル群 (yt-skills sync で配布)
├── tests/                        # テストスイート
```

各チャンネルリポジトリ側では、以下のいずれかの方法で導入します:

```
channel-repo/                  # チャンネル固有リポジトリ
├── config/
│   ├── channel/               # チャンネル設定（責務別分割、v2.0.0 以降）
│   │   ├── meta.json          #   channel / youtube_channel
│   │   ├── content.json       #   genre / tags / descriptions / title
│   │   ├── youtube.json       #   youtube / music_engine / content_model
│   │   ├── analytics.json     #   analytics / benchmark (optional)
│   │   ├── playlists.json     #   playlists (optional)
│   │   ├── workflow.json      #   workflow / wf_next / post-publish (optional)
│   │   ├── audio.json         #   audio (optional)
│   │   ├── shorts.json        #   shorts (optional)
│   │   ├── comments.json      #   comments (optional)
│   │   ├── pinned-comment.json # pinned_comment (optional)
│   │   └── distrokid.json     #   distrokid (optional)
│   └── localizations.json     # 多言語テンプレート
├── auth/                      # OAuth 2.0 認証情報 (channel 固有)
│   ├── client_secrets.json
│   └── token.json
├── .claude/skills/            # yt-skills sync で展開される
└── collections/               # コンテンツ成果物
```

チャンネル固有の設定は親リポジトリの `config/` と `auth/` に配置します。

## Prerequisites

- Python 3.11+
- [FFmpeg](https://ffmpeg.org/) (動画生成に必要)
- Google Cloud Project (YouTube Data API v3 有効化済み)
- (オプション) [Nix](https://nixos.org/): `flake.nix` で開発環境を再現可能に
- (オプション) [1Password CLI](https://developer.1password.com/docs/cli/): シークレットをディスクに書かずに管理

## Quick Start

### 1. パッケージをインストール (推奨)

`uv` または `pip` で git+https からインストールします:

```bash
# uv
uv add git+https://github.com/daiki-beppu/youtube-automation
# 特定タグで固定する場合
uv add "git+https://github.com/daiki-beppu/youtube-automation@v1.1.0"

# pip
pip install "git+https://github.com/daiki-beppu/youtube-automation@v1.1.0"
```

インストールすると `yt-*` という CLI コマンド群と `yt-skills` 同期ツールが PATH に入ります。

> **submodule 形式 (legacy)**: GCP セットアップスクリプト（`.claude/skills/setup/references/`）は、submodule 利用者は `automation/.claude/skills/setup/references/gcp-bootstrap.sh` のように submodule パス経由で参照するか、`yt-skills sync` を先に実行してください（pip install 環境のみ）。新規チャンネルは pip install を推奨。移行手順: [`docs/migration-submodule-to-uv.md`](docs/migration-submodule-to-uv.md)

### 2. Claude Code 配布物を同期

チャンネルリポジトリのルートで:

```bash
yt-skills list                            # 全 asset の同梱一覧（skills / CLAUDE.md / docs / auth-template）
yt-skills sync                            # 全 asset を一括展開 (--asset all がデフォルト)
yt-skills sync --asset skills             # 個別: Claude Code スキルだけ
yt-skills sync --asset claude-md          # 個別: 運営方針テンプレ (.claude/CLAUDE.md)
yt-skills sync --asset workflow-cheatsheet  # 個別: workflow チートシート (docs/workflow-cheatsheet.md)
yt-skills sync --asset 

... (truncated)