YouTube自动化工具

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"
       ]
     }
   }
   

   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.

Installation

You can download yutu from releases page directly, or use the following methods as you prefer.

<details> <summary>GitHub Actions</summary>

There are two actions available for yutu, one is for general purpose and the other is for uploading video to YouTube. Refer to youtube-action and youtube-uploader for more information.

</details>

<details> <summary>Node.js</summary>

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

</details>

<details> <summary>Docker</summary>

```shell ❯ docker pull ghcr.io/eat-pray-ai/yutu:latest ❯ docker run --rm ghcr.io/eat-pray-ai/yutu:latest

Docker

❯ gh attestation verify oci://ghcr.io/eat-pray-ai/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

Usage

❯ yutu        
yutu is a CLI, MCP server, and AI agent for YouTube that can automate almost all YouTube workflows.

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:
  activity               Manage activities on YouTube
  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
  mcp                    Start MCP server
  member                 Manage YouTube channel members
  membershipsLevel       Manage YouTube memberships 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.

Global Environment Variables

Agent Environment Variables

Then run the following command for detail usage:

``` ❯ yutu agent --help ❯ yutu agent --args "help"

web mode with three sub-launchers: api, a2a and webui

❯ yutu agent --args "web api a2a webui" ```