yutu
The AI-powered toolkit that grows your YouTube channel on autopilot.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/eat-pray-ai/yutu with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/eat-pray-ai/yutu'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/eat-pray-ai--yutu)HTML
<a href="/listings/eat-pray-ai--yutu"><img src="/api/listings/eat-pray-ai--yutu/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
If you're using an AI agent, copy and paste the following prompt to finish the installation:
Install and configure yutu by following https://raw.githubusercontent.com/eat-pray-ai/yutu/refs/heads/main/internal/tools/skillgen/setup.md
You can download `yutu` from [releases page](https://github.com/eat-pray-ai/yutu/releases/latest) 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](https://github.com/eat-pray-ai/youtube-action) and [youtube-uploader](https://github.com/eat-pray-ai/youtube-uploader) for more information.
</details>
<details> <summary>Node.js</summary>
❯ npm i -g @eat-pray-ai/yutu
</details>
<details> <summary>Docker</summary>
❯ docker pull ghcr.io/eat-pray-ai/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
</details>
<details> <summary>Gopher</summary>
❯ go install github.com/eat-pray-ai/yutu@latest
</details>
<details> <summary>Linux</summary>
❯ curl -sSfL https://raw.githubusercontent.com/eat-pray-ai/yutu/main/scripts/install.sh | bash
</details>
<details> <summary>macOS</summary>
Install `yutu` using [Homebrew🍺](https://brew.sh/)(recommended), or run the shell script.
❯ brew install yutu # or ❯ curl -sSfL https://raw.githubusercontent.com/eat-pray-ai/yutu/main/scripts/install.sh | bash
</details>
<details> <summary>Windows</summary>
❯ winget install yutu
</details>
<details> <summary>Verifying Installation</summary>
Verify the integrity and provenance of `yutu` using its associated cryptographically signed attestations.
# 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 # Windows ❯ gh attestation verify $(where.exe yutu.exe) --repo eat-pray-ai/yutu
</details>
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 325 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- 
- # `yutu`
- [](https://gitmoji.dev)
- [](https://github.com/eat-pray-ai/yutu?tab=Apache-2.0-1-ov-file)
- [](https://pkg.go.dev/github.com/eat-pray-ai/yutu)
- [](https://raw.githack.com/wiki/eat-pray-ai/yutu/coverage.html)
- [](https://github.com/eat-pray-ai/yutu/stargazers)
- [](https://github.com/eat-pray-ai/yutu/releases/latest)
- [](https://github.com/eat-pray-ai/yutu/actions/workflows/publish.yml)
- [](https://github.com/eat-pray-ai/yutu/actions/workflows/codeql.yml)
- [](https://github.com/eat-pray-ai/yutu/actions/workflows/test.yml)
- [](https://linux.do/tag/2234-tag/2234)
- [](https://github.com/eat-pray-ai/yutu/releases/latest)
- [](https://formulae.brew.sh/formula/yutu)
- [](https://winstall.app/apps/eat-pray-ai.yutu)
- [](https://www.npmjs.com/package/@eat-pray-ai/yutu)
- <!-- [](https://www.producthunt.com/products/yutu?embed=true&utm_source=badge-featured&utm_medium=badge&utm_campaign=badge-youtube-cli-mcp-server-skill-and-agent) -->
- `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. [中文文档](./README_zh.md)
- [](https://asciinema.org/a/wXIHU4ciFBAKrHfaFNkMoIs12)
- ## Table of Contents
- - [Prerequisites](#prerequisites)
- - [Installation](#installation)
- - [Agent](#agent)
- - [MCP Server](#mcp-server)
- - [Skills](#skills)
- - [Usage](#usage)
- - [Features](#features)
- - [Sponsor](#sponsor)
- - [Contributing](#contributing)
- ## Prerequisites
- An account on [Google Cloud Platform](https://console.cloud.google.com/) 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](https://console.cloud.google.com/apis/api/youtube.googleapis.com/overview) (Required)
- - [YouTube Analytics API](https://console.cloud.google.com/apis/api/youtubeanalytics.googleapis.com/overview) (Optional)
- - [YouTube Reporting API](https://console.cloud.google.com/apis/api/youtubereporting.googleapis.com/overview) (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
- ```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. **Authenticate**:
- ```bash
- 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`.
- ```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:
- ```plaintext
- Install and configure yutu by following https://raw.githubusercontent.com/eat-pray-ai/yutu/main/internal/tools/skillgen/setup.md
- ```
- You can download `yutu` from [releases page](https://github.com/eat-pray-ai/yutu/releases/latest) 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](https://github.com/eat-pray-ai/youtube-action) and [youtube-uploader](https://github.com/eat-pray-ai/youtube-uploader) for more information.
- </details>
- <details>
- <summary>Node.js</summary>
- ```shell
- ❯ npm i -g @eat-pray-ai/yutu
- ```
- </details>
- <details>
- <summary>Docker</summary>
- ```shell
- # 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
- ```
- </details>
- <details>
- <summary>Gopher</summary>
- ```shell
- ❯ go install github.com/eat-pray-ai/yutu@latest
- ```
- </details>
- <details>
- <summary>Linux</summary>
- ```shell
- ❯ curl -sSfL https://raw.githubusercontent.com/eat-pray-ai/yutu/main/scripts/install.sh | bash
- ```
- </details>
- <details>
- <summary>macOS</summary>
- Install `yutu` using [Homebrew🍺](https://brew.sh/)(recommended), or run the shell script.
- ```shell
- ❯ brew install yutu
- # or
- ❯ curl -sSfL https://raw.githubusercontent.com/eat-pray-ai/yutu/main/scripts/install.sh | bash
- ```
- </details>
- <details>
- <summary>Windows</summary>
- ```shell
- ❯ winget install yutu
- ```
- </details>
- <details>
- <summary>Verifying Installation</summary>
- Verify the integrity and provenance of `yutu` using its associated cryptographically signed attestations.
- ```shell
- # 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
- ```
- </details>
- ## Agent
- `yutu` provides an Agent mode (Miffy) to automate YouTube workflows. The Agent can retrieve, create, update, and delete YouTube content, with built-in YouTube growth strategy and SEO expertise.
- ```shell
- # Gemini(compatible) (default)
- ❯ yutu agent --provider google --model gemini-4-hydrogen --api-key "YOUR_KEY"
- ❯ yutu agent --provider google --model gemini-4-carbon --api-key "YOUR_KEY" --base-url "https://custom.endpoint.com"
- # OpenAI(compatible) (OpenAI, DeepSeek, Ollama, vLLM, etc.)
- ❯ yutu agent --provider openai --model gpt-6-astra --api-key "YOUR_KEY"
- ❯ yutu agent --provider openai --model deepseek-flash --api-key "YOUR_KEY" --base-url "https://api.deepseek.com"
- # Anthropic(compatible)
- ❯ yutu agent --provider anthropic --model claude-fable-5-2 --api-key "YOUR_KEY"
- ❯ yutu agent --provider anthropic --model claude-opus-5-5 --api-key "YOUR_KEY" --base-url "https://custom.endpoint.com"
- # web mode with sub-launchers
- ❯ yutu agent --args "web api a2a webui" --api-key "YOUR_KEY"
- # show available launcher args
- ❯ yutu agent --args ""
- ```
- ### Agent Flags
- | Flag | Description | Default |
- | ------------------- | ----------------------------------------------- | ------------------------------------------ |
- | `-a, --args` | Launcher arguments as a single string | `console` |
- | `-p, --provider` | LLM provider: `google`, `openai` or `anthropic` | `google` |
- | `-m, --model` | Model name | `gemini-4-hydrogen` |
- | `--api-key` | API key for the model provider | |
- | `--base-url` | Base URL for the model provider's API endpoint | |
- | `-i, --instruction` | Override the built-in Agent instruction | [INSTRUCTION.md](cmd/agent/INSTRUCTION.md) |
- ## MCP Server
- Before using `yutu` as an MCP server, make sure `yutu` is installed(see [Installation](#installation) section), and you have a valid `client_secret.json` and `youtube.token.json` files(refer to [Prerequisites](#prerequisites) section).
- Setup yutu MCP for one or more selected AI Agents:
- ```shell
- ❯ yutu mcp setup --agents claude,opencode,pi,codex \
- --credential /absolute/path/to/client_secret.json \
- --cacheToken /absolute/path/to/youtube.token.json
- ```
- `--agents` is required. Credential/token flags accept Path/Base64/JSON; omitted flags use the corresponding environment variable or default file path. Relative paths are converted to absolute paths. Prefer file paths to avoid copying inline secrets into Agent settings.
- ## Skills
- `yutu` provides a unified [skill](https://opencode.ai/docs/skills) that extends AI Agents with YouTube domain knowledge, common workflows, and SEO best practices — covering videos, playlists, comments, channels, captions, subscriptions, and more.
- ```shell
- ❯ npx skills add eat-pray-ai/yutu --skill youtube-automation
- ```
- See [skills/youtube-automation/SKILL.md](skills/youtube-automation/SKILL.md) for the full list of supported operations.
- ## Usage
- ```shell
- ❯ yutu
- yutu is a CLI, MCP server, and AI Agent that automates your YouTube workflows from the terminal or any AI Agent.
- 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
- Please refer to [FEATURES.md](docs/FEATURES.md) for more information.
- ## Sponsor
- If `yutu` saves you time, a [⭐ star](https://github.com/eat-pray-ai/yutu) on GitHub goes a long way and helps others discover the project.
- You can also support its development with a donation (Alipay / WeChat) at [yutu.ifor.dev](https://yutu.ifor.dev/#donate). Thank you! 💖
- ## Contributing
- Please refer to [CONTRIBUTING.md](docs/CONTRIBUTING.md) for more information.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.