youtube-automation

io.github.eat-pray-ai由 GitHub 账号 eat-pray-ai 发布v0.11.1更新于 Nov 15, 2026

用于自动化 YouTube 工作流程的 CLI、MCP 服务器和 AI Agent

AI 翻译由 AI 模型根据下方的原文描述翻译,可能有误。

原文描述

CLI, MCP server, and AI Agent to automate YouTube workflows

已验证STDIO仅桌面沟通与协作媒体与设计

概览

youtube-automation 的本地 MCP 服务;无需登录;STDIO;74 个工具。

暂无 AI 概览:以下信息来自注册中心条目和服务本身。

安装

在 SourceWeft 中

  1. 打开 控制台中的 youtube-automation,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

[Yutu]

yutu

[Static Badge] [GitHub License] [Go Reference] [Go Coverage]

[GitHub Repo stars] [GitHub Downloads] [GitHub Actions build Status] [GitHub Actions CodeQL Status] [GitHub Actions test Status] [LINUX DO]

[GitHub Release] [Homebrew Formula Version] [WinGet Package Version] [npm Version]

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. 中文文档

[mcp demo]

Table of Contents

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:

  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

VariableDescriptionDefault
YUTU_CREDENTIALPath, Base64, or JSON of OAuth client secretclient_secret.json
YUTU_CACHE_TOKENPath, Base64, or JSON of cached OAuth tokenyoutube.token.json
YUTU_ROOTRoot directory for file resolutionCurrent working directory
YUTU_LOG_LEVELLog level: DEBUG, INFO, WARN, ERRORINFO

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 directly, or use the following methods as you prefer.

GitHub Actions

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.

Node.js
shell
❯ npm i -g @eat-pray-ai/yutu
Docker
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
Gopher
shell
❯ go install github.com/eat-pray-ai/yutu@latest
Linux
shell
❯ curl -sSfL https://raw.githubusercontent.com/eat-pray-ai/yutu/main/scripts/install.sh | bash
macOS

Install yutu using Homebrew🍺(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
Windows
shell
❯ winget install yutu
Verifying Installation

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

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-3.8-flash --api-key "YOUR_KEY"❯ yutu agent --provider google --model gemini-3.8-flash --api-key "YOUR_KEY" --base-url "https://custom.endpoint.com/"# OpenAI(compatible) (OpenAI, DeepSeek, Ollama, vLLM, etc.)❯ yutu agent --provider openai --model gpt-5.6-terra --api-key "YOUR_KEY"❯ yutu agent --provider openai --model deepseek-flash --api-key "YOUR_KEY" --base-url "https://api.deepseek.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

FlagDescriptionDefault
-a, --argsLauncher arguments as a single stringconsole
-p, --providerLLM provider: google for Gemini(compatible), openai for OpenAI(compatible)google
-m, --modelModel namegemini-3.8-flash
--api-keyAPI key for the model provider
--base-urlBase URL for the model provider's API endpoint
-i, --instructionOverride the built-in Agent instructionINSTRUCTION.md

MCP Server

Before using yutu as an MCP server, make sure yutu is installed(see Installation section), and you have a valid client_secret.json and youtube.token.json files(refer to 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 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 for the full list of supported operations.

Usage

shell
❯ yutuyutu 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 for more information.

Sponsor

If yutu saves you time, a ⭐ star 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. Thank you! 💖

Contributing

Please refer to CONTRIBUTING.md for more information.

来源:README.md,提交 59095f7

工具

74

abuseReport-insert

Create an abuse report

Create an abuse report. Use this tool to report abusive content on YouTube such as spam, harassment, or violent content.

输入参数partsoutputsubject_id必填abuse_types必填descriptionsubject_urlsubject_type_id必填related_entity_id

activity-list

List activities

List activities. Use this tool to list activities such as uploads, likes, and favorites.

输入参数forpartsoutputchannel_idmax_resultsregion_codepublished_afterpublished_before

caption-delete

Delete captions

Delete captions. Use this tool to delete captions of a video by IDs.

输入参数ids必填on_behalf_ofon_behalf_of_content_owner

caption-download

Download a caption

Download a caption. Use this tool to download a caption from a video.

输入参数ids必填file必填tfmttlangon_behalf_ofon_behalf_of_content_owner

caption-insert

Upload a caption

Upload a caption. Use this tool to upload a caption to a video.

输入参数file必填nameis_ccoutputis_draftis_largelanguagevideo_id必填on_behalf_ofis_auto_syncedis_easy_readeron_behalf_of_content_owner

caption-list

List captions

List captions. Use this tool to list captions of a video.

输入参数idspartsoutputvideo_idon_behalf_ofon_behalf_of_content_owner

caption-update

Update a caption

Update a caption. Use this tool to update a caption.

输入参数filenameis_ccoutputis_draftis_largelanguagevideo_id必填track_kindon_behalf_ofis_auto_syncedis_easy_reader另有 2 个

channel-list

List channels

List channels. Use this tool to list channels.

输入参数hlforidspartsoutputfor_handlecategory_idmax_resultsfor_usernameon_behalf_of_content_owner

channel-update

Update a channel

Update a channel. Use this tool to update a channel.

输入参数ids必填titleoutputcountrykeywordsdescriptiondefault_language

channelBanner-insert

Upload a channel banner

Upload a channel banner. Use this tool to upload a channel banner.

输入参数file必填outputchannel_id必填on_behalf_of_content_owneron_behalf_of_content_owner_channel

channelSection-delete

Delete channel sections

Delete channel sections. Use this tool to delete channel sections by IDs.

输入参数ids必填on_behalf_of_content_owner

channelSection-list

List channel sections

List channel sections. Use this tool to list channel sections.

输入参数hlidsminepartsoutputchannel_idon_behalf_of_content_owner

comment-delete

Delete comments

Delete comments. Use this tool to delete comments by IDs.

输入参数ids必填

comment-insert

Create a comment

Create a comment. Use this tool to create a comment on a video.

输入参数outputcan_ratevideo_idparent_id必填channel_idtext_original必填author_channel_id

comment-list

List comments

List comments. Use this tool to list comments by IDs.

输入参数idspartsoutputparent_idmax_resultstext_format

comment-markAsSpam

Mark comments as spam

Mark comments as spam. Use this tool to mark comments as spam.

输入参数ids必填output

comment-setModerationStatus

Set comment moderation status

Set comment moderation status. Use this tool to set comment moderation status.

输入参数ids必填outputban_authormoderation_status必填

comment-update

Update a comment

Update a comment. Use this tool to update a comment.

输入参数ids必填outputcan_ratetext_originalviewer_rating

commentThread-insert

Create a comment thread

Create a comment thread. Use this tool to create a comment thread.

输入参数outputvideo_id必填channel_id必填text_original必填author_channel_id

commentThread-list

List comment threads

List comment threads. Use this tool to list comment threads.

输入参数idsorderpartsoutputvideo_idchannel_idmax_resultstext_formatsearch_termsmoderation_statusall_threads_related_to_channel_id

liveBroadcast-bind

Bind a live broadcast to a stream

Bind a live broadcast to a stream. Use this tool to bind or unbind a live stream to/from a live broadcast.

输入参数ids必填partsoutputstream_idon_behalf_of_content_owneron_behalf_of_content_owner_channel

liveBroadcast-delete

Delete live broadcasts

Delete live broadcasts. Use this tool to delete live broadcasts by their IDs.

输入参数ids必填on_behalf_of_content_owneron_behalf_of_content_owner_channel

liveBroadcast-insert

Create a live broadcast

Create a live broadcast. Use this tool to create a live broadcast for the authenticated user.

输入参数partstitle必填outputdescriptionprivacy_statusscheduled_end_timescheduled_start_time必填on_behalf_of_content_owneron_behalf_of_content_owner_channel

liveBroadcast-insertCuepoint

Insert a cuepoint into a live broadcast

Insert a cuepoint into a live broadcast. Use this tool to insert an ad break cuepoint into a currently live broadcast.

输入参数ids必填outputcue_typecue_walltime_mscue_duration_secscue_insertion_offset_mson_behalf_of_content_owneron_behalf_of_content_owner_channel

liveBroadcast-list

List live broadcasts

List live broadcasts. Use this tool to list live broadcasts for the authenticated user.

输入参数idsminepartsoutputmax_resultsbroadcast_typebroadcast_statuson_behalf_of_content_owneron_behalf_of_content_owner_channel

liveBroadcast-transition

Transition a live broadcast

Transition a live broadcast. Use this tool to change the status of a live broadcast (e.g., go live, end broadcast).

输入参数ids必填partsoutputbroadcast_status必填on_behalf_of_content_owneron_behalf_of_content_owner_channel

liveBroadcast-update

Update a live broadcast

Update a live broadcast. Use this tool to update an existing live broadcast's settings.

输入参数ids必填titleoutputdescriptionprivacy_statusscheduled_end_timescheduled_start_timeon_behalf_of_content_owneron_behalf_of_content_owner_channel

liveChatBan-delete

Delete live chat bans

Delete live chat bans. Use this tool to unban users from a live chat by ban IDs.

输入参数ids必填

liveChatBan-insert

Create a live chat ban

Create a live chat ban. Use this tool to ban a user from a live chat.

输入参数partsoutputban_type必填live_chat_id必填ban_duration_secondsbanned_user_channel_id必填

liveChatMessage-delete

Delete live chat messages

Delete live chat messages. Use this tool to remove messages from a live chat by their IDs.

输入参数ids必填

liveChatMessage-insert

Send a live chat message

Send a live chat message. Use this tool to post a text message to a live chat.

输入参数partsoutputlive_chat_id必填message_text必填

liveChatMessage-list

List live chat messages

List live chat messages. Use this tool to list messages in a live chat.

输入参数hlpartsoutputmax_resultslive_chat_id必填

liveChatMessage-transition

Transition a live chat message

Transition a durable live chat event. Use this tool to change the status of a live chat message (e.g., close a poll).

输入参数ids必填outputstatus必填

liveChatModerator-delete

Delete live chat moderators

Delete live chat moderators. Use this tool to remove moderators from a live chat by their IDs.

输入参数ids必填

liveChatModerator-insert

Add a live chat moderator

Add a live chat moderator. Use this tool to add a moderator to a live chat.

输入参数partsoutputlive_chat_id必填moderator_channel_id必填

liveChatModerator-list

List live chat moderators

List live chat moderators. Use this tool to list moderators for a live chat.

输入参数partsoutputmax_resultslive_chat_id必填

liveStream-delete

Delete live streams

Delete live streams. Use this tool to delete live streams by their IDs.

输入参数ids必填on_behalf_of_content_owneron_behalf_of_content_owner_channel

liveStream-insert

Create a live stream

Create a live stream. Use this tool to create a live stream.

输入参数partstitle必填outputframe_rateresolution必填descriptioningestion_type必填on_behalf_of_content_owneron_behalf_of_content_owner_channel

liveStream-list

List live streams

List live streams. Use this tool to list live streams for the authenticated user.

输入参数idsminepartsoutputmax_resultson_behalf_of_content_owneron_behalf_of_content_owner_channel

liveStream-update

Update a live stream

Update a live stream. Use this tool to update an existing live stream's settings.

输入参数ids必填titleoutputframe_rateresolutiondescriptioningestion_typeon_behalf_of_content_owneron_behalf_of_content_owner_channel

member-list

List channel members

List channel members. Use this tool to list information about channel members.

输入参数modepartsoutputmax_resultsmember_channel_idhas_access_to_level

membershipsLevel-list

List membership levels

List membership levels. Use this tool to list membership levels.

输入参数partsoutput

playlist-delete

Delete playlists

Delete playlists. Use this tool to delete playlists by IDs.

输入参数ids必填on_behalf_of_content_owner

playlist-insert

Create a playlist

Create a playlist. Use this tool to create a playlist.

输入参数tagstitle必填outputprivacy必填languagechannel_id必填description

playlist-list

List playlists

List playlists. Use this tool to list playlists.

输入参数hlidsminepartsoutputchannel_idmax_resultson_behalf_of_content_owneron_behalf_of_content_owner_channel

playlist-update

Update a playlist

Update a playlist. Use this tool to update a playlist.

输入参数ids必填tagstitleoutputprivacylanguagedescription

playlistImage-delete

Delete playlist images

Delete playlist images. Use this tool to delete playlist images by IDs.

输入参数ids必填on_behalf_of_content_owner

playlistImage-insert

Upload a playlist image

Upload a playlist image. Use this tool to upload a playlist image.

输入参数file必填typewidthheightoutputplaylist_id必填on_behalf_of_content_owneron_behalf_of_content_owner_channel

playlistImage-list

List playlist images

List playlist images. Use this tool to list playlist images.

输入参数partsoutputparentmax_resultson_behalf_of_content_owneron_behalf_of_content_owner_channel

playlistImage-update

Update a playlist image

Update a playlist image. Use this tool to update a playlist image.

输入参数typewidthheightoutputplaylist_id必填on_behalf_of_content_owneron_behalf_of_content_owner_channel

playlistItem-delete

Delete playlist items

Delete playlist items. Use this tool to delete playlist items by IDs.

输入参数ids必填on_behalf_of_content_owner

playlistItem-insert

Add a playlist item

Add a playlist item. Use this tool to add a playlist item to a playlist.

输入参数kind必填titleoutputprivacychannel_id必填k_video_iddescriptionplaylist_id必填k_channel_idk_playlist_idon_behalf_of_content_owner

playlistItem-list

List playlist items

List playlist items. Use this tool to list playlist items.

输入参数idspartsoutputvideo_idmax_resultsplaylist_idon_behalf_of_content_owner

playlistItem-update

Update a playlist item

Update a playlist item. Use this tool to update a playlist item.

输入参数ids必填titleoutputprivacydescriptionon_behalf_of_content_owner

search-list

Search resources

Search resources. Use this tool to search for videos, channels, playlists, and other resources.

输入参数qfororderpartstypesoutputlocationtopic_idchannel_idevent_typevideo_typemax_results另有 17 个

subscription-delete

Delete subscriptions

Delete subscriptions. Use this tool to delete subscriptions by IDs.

输入参数ids必填

subscription-insert

Subscribe to a channel

Subscribe to a channel. Use this tool to subscribe to a YouTube channel.

输入参数titleoutputchannel_id必填descriptionsubscriber_channel_id必填

subscription-list

List subscriptions

List subscriptions. Use this tool to list subscriptions.

输入参数foridsorderpartsoutputchannel_idmax_resultsfor_channel_idon_behalf_of_content_owneron_behalf_of_content_owner_channel

superChatEvent-list

List Super Chat events

List Super Chat events. Use this tool to list Super Chat events.

输入参数hlpartsoutputmax_results

thumbnail-set

Set a thumbnail for a video

Set a thumbnail for a video. Use this tool to set a thumbnail for a video.

输入参数file必填outputvideo_id必填

video-delete

Delete videos

Delete videos. Use this tool to delete videos by IDs.

输入参数ids必填

video-getRating

Get video ratings

Get video ratings. Use this tool to get video ratings by IDs.

输入参数ids必填outputon_behalf_of_content_owner

video-insert

Upload a video

Upload a video. Use this tool to upload a video.

输入参数file必填tagstitleoutputlicenseprivacy必填for_kidslanguagestabilizethumbnailchannel_idembeddable另有 11 个

video-list

List videos

List videos. Use this tool to list videos.

输入参数hlidschartpartslocaleoutputratingmax_widthmax_heightcategory_idmax_resultsregion_code另有 1 个

video-rate

Rate a video

Rate a video. Use this tool to rate a video.

输入参数ids必填rating必填

video-reportAbuse

Report abuse on a video

Report abuse on a video. Use this tool to report abuse on a video.

输入参数ids必填commentslanguagereason_id必填secondary_reason_idon_behalf_of_content_owner

video-update

Update a video

Update a video. Use this tool to update a video.

输入参数ids必填tagstitleoutputlicenseprivacylanguagethumbnailembeddablepublish_atcategory_iddescription另有 3 个

videoAbuseReportReason-list

List video abuse report reasons

List video abuse report reasons. Use this tool to list available abuse report reasons.

输入参数hlpartsoutput

watermark-set

Set a channel watermark

Set a channel watermark. Use this tool to set a channel watermark.

输入参数file必填offset_mschannel_id必填duration_msoffset_typein_video_positionon_behalf_of_content_owner

watermark-unset

Unset a channel watermark

Unset a channel watermark. Use this tool to unset a channel watermark.

输入参数channel_id必填

版本历史

3
  1. v0.11.1最新Nov 15, 2026
  2. v0.11.0Oct 15, 2026
  3. v0.10.11-dev3Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分