Browser Automation Go ★ 562

eat-pray-ai/yutu

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

Yutu

yutu

Static Badge Go Report Card 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

YouTube CLI, MCP server, Skill and Agent - AI-powered toolkit that grows YouTube channel on autopilot | Product
Hunt

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

mcp demo

İçindekiler

Ön Koşullar

Google Cloud Platform üzerinde bir hesap gereklidir. Aşağıdakileri ayarlayın:

  1. GCP Projesi Oluşturun ve APIs & Services -> Enable APIs and services altında bu API'leri etkinleştirin:

  2. OAuth kimlik bilgileri oluşturun:

    • APIs & Services -> OAuth consent screen sayfasına gidin, kendinizi test kullanıcısı olarak ekleyerek bir onay ekranı oluşturun
    • Credentials -> Create Credentials -> OAuth Client ID sayfasına gidin, Desktop app seçin
    • Kimlik bilgisi dosyasını indirin ve client_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"
        ]
      }
    }
    
  3. 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.

Global Ortam Değişkenleri

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

Kurulum

yutu'yu sürümler sayfasından doğrudan indirebilir veya tercih ettiğiniz yöntemi kullanabilirsiniz.

GitHub Actions

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.

Node.js

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

Docker

❯ 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

Gopher

❯ go install github.com/eat-pray-ai/yutu@latest

Linux

❯ curl -sSfL https://raw.githubusercontent.com/eat-pray-ai/yutu/main/scripts/install.sh | bash

macOS

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

Windows

❯ winget install yutu

Kurulumun Doğrulanması

İ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

Agent

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.

Agent Ortam Değişkenleri

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 Sunucusu

Install in VS Code Install in Cursor

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

Beceriler

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.

Kullanım

❯ 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.

Özellikler

Daha fazla bilgi için FEATURES.md dosyasına bakın.

Katkıda Bulunma

Daha fazla bilgi için CONTRIBUTING.md dosyasına bakın.

Star Geçmişi

Star History Chart

Benzer MCP sunucuları

Daha fazla: Browser Automation →