Yutu

yutu

yutuは、YouTube のワークフローを自動化する CLI、MCP サーバー、AI エージェントです。動画のアップロードや最適化から、コメント、プレイリスト、チャンネルのブランディング管理までを自動化します。また、AI エージェント向けのスキルも提供しており、手作業を減らしながら、視聴回数、クリック率、視聴者エンゲージメントを高められます。中文文档

目次

• 前提条件
• インストール
• エージェント
• MCP サーバー
• スキル
• 使い方
• 機能
• 貢献

前提条件

Google Cloud Platform のアカウントが必要です。以下を設定してください。

1. GCP プロジェクトを作成し、APIs & Services -> Enable APIs and services で次の API を有効にします。

   • YouTube Data API v3（必須）
   • YouTube Analytics API（任意）
   • YouTube Reporting API（任意）

2. OAuth 認証情報を作成します。

   • APIs & Services -> OAuth consent screen に移動し、自分をテストユーザーとして同意画面を作成します
   • Credentials -> Create Credentials -> OAuth Client ID に移動し、Desktop app を選択します
   • 認証情報ファイルをダウンロードして client_secret.json という名前で保存します。ファイルの内容は次のようになります

   {
     "installed": {
       "client_id": "11181119.apps.googleusercontent.com",
       "project_id": "yutu-11181119",
       "auth_uri": "https://accounts.google.com/o/oauth2/auth",
       "token_uri": "https://oauth2.googleapis.com/token",
       "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
       "client_secret": "XXXXXXXXXXXXXXXX",
       "redirect_uris": [
         "http://localhost"
       ]
     }
   }
   

3. 認証します。

   yutu auth --credential client_secret.json
   

   ブラウザーウィンドウが開き、YouTube へのアクセス許可を求められます。許可すると、トークンが youtube.token.json に保存されます。

   {
     "access_token": "ya29.XXXXXXXXX",
     "token_type": "Bearer",
     "refresh_token": "1//XXXXXXXXXX",
     "expiry": "2024-05-26T18:49:56.1911165+08:00",
     "expires_in": 3599
   }
   

デフォルトでは、yutu は現在のディレクトリから client_secret.json と youtube.token.json を読み込みます。--credential/-c と --cacheToken/-t フラグは auth サブコマンドでのみ使用できます。すべてのサブコマンドでデフォルトのパスを変更するには、次の環境変数を設定してください。

グローバル環境変数

インストール

AI エージェントを使用している場合は、以下のプロンプトをコピーして貼り付け、インストールを完了してください。

Install and configure yutu by following https://raw.githubusercontent.com/eat-pray-ai/yutu/main/internal/tools/skillgen/setup.md

yutu はリリースページから直接ダウンロードするか、お好みの方法でインストールできます。

❯ npm i -g @eat-pray-ai/yutu

# GitHub Container Registry (GHCR)
❯ docker pull ghcr.io/eat-pray-ai/yutu:latest
# or Docker Hub
❯ docker pull eatprayai/yutu:latest

❯ docker run --rm ghcr.io/eat-pray-ai/yutu:latest
# make sure client_secret.json is in the current directory
❯ docker run --rm -it -u $(id -u):$(id -g) -v $(pwd):/app -p 8216:8216 ghcr.io/eat-pray-ai/yutu:latest

❯ go install github.com/eat-pray-ai/yutu@latest

❯ curl -sSfL https://raw.githubusercontent.com/eat-pray-ai/yutu/main/scripts/install.sh | bash

❯ brew install yutu

# or
❯ curl -sSfL https://raw.githubusercontent.com/eat-pray-ai/yutu/main/scripts/install.sh | bash

❯ winget install yutu

# Docker
❯ gh attestation verify oci://ghcr.io/eat-pray-ai/yutu:latest --repo eat-pray-ai/yutu
❯ gh attestation verify oci://docker.io/eatprayai/yutu:latest --repo eat-pray-ai/yutu

# Linux and macOS(if installed using shell script)
❯ gh attestation verify $(which yutu) --repo eat-pray-ai/yutu

# Windows
❯ gh attestation verify $(where.exe yutu.exe) --repo eat-pray-ai/yutu

エージェント

yutu は、YouTube のワークフローを自動化するエージェントモード（Miffy）を提供します。このエージェントは、YouTube コンテンツの取得、作成、更新、削除が可能で、YouTube の成長戦略と SEO に関する専門知識を備えています。

# Gemini(compatible) (default)
❯ yutu agent --provider google --model gemini-3.8-flash --api-key "YOUR_KEY"
❯ yutu agent --provider google --model gemini-3.8-flash --api-key "YOUR_KEY" --base-url "https://custom.endpoint.com/"
# OpenAI(compatible) (OpenAI, DeepSeek, Ollama, vLLM, etc.)
❯ yutu agent --provider openai --model gpt-5.6-terra --api-key "YOUR_KEY"
❯ yutu agent --provider openai --model deepseek-flash --api-key "YOUR_KEY" --base-url "https://api.deepseek.com/"
# web mode with sub-launchers
❯ yutu agent --args "web api a2a webui" --api-key "YOUR_KEY"
# show available launcher args
❯ yutu agent --args ""

エージェントのフラグ

MCP サーバー

yutu を MCP サーバーとして使用する前に、yutu がインストールされていること（インストールのセクションを参照）、有効な client_secret.json ファイルと youtube.token.json ファイルがあること（前提条件のセクションを参照）を確認してください。

以下の手順に従って、お好みのツールで yutu を MCP サーバーとして設定できます。

# Stdio mode
❯ claude mcp add --env YUTU_CREDENTIAL=/absolute/path/to/client_secret.json \
  --env YUTU_CACHE_TOKEN=/absolute/path/to/youtube.token.json \
  yutu -- yutu mcp

# HTTP mode (start the server first: yutu mcp --mode http)
❯ claude mcp add --transport http \
  --client-id YOUR_CLIENT_ID.apps.googleusercontent.com \
  --client-secret \
  yutu http://localhost:8216/mcp

# Stdio mode
❯ codex mcp add --env YUTU_CREDENTIAL=/absolute/path/to/client_secret.json \
  --env YUTU_CACHE_TOKEN=/absolute/path/to/youtube.token.json \
  yutu -- yutu mcp

# HTTP mode (start the server first: yutu mcp --mode http)
❯ codex mcp add --url http://localhost:8216/mcp \
  --oauth-client-id YOUR_CLIENT_ID.apps.googleusercontent.com \
  yutu

{
  "yutu": {
    "type": "stdio",
    "command": "yutu",
    "args": [
      "mcp"
    ],
    "env": {
      "YUTU_CREDENTIAL": "/absolute/path/to/client_secret.json",
      "YUTU_CACHE_TOKEN": "/absolute/path/to/youtube.token.json"
    }
  }
}

スキル

yutu は、YouTube のドメイン知識、一般的なワークフロー、SEO のベストプラクティスを AI エージェントに提供する統合型スキルを備えています。動画、再生リスト、コメント、チャンネル、字幕、登録などを扱えます。

❯ npx skills add eat-pray-ai/yutu --skill youtube

サポートされている操作の全一覧については、skills/youtube/SKILL.mdを参照してください。

使い方

❯ yutu
yutu is a CLI, MCP server, and AI agent that automates your YouTube workflows from the terminal or any AI client.

Environment variables:
  YUTU_CREDENTIAL    Path/Base64/JSON of OAuth client secret (default: client_secret.json)
  YUTU_CACHE_TOKEN   Path/Base64/JSON of cached OAuth token (default: youtube.token.json)
  YUTU_ROOT          Root directory for file resolution (default: current working directory)
  YUTU_LOG_LEVEL     Log level: DEBUG, INFO, WARN, ERROR (default: INFO)

Usage:
  yutu [flags]
  yutu [command]

Available Commands:
  abuseReport            Manage YouTube abuse reports
  activity               Manage YouTube activities
  agent                  Start an agent to automate YouTube workflows
  auth                   Authenticate with YouTube APIs
  caption                Manage YouTube video captions
  channel                Manage YouTube channels
  channelBanner          Manage YouTube channel banners
  channelSection         Manage YouTube channel sections
  comment                Manage YouTube comments
  commentThread          Manage YouTube comment threads
  completion             Generate the autocompletion script for the specified shell
  help                   Help about any command
  i18nLanguage           Manage YouTube i18n languages
  i18nRegion             Manage YouTube i18n regions
  liveBroadcast          Manage YouTube live broadcasts
  liveChatBan            Manage YouTube live chat bans
  liveChatMessage        Manage YouTube live chat messages
  liveChatModerator      Manage YouTube live chat moderators
  liveStream             Manage YouTube live streams
  mcp                    Start MCP server
  member                 Manage YouTube channel members
  membershipsLevel       Manage YouTube membership levels
  playlist               Manage YouTube playlists
  playlistImage          Manage YouTube playlist images
  playlistItem           Manage YouTube playlist items
  search                 Manage YouTube search
  subscription           Manage YouTube subscriptions
  superChatEvent         Manage YouTube Super Chat events
  thirdPartyLink         Manage YouTube third-party links
  thumbnail              Manage YouTube video thumbnails
  version                Show the version of yutu
  video                  Manage YouTube videos
  videoAbuseReportReason Manage YouTube video abuse report reasons
  videoCategory          Manage YouTube video categories
  watermark              Manage YouTube watermarks

Flags:
  -h, --help   help for yutu

Use "yutu [command] --help" for more information about a command.

機能

詳細については、FEATURES.mdを参照してください。

コントリビューション

詳細については、CONTRIBUTING.mdを参照してください。