Yutu의 개요
Yutu는 eat-pray-ai 조직이 만든 단일 Go 바이너리로, YouTube 채널 관리를 위한 명령줄 도구, MCP 서버, 내장 에이전트로 동작합니 다. YouTube Data API v3를 리소스별로 다루며 동영상, 자막, 썸네일, 댓글과 댓글 스레드, 재생목록, 채널 정보와 배너, 워터마크, 구독, 라이브 방송, 라이브 채팅, 운영자를 지원합니다. 기능 표에는 74개 작업이 MCP 도구로 표시되어 있고, 언어와 동영상 카테고리 같은 일부 읽기 전용 목록은 리소스로 노출됩니다.
저장소의 스타는 약 720개이고 라이선스는 Apache-2.0이며, 2026년 11월 15일에 v0.11.1을 출시했고 최신 커밋도 같은 날입니다. Homebrew, WinGet, npm, Go, Docker, 셸 스크립트로 설치할 수 있고 서명된 빌드 증명이 있으며, MCP Registry에 io.github.eat-pray-ai/yutu로 등록되어 있습니다.
Yutu 설치 방법
brew install yutu && yutu mcp setup --agents claude --credential /path/to/client_secret.json --cacheToken /path/to/youtube.token.jsonYutu, 쓸 만한 가치가 있습니까?
Yutu는 YouTube 채널을 완전히 제어하는 Google OAuth 토큰을 보관합니다. youtube, youtube.force-ssl, youtube.channel-memberships.creator 세 가지 스코프를 요청하며, 이를 통해 에이전트는 동영상 업로드와 삭제, 제목과 설명 수정, 썸네일과 워터마크 설정, 댓글 게시·수정·삭제·스팸 신고, 라이브 채팅 사용자 차단, 라이브 방송 시작과 종료, 채널 브랜딩 변경을 할 수 있습니다. 클라이언트 시크릿과 리프레시 토큰은 환경 변수로 다른 위치를 지정하지 않으면 작업 디렉터리의 client_secret.json과 youtube.token.json 두 파일에 저장되며, 토큰 파일은 소유자만 읽을 수 있는 권한으로 기록됩니다. 이 파일을 복사한 사람은 같은 권한을 갖습니다.
코드는 이런 종류의 서버 대부분보다 신중합니다. 소스 코드를 읽어 본 바로는 쓰기·삭제 도구 51개가 확인 단계를 거칩니다. 첫 호출은 삭제할 동영상 ID처럼 작업 내용을 설명하는 MCP elicitation 요청을 돌려주고, 사용자가 수락해야만 실제로 실행됩니다. 이 확인이 어떻게 보이는지는 클라이언트에 따라 다릅니다. 동영상 업로드에는 공개 범위 설정이 필수인데, API 자체는 새 업로드를 기본적으로 공개로 올리기 때문에 중요한 부분입니다. 업로드, 자막, 이미지의 파일 접근은 기본값이 작업 디렉터리인 YUTU_ROOT로 제한되고, .json, .env, .key, .pem 등으로 끝나는 파일은 거부되므로 프롬프트로 서버가 자기 자격 증명을 올리게 만들 수 없습니다.
느린 부분은 설정입니다. Google Cloud 프로젝트를 만들고, YouTube Data API를 활성화하고, 본인을 테스트 사용자로 둔 OAuth 동의 화면을 구성하고, 데스크톱 클라이언트 시크릿을 내려받은 뒤 yutu auth로 브라우저를 엽니다. Google 문서에 따르면 테스트 상태인 외부 앱에 발급된 리프레시 토큰은 7일 뒤 만료되므로, 이런 개인 설정은 앱을 게시하지 않는 한 매주 다시 인증해야 할 가능성이 큽니다. 다른 한계는 할당량입니다. 대부분의 호출에 하루 10,000단위가 주어지며 목록 조회는 1단위, 대부분의 쓰기는 50, 자막 업데이트는 450단위이고, 이와 별도로 업로드 100회 한도가 있습니다.
기본 전송 방식은 stdio입니다. HTTP 모드는 localhost:8216에서 대기하며 도구를 호출할 때마다 Google OAuth 토큰을 검증합니다. 호스팅 서비스로 여러 SNS에 게시하는 Upload-Post와 비교하면, Yutu는 YouTube 하나를 훨씬 깊이 다루고 모든 것을 사용자 컴퓨터에 두는 대신 Google Cloud 자격 증명을 직접 관리해야 합니다. 멤버 목록 조회는 열린 이슈 때문에 여전히 막혀 있습니다.
제 역할을 하는 곳
매주 튜토리얼 2편을 올리는 1인 크리에이터
완성한 동영상을 제목, 태그, 챕터, 썸네일과 함께 일부 공개로 올리고 알맞은 재생목록에 넣기
에이전트가 메타데이터 초안을 쓰고, YUTU_ROOT 안의 파일로 업로드와 썸네일 도구를 호출한 뒤 재생목록 항목을 추가하며, 쓰 기마다 확인을 거칩니다. 업로드 한 번은 하루 업로드 100회 중 1회를 쓰고, 나머지 작업은 수백 단위의 할당량을 씁니다.
구독자 300,000명인 게임 채널의 커뮤니티 매니저
지난주 동영상 댓글에서 스팸을 치우고 자주 묻는 질문에 답하기
댓글 스레드를 조회하고 에이전트가 markAsSpam이나 setModerationStatus로 스팸을 처리하고 답글 초안을 써서 승인을 받게 합니다. 쓰기 한 번에 50단위이므로 하루 할당량으로 약 200건의 관리 작업이 가능합니다.
직원 20명 규모 소프트웨어 회사의 마케팅 팀
오래된 동영상 설명 80개에 남은 낡은 링크와 제품명 고치기
에이전트가 동영상을 조회하고 새 설명을 제안한 뒤 확인을 받아 하나씩 업데이트합니다. 업데이트당 50단위이므로 80건 수정에 하루 10,000단위 중 4,000단위를 씁니다.
도입 전 확인할 점
- 설정
- brew install yutu, winget install yutu 또는 npm i -g @eat-pray-ai/yutu로 설치합니다. Google Cloud 프로젝트를 만들고 YouTube Data API v3를 활성화한 뒤, 본인을 테스트 사용자로 둔 OAuth 데스크톱 클라이언트를 추가하고 yutu auth --credential client_secret.json을 실행 한 다음 yutu mcp setup --agents claude로 등록합니다.
- 연동
- 29개 YouTube 리소스에 걸친 MCP 도구 약 75개, 언어·지역·카테고리용 MCP 리소스, 같은 명령을 쓰는 CLI, youtube-automation 스킬, 업로드용 GitHub Actions, Gemini나 OpenAI 호환 모델로 동작하는 에이전트 모드를 제공합니다.
- 데이터와 개인정보
- 로컬에서 실행되며 요청은 Google API로 바로 갑니다. OAuth 클라이언트 시크릿과 리프레시 토큰은 JSON 파일(토큰 파일 모드 0600)로 저장하거나 환경 변수로 넘깁니다. 파일 읽기는 YUTU_ROOT로 제한되고 자격 증명 형식의 확장자는 차단됩니다. HTTP 모드는 localhost:8216에서 대기하며 호출마다 Google 토큰을 확인합니다.
- 대규모 사용 시 비용
- 소프트웨어는 무료이고, YouTube API는 하루 10,000단위와 업로드 100회, 검색 100회 안에서 무료입니다. 할당량을 늘리려면 Google에 요청해야 하며 그 절차는 README에 없습니다.
- 제한
- 쓰기는 50단위, 자막 업데이트는 450단위가 들어 대량 관리나 일괄 수정은 하루 할당량에 걸립니다. 멤버와 멤버십 등급은 조회할 수 없습니다(이슈 #3). 테스트 모드 리프레시 토큰은 7일 뒤 만료됩니다. 확인 요청은 클라이언트의 elicitation 지원 여부에 달려 있습니다.
좋은 점
- 동영상, 댓글, 재생목록, 자막, 라이브 스트림까지 지원
- 쓰기·삭제 도구 51개가 확인을 요청
- 파일 접근을 폴더 하나로 제한하고 자격 증명 파일은 거부
- Homebrew, WinGet, npm, Docker로 서명된 빌드 제공
아쉬운 점
- 토큰이 채널 전체를 제어
- Google Cloud 프로젝트와 OAuth 설정이 필요
- 테스트 모드 토큰은 7일마다 만료
- YouTube의 하루 10,000단위 할당량에 묶임
추천 대상
Google Cloud에 익숙하고 업로드, 메타데이터, 댓글 관리를 에이전트에게 맡기고 싶은 YouTube 크리에이터와 소규모 채널 팀에 맞습니다.
Yutu 대안
Yutu: 자주 묻는 질문
- Yutu, 쓸 만한 가치가 있습니까?
- 꼼꼼하게 만든 에이전트용 YouTube 도구 모음이며, 그 토큰은 채널 비밀번호만큼 조심해서 다뤄야 합니다. 평점은 5점 만점에 3.9점입니다.
- Yutu의 가격은 얼마입니까?
- 무료 오픈소스(Apache-2.0)입니다. YouTube Data API는 Google 기본 할당량인 하루 10,000단위와 업로드 100회, 검색 100회 안에서 무료입니다.
- Yutu의 단점은 무엇입니까?
- 토큰이 채널 전체를 제어; Google Cloud 프로젝트와 OAuth 설정이 필요; 테스트 모드 토큰은 7일마다 만료; YouTube의 하루 10,000단위 할당량에 묶임.
- Yutu에 적합한 사람은 누구입니까?
- Google Cloud에 익숙하고 업로드, 메타데이터, 댓글 관리를 에이전트에게 맡기고 싶은 YouTube 크리에이터와 소규모 채널 팀에 맞습니다.
- 팀이나 프로덕션 환경에서 Yutu의 비용은 얼마입니까?
- 소프트웨어는 무료이고, YouTube API는 하루 10,000단위와 업로드 100회, 검색 100회 안에서 무료입니다. 할당량을 늘리려면 Google에 요청해야 하며 그 절차는 README에 없습니다.
- Yutu에 회사 데이터를 맡겨도 안전합니까?
- 로컬에서 실행되며 요청은 Google API로 바로 갑니다. OAuth 클라이언트 시크릿과 리프레시 토큰은 JSON 파일(토큰 파일 모드 0600)로 저장하거나 환경 변수로 넘깁니다. 파일 읽기는 YUTU_ROOT로 제한되고 자격 증명 형식의 확장자는 차단됩니다. HTTP 모드는 localhost:8216에서 대기하며 호출마다 Google 토큰을 확인합니다.
- Yutu의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Upload-Post MCP 및 X MCP입니다.
답변 확인일: 2026년 11월 16일.