yutu

)](https://winstall.app/apps/eat-pray-ai.yutu)

yutu is a CLI, MCP server, and AI agent for YouTube that automates your entire YouTube workflow — from uploading and optimizing videos to managing comments, playlists, and channel branding — so you can get more views, higher click-through rates, and stronger audience engagement with less manual effort. 中文文档

Table of Contents

• Prerequisites
• Installation
• Agent
• MCP Server
• Skills
• Usage
• Features
• Contributing

Prerequisites

An account on Google Cloud Platform is required. Set up the following:

1. Create a GCP Project and enable these APIs under APIs & Services -> Enable APIs and services:

   • YouTube Data API v3 (Required)
   • YouTube Analytics API (Optional)
   • YouTube Reporting API (Optional)

2. Create OAuth credentials:

   • Go to APIs & Services -> OAuth consent screen, create a consent screen with yourself as a test user
   • Go to Credentials -> Create Credentials -> OAuth Client ID, select Desktop app
   • Download the credential file and save it as client_secret.json, it should look like

   {
     "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. Authenticate:

   yutu auth --credential client_secret.json
   

   A browser window will open for you to grant YouTube access. After granting permission, a token is saved to 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
   }
   

By default, yutu will read client_secret.json and youtube.token.json from the current directory, --credential/-c and --cacheToken/-t flags are available only in auth subcommand. To modify the default path in all subcommands, set these environment variables.

Global Environment Variables

Variable	Description	Default
YUTU_CREDENTIAL	Path, Base64, or JSON of OAuth client secret	client_secret.json
YUTU_CACHE_TOKEN	Path, Base64, or JSON of cached OAuth token	youtube.token.json
YUTU_ROOT	Root directory for file resolution	Current working directory
YUTU_LOG_LEVEL	Log level: DEBUG, INFO, WARN, ERROR	INFO

Installation

If you're using an AI agent, copy and paste the following prompt to finish the installation: