YouTube işlemlerini otomatikleştirmek için tam işlevsel MCP sunucusu ve CLI.
Claude Desktop config.json'a ekle
{
"mcpServers": {
"eat-pray-ai-yutu": {
"command": "node",
"args": [
"~/.mcp/yutu/index.js"
]
}
}
} Kaynak kodu al ve yerel olarak çalıştır
git clone https://github.com/eat-pray-ai/yutu.git ~/.mcp/yutu
cd ~/.mcp/yutu yutuyutu, YouTube'u otomatikleştirmek için bir CLI, MCP sunucusu ve AI ajanıdır — videoları yükleme ve optimize etmekten yorum, çalma listeleri ve kanal markası yönetimine kadar — daha az manuel çaba ile daha fazla görüntülenme, daha yüksek tıklama oranları ve daha güçlü izleyici katılımı elde etmenizi sağlar. 中文文档
Google Cloud Platform üzerinde bir hesap gereklidir. Aşağıdakileri ayarlayın:
GCP Projesi Oluşturun ve APIs & Services -> Enable APIs and services altında bu API'leri etkinleştirin:
OAuth kimlik bilgileri oluşturun:
APIs & Services -> OAuth consent screen sayfasına gidin, kendinizi test kullanıcısı olarak ekleyerek bir onay ekranı oluşturunCredentials -> Create Credentials -> OAuth Client ID sayfasına gidin, Desktop app seçinclient_secret.json olarak kaydedin, şuna benzer olmalıdır:{
"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"
]
}
}
Kimlik Doğrulama:
yutu auth --credential client_secret.json
YouTube erişimini vermek için bir tarayıcı penceresi açılacaktır. İzin verdikten sonra, bir token youtube.token.json dosyasına kaydedilir.
{
"access_token": "ya29.XXXXXXXXX",
"token_type": "Bearer",
"refresh_token": "1//XXXXXXXXXX",
"expiry": "2024-05-26T18:49:56.1911165+08:00",
"expires_in": 3599
}
Varsayılan olarak, yutu geçerli dizinden client_secret.json ve youtube.token.json dosyalarını okuyacaktır. --credential/-c ve --cacheToken/-t bayrakları yalnızca auth alt komutu altında kullanılabilir. Tüm alt komutlarda varsayılan yolu değiştirmek için bu ortam değişkenlerini ayarlayın.
| Değişken | Açıklama | Varsayılan |
|---|---|---|
YUTU_CREDENTIAL |
OAuth istemci sırrının yolu, base64 veya JSON | client_secret.json |
YUTU_CACHE_TOKEN |
Önbelleğe alınan OAuth tokeninin yolu, base64 veya JSON | youtube.token.json |
YUTU_ROOT |
Dosya çözümleme için kök dizin | Geçerli çalışma dizini |
YUTU_LOG_LEVEL |
Log seviyesi: DEBUG, INFO, WARN, ERROR |
INFO |
yutu'yu sürümler sayfasından doğrudan indirebilir veya tercih ettiğiniz yöntemi kullanabilirsiniz.
Yutu için kullanılabilir iki action vardır, biri genel amaçlı, diğeri YouTube'a video yükleme için kullanılır. Daha fazla bilgi için youtube-action ve youtube-uploader sayfalarına bakın.
❯ npm i -g @eat-pray-ai/yutu
❯ docker pull ghcr.io/eat-pray-ai/yutu:latest
❯ docker run --rm ghcr.io/eat-pray-ai/yutu:latest
# client_secret.json dosyasının geçerli dizinde olduğundan emin olun
❯ docker run --rm -it -u $(id -u):$(id -g) -v $(pwd):/app -p 8216:8216 ghcr.io/eat-pray-ai/yutu:latest
❯ go install github.com/eat-pray-ai/yutu@latest
❯ curl -sSfL https://raw.githubusercontent.com/eat-pray-ai/yutu/main/scripts/install.sh | bash
Homebrew🍺 kullanarak yutu'yu yükleyin (önerilir) veya shell script'ini çalıştırın.
❯ brew install yutu
# veya
❯ curl -sSfL https://raw.githubusercontent.com/eat-pray-ai/yutu/main/scripts/install.sh | bash
❯ winget install yutu
İlişkili şifreli olarak imzalanmış attestations kullanarak yutu'nun bütünlüğünü ve kökenini doğrulayın.
# Docker
❯ gh attestation verify oci://ghcr.io/eat-pray-ai/yutu:latest --repo eat-pray-ai/yutu
# Linux ve macOS (shell script kullanılarak kurulmuşsa)
❯ gh attestation verify $(which yutu) --repo eat-pray-ai/yutu
# Windows
❯ gh attestation verify $(where.exe yutu.exe) --repo eat-pray-ai/yutu
yutu, YouTube iş akışlarını otomatikleştirmek için bir agent modu sağlar. Sistem, merkezi bir orkestratörün görevleri uzmanlaşmış agentlere devretti ği çok agentalı bir mimariye sahiptir:
| Agent | Rol | Yetenekler |
|---|---|---|
| Orchestrator | Tüm iş akışını koordine eder, strateji planlar ve alt agentlere devredilir | YouTube büyüme stratejisi, SEO optimizasyonu, görev yönlendirmesi |
| Retrieval | YouTube ve web'den veri toplar (salt okunur) | Videoları/kanalları/çalma listelerini/yorumları/altyazıları/abonelikleri/üyeleri listele/ara; Google Search |
| Modifier | YouTube içeriği oluşturur ve günceller | Videoları yükle, çalma listesi oluştur, meta veri güncelle, yorum yap, küçük resim ayarla, altyazı yönetimi |
| Destroyer | Yıkıcı işlemleri ekstra dikkatle yürütür | Videoları/çalma listelerini/yorumları/altyazıları/abonelikleri/kanal bölümlerini/filigranları sil |
Şu anda, agent modu aktif geliştirilmekte ve yalnızca aşağıdaki ortam değişkenleri ayarlanmış Google'ın Gemini modellerini desteklemektedir:
❯ export YUTU_ADVANCED_MODEL=google:gemini-3.1-pro-preview
❯ export YUTU_LITE_MODEL=google:gemini-3-flash-preview
❯ export YUTU_LLM_API_KEY=your_gemini_api_key
// İsteğe bağlı ayarlar
❯ export GOOGLE_GEMINI_BASE_URL=https://generativelanguage.googleapis.com/
❯ export YUTU_AGENT_INSTRUCTION=Özel talimatlarınız
YUTU_ADVANCED_MODEL orkestratör agent tarafından kullanılırken, YUTU_LITE_MODEL diğer tüm agentler tarafından kullanılır. Her ikisi de provider:modelName biçimini kullanır (yalnızca google desteklenir). Yalnızca biri ayarlanırsa, diğeri varsayılan olarak aynı değere sahip olur.
| Değişken | Açıklama | Gerekli |
|---|---|---|
YUTU_ADVANCED_MODEL |
Orkestratör agent modeli (biçim: provider:modelName) |
YUTU_ADVANCED_MODEL veya YUTU_LITE_MODEL'den en az biri |
YUTU_LITE_MODEL |
Alt agentler modeli (biçim: provider:modelName) |
YUTU_ADVANCED_MODEL veya YUTU_LITE_MODEL'den en az biri |
YUTU_LLM_API_KEY |
Model sağlayıcı API anahtarı | Evet |
GOOGLE_GEMINI_BASE_URL |
Gemini API'si taban URL'si | Hayır |
YUTU_AGENT_INSTRUCTION |
Orkestratör agent için özel talimatlar | Hayır |
YUTU_RETRIEVAL_INSTRUCTION |
Retrieval agent için özel talimatlar | Hayır |
YUTU_MODIFIER_INSTRUCTION |
Modifier agent için özel talimatlar | Hayır |
YUTU_DESTROYER_INSTRUCTION |
Destroyer agent için özel talimatlar | Hayır |
Daha sonra ayrıntılı kullanım için aşağıdaki komutu çalıştırın:
❯ yutu agent --help
❯ yutu agent --args "help"
# konsol modu
❯ yutu agent --args "console"
# web modu üç alt başlatıcı ile: api, a2a ve webui
❯ yutu agent --args "web api a2a webui"
MCP server olarak, yutu Claude Desktop, VS Code veya Cursor gibi MCP istemcilerinde kullanılabilir ve sohbet benzeri bir arayüzde YouTube kaynaklarıyla etkileşim kurmanızı sağlar.
yutu'yu MCP sunucusu olarak kullanmadan önce, yutu'nun kurulu olduğundan (bkz. Kurulum bölümü) ve geçerli client_secret.json ve youtube.token.json dosyalarına sahip olduğunuzdan emin olun (bkz. Ön Koşullar bölümü).
Yukarıdaki ilgili rozeti tıklayarak veya MCP istemcinize aşağıdaki yapılandırmayı el ile ekleyerek VS Code veya Cursor'a yutu'yu MCP sunucusu olarak ekleyebilirsiniz. YUTU_CREDENTIAL ve YUTU_CACHE_TOKEN değerlerini yerel makinenizde doğru yollarla değiştirmeyi unutmayın.
{
"yutu": {
"type": "stdio",
"command": "yutu",
"args": [
"mcp"
],
"env": {
"YUTU_CREDENTIAL": "/absolute/path/to/client_secret.json",
"YUTU_CACHE_TOKEN": "/absolute/path/to/youtube.token.json"
}
}
}
yutu, YouTube etki alanı bilgisi, yaygın iş akışları ve SEO en iyi uygulamalarıyla AI agentlarını genişleten birleştirilmiş bir beceri sağlar — videolar, çalma listeleri, yorumlar, kanallar, altyazılar, abonelikler ve daha fazlasını kapsar.
❯ npx skills add https://github.com/eat-pray-ai/yutu/tree/main/skills/youtube
Desteklenen işlemlerin tam listesi için skills/youtube/SKILL.md dosyasına bakın.
❯ yutu
yutu, YouTube'un hemen hemen tüm kaynaklarını manipüle edebilecek tam işlevli bir MCP sunucusu ve CLI'dır.
Ortam değişkenleri:
YUTU_CREDENTIAL OAuth istemci sırrının yolu/base64/JSON (varsayılan: client_secret.json)
YUTU_CACHE_TOKEN Önbelleğe alınan OAuth tokeninin yolu/base64/JSON (varsayılan: youtube.token.json)
YUTU_ROOT Dosya çözümleme için kök dizin (varsayılan: geçerli çalışma dizini)
YUTU_LOG_LEVEL Log seviyesi: DEBUG, INFO, WARN, ERROR (varsayılan: INFO)
Kullanım:
yutu [bayraklar]
yutu [komut]
Kullanılabilir Komutlar:
activity YouTube'daki aktiviteleri yönetin
agent YouTube iş akışlarını otomatikleştirmek için ajanı başlatın
auth YouTube API'leriyle kimlik doğrulama yapın
caption YouTube video altyazılarını yönetin
channel YouTube kanallarını yönetin
channelBanner YouTube kanal başlıklarını yönetin
channelSection YouTube kanal bölümlerini yönetin
comment YouTube yorumlarını yönetin
commentThread YouTube yorum başlıklarını yönetin
completion Belirtilen shell için otomatik tamamlama betiğini oluşturun
help Komutlar hakkında yardım
i18nLanguage YouTube i18n dillerini yönetin
i18nRegion YouTube i18n bölgelerini yönetin
mcp MCP sunucusunu başlatın
member YouTube kanal üyelerini yönetin
membershipsLevel YouTube üyelik seviyelerini yönetin
playlist YouTube çalma listelerini yönetin
playlistImage YouTube çalma listesi resimlerini yönetin
playlistItem YouTube çalma listesi öğelerini yönetin
search YouTube aramasını yönetin
subscription YouTube aboneliklerini yönetin
superChatEvent YouTube Super Chat etkinliklerini yönetin
thumbnail YouTube video küçük resimlerini yönetin
version Yutu'nun sürümünü gösterin
video YouTube videolarını yönetin
videoAbuseReportReason YouTube video istismar raporu nedenlerini yönetin
videoCategory YouTube video kategorilerini yönetin
watermark YouTube filigranlarını yönetin
Bayraklar:
-h, --help Yardım için
Bir komut hakkında daha fazla bilgi için "yutu [komut] --help" komutunu kullanın.
Daha fazla bilgi için FEATURES.md dosyasına bakın.
Daha fazla bilgi için CONTRIBUTING.md dosyasına bakın.
Puppeteer ile tarayıcı otomasyon yetenekleri, yerel ve uzak tarayıcı bağlantısını destekler.
Microsoft'un resmi Playwright MCP sunucusu, LLM'lerin yapılandırılmış erişilebilirlik anlık görüntüleri aracılığıyla web sayfalarıyla etkileşim kurmasını sağlıyor.
LLM'ler ve bilgisayarlı görü kullanarak tarayıcı tabanlı iş akışlarını otomatikleştirin — sayfaları gezin, formları doldurun, veri çıkarın, kimlik doğrulaması yönetin ve herhangi bir web sitesini doğal dil ile otomatize edin.
Yerel Chrome tarayıcınızı otomatikleştirin
Tarayıcı otomasyonu ve web scraping için Playwright kullanan bir MCP sunucusu
Bulut ortamında tarayıcı etkileşimlerini otomatikleştirin (web navigasyonu, veri çıkarma, form doldurma ve daha fazlası)