eat-pray-ai/yutu

yutu – AI 기반 YouTube 자동화 툴킷

무엇인가요 – yutu는 Go 기반의 명령줄 도구이며, MCP(Model-Control-Protocol) 서버와 AI 에이전트 모드도 함께 제공합니다. YouTube Data, Analytics, Reporting API와 통신하여 언어 모델이 YouTube 전반의 워크플로우(동영상 업로드, 제목/설명 편집, 댓글 관리, 플레이리스트, 채널 브랜딩, 라이브 스트리밍 등)를 제어할 수 있도록 합니다.

주요 구성 요소

• CLI – YouTube API 작업에 직접 매핑되는 풍부한 하위 명령어(video upload, comment list, playlist create, …)를 제공합니다.
• 에이전트 모드 – LLM 기반의 "Miffy" 에이전트(기본은 Gemini-3.8-flash, OpenAI 호환 모델이라면 어떤 모델도 사용 가능)를 시작합니다. 프롬프트를 받고 내부적으로 CLI를 호출하며, SEO, 성장 전략, 채널 브랜딩에 대해 추론할 수 있습니다.
• MCP 서버 – 표준 MCP 인터페이스(Stdio 또는 HTTP)를 통해 동일한 기능을 노출하여, 다른 AI 어시스턴트 플랫폼(Claude, Codex, VS Code, Cursor 등)이 YouTube 작업을 "스킬"로 호출할 수 있도록 합니다.
• 스킬 패키지 – OpenCode 스킬을 소비하는 모든 AI 에이전트가 YouTube 도메인을 설명할 수 있도록 재사용 가능한 스킬 정의(skills/youtube)를 제공합니다.

설치 방법 – 사전 빌드된 바이너리(GitHub 릴리스, Homebrew, WinGet, npm, Docker) 또는 go install. 설치 스크립트는 암호학적 증명(cryptographic attestations)을 검증합니다.

설정 단계

1. GCP 프로젝트를 생성하고 YouTube Data API(필수) 및 선택적 Analytics/Reporting API를 활성화합니다.
2. OAuth 클라이언트 ID(데스크톱 앱)를 생성하고 client_secret.json을 다운로드합니다.
3. yutu auth --credential client_secret.json을 실행하여 youtube.token.json을 획득합니다.
4. 환경 변수(YUTU_CREDENTIAL, YUTU_CACHE_TOKEN 등)를 설정하거나 --credential/--cacheToken 플래그를 사용합니다.

일반적인 사용법

# Gemini를 통해 자동 제목/설명 생성으로 동영상 업로드
yutu agent --provider google --model gemini-3.8-flash --api-key $GEMINI_KEY

# 직접 CLI로 업로드
yutu video upload --file myvideo.mp4 --title "My Title" --description "..."

# 다른 도구용 MCP 서버 시작
yutu mcp --mode http   # 기본적으로 8216 포트에서 리슨

왜 중요한가 – YouTube 채널 관리는 번거롭고 API가 많아 다루기 어렵습니다. yutu는 YouTube API를 CLI로 래핑하고 LLM에 노출함으로써 개발자와 콘텐츠 제작자가 반복 작업을 자동화하고, AI 기반 SEO 추천을 적용하며, YouTube 작업을 더 넓은 AI 에이전트나 워크플로우에 통합할 수 있게 해줍니다.

문서 – README, FEATURES.md, INSTRUCTION.md, 자동 생성된 Go 문서(pkg.go.dev). 기여 가이드라인도 제공됩니다.