YouTube Creator CLI スキル (youtube-creator-cli)

このスキルはエージェントに対し、YouTube Creator CLIを安全かつ決定的に、可能な限り非対話的に使用する方法を教えます。

1) ツールの識別とバイナリ

• パッケージ: youtube-creator-cli
• メインバイナリ: youtube-creator-cli
• 開発用エントリ: npm run dev -- <command>

バイナリがグローバルインストールされていない場合は、リポジトリルートからローカル実行を使用します:

npm run dev -- --help

2) このCLIの用途

このCLIを使用して以下を実行できます:

• OAuth認証情報とデフォルト設定の構成
• YouTube Data API v3 に対する認証
• 動画のアップロード
• 動画の読み取り/更新/削除
• サムネイルの管理
• プレイリストの管理
• コメントの読み取り/投稿
• チャンネル/動画統計の読み取り

3) エージェントが検証すべき前提条件

ビジネスコマンドを実行する前に、以下を検証します:

1. Node >= 18
2. 有効なセットアップが存在する(setup が既に実行されている)
3. 認証が有効である(auth が完了し、トークン更新が機能している)
4. アップロード/サムネイル操作用のローカルファイルパスが存在する
5. 対象のアカウント/チャンネルが正しい(特に破壊的な操作の前)

検証コマンド:

youtube-creator-cli --version
youtube-creator-cli --help
youtube-creator-cli config show

4) 初回実行ブートストラップワークフロー

4.1 セットアップ

対話的:

youtube-creator-cli setup

非対話的:

youtube-creator-cli setup \
  --client-id "YOUR_CLIENT_ID" \
  --client-secret "YOUR_CLIENT_SECRET" \
  --default-privacy private \
  --port 3000 \
  --non-interactive

4.2 認証

youtube-creator-cli auth

便利な認証オプション:

• --port <number>: コールバックポートの上書き
• --no-browser: URLを自動オープンの代わりに出力する
• --profile <name>: トークンを特定の認証プロファイルの下に保存する

4.3 準備完了の確認

youtube-creator-cli config show
youtube-creator-cli channels

5) エージェント向けコマンドマップ

コア設定/認証:

• setup
• auth
• logout
• reset
• config show
• config set <key> <value>
• config use-profile <name>

コンテンツ操作:

• channels
• videos
• upload <file>
• update <videoId>
• delete <videoId>
• stats <videoId>
• thumbnail <videoId> <imagePath>

プレイリスト:

• playlists
• playlist-create
• playlist-add <playlistId> <videoId>
• playlist-update <playlistId>
• playlist-delete <playlistId>

コメント:

• comments <videoId>
• comment <videoId> <text>

各コマンドの正確なフラグについては:

youtube-creator-cli <command> --help

6) 高い信頼度の自動化パターン

6.1 アップロードワークフロー

youtube-creator-cli upload ./video.mp4 \
  --title "Launch Demo" \
  --description "Automated upload via agent" \
  --privacy private \
  --tags "demo,launch"

オプションのサムネイルステップ:

youtube-creator-cli thumbnail <VIDEO_ID> ./thumb.jpg

6.2 メタデータ更新ワークフロー

youtube-creator-cli update <VIDEO_ID> \
  --title "Updated Title" \
  --description "Updated description" \
  --privacy unlisted

6.3 確認 + 安全な削除ワークフロー

youtube-creator-cli stats <VIDEO_ID>
youtube-creator-cli delete <VIDEO_ID>

エージェントルール: 呼び出し元のコンテキストから明示的な確認なしに削除しない。

7) エージェント運用ルール(重要)

1. 自動化にはデフォルトよりも決定的な明示的フラグを優先する。
2. ミューテーション前に必ず読み取り専用コマンドを最初に実行する:
   • update の前に: videos または stats を実行
   • delete の前に: stats を実行して対象IDを確認
3. マルチテナント作業では、プロファイル対応の認証を使用する(auth --profile)。
4. ログまたはサマリーにシークレットを公開しない。
5. すべてのOAuth/トークン/設定ファイルを機密として扱う。
6. コマンドのstdout/stderrをキャプチャし、簡潔な構造化成果を返す。

8) エージェント環境の出力戦略

• コマンド出力を人間が読める操作ログとして直接使用する。
• 利用可能な場合は、JSON対応のコマンドモードを使用する(例: videos --format json)ダウンストリーム解析用。
• JSONモードがないコマンドの場合は、アンカーパターンでスタイルな安定フィールド(ID、URL、ステータス)を解析する。
• 重要なID(videoId、playlistId)を次のステップ用の明示的な状態として保存する。

9) 一般的な障害処理

構成されていない

症状:

• "Configuration not found"

対応:

youtube-creator-cli setup

認証されていない / トークン期限切れ

対応:

youtube-creator-cli logout
youtube-creator-cli auth

OAuth アクセスがブロックされている

Google OAuth同意画面でテストユーザー/スコープが見落とされている可能性があります。

ポート競合

対応:

youtube-creator-cli auth --port 3001

または永続化:

youtube-creator-cli config set oauth.port 3001

クォータ問題

アップロードは高額なクォータ操作です。アップロードがクォータメッセージで失敗した場合は、一時停止してクォータガイダンスを報告します。

10) 最小限のランブック

ランブックA: 新規マシン

1. npm install -g youtube-creator-cli
2. youtube-creator-cli setup ...
3. youtube-creator-cli auth
4. youtube-creator-cli channels

ランブックB: 週間公開

1. youtube-creator-cli videos --limit 20
2. youtube-creator-cli upload ...
3. youtube-creator-cli thumbnail ...
4. youtube-creator-cli stats ...

ランブックC: プロファイル切り替え

1. youtube-creator-cli config show
2. youtube-creator-cli config use-profile <name>
3. youtube-creator-cli auth --profile <name>
4. youtube-creator-cli channels

11) エージェント向けセキュリティ注意事項

• ~/.youtube-creator-cli/config.json をコミットしない。
• クライアントシークレット/トークンの完全な値を出力しない。
• ローカルコールバックループバックのみを使用する(localhost)。
• 最小権限を使用し、リクエストされた操作のみを実行する。

12) クイックコマンドチートシート

youtube-creator-cli setup
youtube-creator-cli auth
youtube-creator-cli channels
youtube-creator-cli videos --help
youtube-creator-cli upload ./video.mp4 --title "Title" --privacy private
youtube-creator-cli update <VIDEO_ID> --title "New title"
youtube-creator-cli thumbnail <VIDEO_ID> ./thumb.jpg
youtube-creator-cli playlists
youtube-creator-cli comments <VIDEO_ID>
youtube-creator-cli comment <VIDEO_ID> "Great video!"
youtube-creator-cli logout