eat-pray-ai/yutu

yutu

yutu is a CLI, MCP server, and AI agent to automate YouTube workflows — from uploading and optimizing videos to managing comments, playlists, and channel branding — and provides a skill for AI agents, 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
   }