Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/eat-pray-ai--yutu/badge.svg)](/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

i

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.

  1. ![Yutu](./assets/yutu.svg)
  2. # `yutu`
  3. [![Static Badge](https://img.shields.io/badge/gitmoji-%F0%9F%98%BF%F0%9F%90%B0%F0%9F%90%A7%E2%9D%A4%EF%B8%8F%E2%80%8D%F0%9F%A9%B9-love?style=flat-square&labelColor=%23EDD1CC&color=%23FF919F)](https://gitmoji.dev)
  4. [![GitHub License](https://img.shields.io/github/license/eat-pray-ai/yutu?style=flat-square)](https://github.com/eat-pray-ai/yutu?tab=Apache-2.0-1-ov-file)
  5. [![Go Reference](https://pkg.go.dev/badge/github.com/eat-pray-ai/yutu?style=flat-square)](https://pkg.go.dev/github.com/eat-pray-ai/yutu)
  6. [![Go Coverage](https://github.com/eat-pray-ai/yutu/wiki/coverage.svg)](https://raw.githack.com/wiki/eat-pray-ai/yutu/coverage.html)
  7. [![GitHub Repo stars](https://img.shields.io/github/stars/eat-pray-ai/yutu?style=flat-square&logo=github)](https://github.com/eat-pray-ai/yutu/stargazers)
  8. [![GitHub Downloads](https://img.shields.io/github/downloads/eat-pray-ai/yutu/total?style=flat-square)](https://github.com/eat-pray-ai/yutu/releases/latest)
  9. [![GitHub Actions build Status](https://img.shields.io/github/actions/workflow/status/eat-pray-ai/yutu/publish.yml?style=flat-square&logo=githubactions)](https://github.com/eat-pray-ai/yutu/actions/workflows/publish.yml)
  10. [![GitHub Actions CodeQL Status](https://img.shields.io/github/actions/workflow/status/eat-pray-ai/yutu/codeql.yml?style=flat-square&logo=githubactions&label=CodeQL)](https://github.com/eat-pray-ai/yutu/actions/workflows/codeql.yml)
  11. [![GitHub Actions test Status](https://img.shields.io/github/actions/workflow/status/eat-pray-ai/yutu/test.yml?style=flat-square&logo=githubactions&label=test)](https://github.com/eat-pray-ai/yutu/actions/workflows/test.yml)
  12. [![LINUX DO](./assets/linuxdo_flat-square.svg)](https://linux.do/tag/2234-tag/2234)
  13. [![GitHub Release](https://img.shields.io/github/v/release/eat-pray-ai/yutu?sort=semver&style=flat-square&logo=go)](https://github.com/eat-pray-ai/yutu/releases/latest)
  14. [![Homebrew Formula Version](https://img.shields.io/homebrew/v/yutu?style=flat-square&logo=homebrew)](https://formulae.brew.sh/formula/yutu)
  15. [![WinGet Package Version](https://img.shields.io/winget/v/eat-pray-ai.yutu?style=flat-square&label=%F0%9F%93%A6%20winget)](https://winstall.app/apps/eat-pray-ai.yutu)
  16. [![npm Version](https://img.shields.io/npm/v/%40eat-pray-ai/yutu?style=flat-square&logo=npm)](https://www.npmjs.com/package/@eat-pray-ai/yutu)
  17. <!-- [![YouTube CLI, MCP server, Skill and Agent - AI-powered toolkit that grows YouTube channel on autopilot | Product
  18. Hunt](https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1138118&theme=light)](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) -->
  19. `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)
  20. [![mcp demo](./assets/mcp-demo.gif)](https://asciinema.org/a/wXIHU4ciFBAKrHfaFNkMoIs12)
  21. ## Table of Contents
  22. - [Prerequisites](#prerequisites)
  23. - [Installation](#installation)
  24. - [Agent](#agent)
  25. - [MCP Server](#mcp-server)
  26. - [Skills](#skills)
  27. - [Usage](#usage)
  28. - [Features](#features)
  29. - [Sponsor](#sponsor)
  30. - [Contributing](#contributing)
  31. ## Prerequisites
  32. An account on [Google Cloud Platform](https://console.cloud.google.com/) is required. Set up the following:
  33. 1. **Create a GCP Project** and enable these APIs under `APIs & Services -> Enable APIs and services`:
  34. - [YouTube Data API v3](https://console.cloud.google.com/apis/api/youtube.googleapis.com/overview) (Required)
  35. - [YouTube Analytics API](https://console.cloud.google.com/apis/api/youtubeanalytics.googleapis.com/overview) (Optional)
  36. - [YouTube Reporting API](https://console.cloud.google.com/apis/api/youtubereporting.googleapis.com/overview) (Optional)
  37. 2. **Create OAuth credentials**:
  38. - Go to `APIs & Services -> OAuth consent screen`, create a consent screen with yourself as a test user
  39. - Go to `Credentials -> Create Credentials -> OAuth Client ID`, select `Desktop app`
  40. - Download the credential file and save it as `client_secret.json`, it should look like
  41. ```json
  42. {
  43. "installed": {
  44. "client_id": "11181119.apps.googleusercontent.com",
  45. "project_id": "yutu-11181119",
  46. "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  47. "token_uri": "https://oauth2.googleapis.com/token",
  48. "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  49. "client_secret": "XXXXXXXXXXXXXXXX",
  50. "redirect_uris": ["http://localhost"]
  51. }
  52. }
  53. ```
  54. 3. **Authenticate**:
  55. ```bash
  56. yutu auth --credential client_secret.json
  57. ```
  58. A browser window will open for you to grant YouTube access. After granting permission, a token is saved to `youtube.token.json`.
  59. ```json
  60. {
  61. "access_token": "ya29.XXXXXXXXX",
  62. "token_type": "Bearer",
  63. "refresh_token": "1//XXXXXXXXXX",
  64. "expiry": "2024-05-26T18:49:56.1911165+08:00",
  65. "expires_in": 3599
  66. }
  67. ```
  68. 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.
  69. ### Global Environment Variables
  70. | Variable | Description | Default |
  71. | ------------------ | -------------------------------------------- | ------------------------- |
  72. | `YUTU_CREDENTIAL` | Path, Base64, or JSON of OAuth client secret | `client_secret.json` |
  73. | `YUTU_CACHE_TOKEN` | Path, Base64, or JSON of cached OAuth token | `youtube.token.json` |
  74. | `YUTU_ROOT` | Root directory for file resolution | Current working directory |
  75. | `YUTU_LOG_LEVEL` | Log level: `DEBUG`, `INFO`, `WARN`, `ERROR` | `INFO` |
  76. ## Installation
  77. If you're using an AI Agent, copy and paste the following prompt to finish the installation:
  78. ```plaintext
  79. Install and configure yutu by following https://raw.githubusercontent.com/eat-pray-ai/yutu/main/internal/tools/skillgen/setup.md
  80. ```
  81. 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.
  82. <details>
  83. <summary>GitHub Actions</summary>
  84. 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.
  85. </details>
  86. <details>
  87. <summary>Node.js</summary>
  88. ```shell
  89. ❯ npm i -g @eat-pray-ai/yutu
  90. ```
  91. </details>
  92. <details>
  93. <summary>Docker</summary>
  94. ```shell
  95. # GitHub Container Registry (GHCR)
  96. ❯ docker pull ghcr.io/eat-pray-ai/yutu:latest
  97. # or Docker Hub
  98. ❯ docker pull eatprayai/yutu:latest
  99. ❯ docker run --rm ghcr.io/eat-pray-ai/yutu:latest
  100. # make sure client_secret.json is in the current directory
  101. ❯ docker run --rm -it -u $(id -u):$(id -g) -v $(pwd):/app -p 8216:8216 ghcr.io/eat-pray-ai/yutu:latest
  102. ```
  103. </details>
  104. <details>
  105. <summary>Gopher</summary>
  106. ```shell
  107. ❯ go install github.com/eat-pray-ai/yutu@latest
  108. ```
  109. </details>
  110. <details>
  111. <summary>Linux</summary>
  112. ```shell
  113. ❯ curl -sSfL https://raw.githubusercontent.com/eat-pray-ai/yutu/main/scripts/install.sh | bash
  114. ```
  115. </details>
  116. <details>
  117. <summary>macOS</summary>
  118. Install `yutu` using [Homebrew🍺](https://brew.sh/)(recommended), or run the shell script.
  119. ```shell
  120. ❯ brew install yutu
  121. # or
  122. ❯ curl -sSfL https://raw.githubusercontent.com/eat-pray-ai/yutu/main/scripts/install.sh | bash
  123. ```
  124. </details>
  125. <details>
  126. <summary>Windows</summary>
  127. ```shell
  128. ❯ winget install yutu
  129. ```
  130. </details>
  131. <details>
  132. <summary>Verifying Installation</summary>
  133. Verify the integrity and provenance of `yutu` using its associated cryptographically signed attestations.
  134. ```shell
  135. # Docker
  136. ❯ gh attestation verify oci://ghcr.io/eat-pray-ai/yutu:latest --repo eat-pray-ai/yutu
  137. ❯ gh attestation verify oci://docker.io/eatprayai/yutu:latest --repo eat-pray-ai/yutu
  138. # Linux and macOS(if installed using shell script)
  139. ❯ gh attestation verify $(which yutu) --repo eat-pray-ai/yutu
  140. # Windows
  141. ❯ gh attestation verify $(where.exe yutu.exe) --repo eat-pray-ai/yutu
  142. ```
  143. </details>
  144. ## Agent
  145. `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.
  146. ```shell
  147. # Gemini(compatible) (default)
  148. ❯ yutu agent --provider google --model gemini-4-hydrogen --api-key "YOUR_KEY"
  149. ❯ yutu agent --provider google --model gemini-4-carbon --api-key "YOUR_KEY" --base-url "https://custom.endpoint.com"
  150. # OpenAI(compatible) (OpenAI, DeepSeek, Ollama, vLLM, etc.)
  151. ❯ yutu agent --provider openai --model gpt-6-astra --api-key "YOUR_KEY"
  152. ❯ yutu agent --provider openai --model deepseek-flash --api-key "YOUR_KEY" --base-url "https://api.deepseek.com"
  153. # Anthropic(compatible)
  154. ❯ yutu agent --provider anthropic --model claude-fable-5-2 --api-key "YOUR_KEY"
  155. ❯ yutu agent --provider anthropic --model claude-opus-5-5 --api-key "YOUR_KEY" --base-url "https://custom.endpoint.com"
  156. # web mode with sub-launchers
  157. ❯ yutu agent --args "web api a2a webui" --api-key "YOUR_KEY"
  158. # show available launcher args
  159. ❯ yutu agent --args ""
  160. ```
  161. ### Agent Flags
  162. | Flag | Description | Default |
  163. | ------------------- | ----------------------------------------------- | ------------------------------------------ |
  164. | `-a, --args` | Launcher arguments as a single string | `console` |
  165. | `-p, --provider` | LLM provider: `google`, `openai` or `anthropic` | `google` |
  166. | `-m, --model` | Model name | `gemini-4-hydrogen` |
  167. | `--api-key` | API key for the model provider | |
  168. | `--base-url` | Base URL for the model provider's API endpoint | |
  169. | `-i, --instruction` | Override the built-in Agent instruction | [INSTRUCTION.md](cmd/agent/INSTRUCTION.md) |
  170. ## MCP Server
  171. 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).
  172. Setup yutu MCP for one or more selected AI Agents:
  173. ```shell
  174. ❯ yutu mcp setup --agents claude,opencode,pi,codex \
  175. --credential /absolute/path/to/client_secret.json \
  176. --cacheToken /absolute/path/to/youtube.token.json
  177. ```
  178. `--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.
  179. ## Skills
  180. `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.
  181. ```shell
  182. ❯ npx skills add eat-pray-ai/yutu --skill youtube-automation
  183. ```
  184. See [skills/youtube-automation/SKILL.md](skills/youtube-automation/SKILL.md) for the full list of supported operations.
  185. ## Usage
  186. ```shell
  187. ❯ yutu
  188. yutu is a CLI, MCP server, and AI Agent that automates your YouTube workflows from the terminal or any AI Agent.
  189. Environment variables:
  190. YUTU_CREDENTIAL Path/Base64/JSON of OAuth client secret (default: client_secret.json)
  191. YUTU_CACHE_TOKEN Path/Base64/JSON of cached OAuth token (default: youtube.token.json)
  192. YUTU_ROOT Root directory for file resolution (default: current working directory)
  193. YUTU_LOG_LEVEL Log level: DEBUG, INFO, WARN, ERROR (default: INFO)
  194. Usage:
  195. yutu [flags]
  196. yutu [command]
  197. Available Commands:
  198. abuseReport Manage YouTube abuse reports
  199. activity Manage YouTube activities
  200. agent Start an Agent to automate YouTube workflows
  201. auth Authenticate with YouTube APIs
  202. caption Manage YouTube video captions
  203. channel Manage YouTube channels
  204. channelBanner Manage YouTube channel banners
  205. channelSection Manage YouTube channel sections
  206. comment Manage YouTube comments
  207. commentThread Manage YouTube comment threads
  208. completion Generate the autocompletion script for the specified shell
  209. help Help about any command
  210. i18nLanguage Manage YouTube i18n languages
  211. i18nRegion Manage YouTube i18n regions
  212. liveBroadcast Manage YouTube live broadcasts
  213. liveChatBan Manage YouTube live chat bans
  214. liveChatMessage Manage YouTube live chat messages
  215. liveChatModerator Manage YouTube live chat moderators
  216. liveStream Manage YouTube live streams
  217. mcp Start MCP server
  218. member Manage YouTube channel members
  219. membershipsLevel Manage YouTube membership levels
  220. playlist Manage YouTube playlists
  221. playlistImage Manage YouTube playlist images
  222. playlistItem Manage YouTube playlist items
  223. search Manage YouTube search
  224. subscription Manage YouTube subscriptions
  225. superChatEvent Manage YouTube Super Chat events
  226. thirdPartyLink Manage YouTube third-party links
  227. thumbnail Manage YouTube video thumbnails
  228. version Show the version of yutu
  229. video Manage YouTube videos
  230. videoAbuseReportReason Manage YouTube video abuse report reasons
  231. videoCategory Manage YouTube video categories
  232. watermark Manage YouTube watermarks
  233. Flags:
  234. -h, --help help for yutu
  235. Use "yutu [command] --help" for more information about a command.
  236. ```
  237. ## Features
  238. Please refer to [FEATURES.md](docs/FEATURES.md) for more information.
  239. ## Sponsor
  240. 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.
  241. You can also support its development with a donation (Alipay / WeChat) at [yutu.ifor.dev](https://yutu.ifor.dev/#donate). Thank you! 💖
  242. ## Contributing
  243. Please refer to [CONTRIBUTING.md](docs/CONTRIBUTING.md) for more information.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.