AI 에이전트를 위한 YouTube 스크립트
MCP 서버, REST API, 그리고 에이전트가 완전히 스스로 완료할 수 있는 가입 절차. 사람이 계정을 만들거나 키를 붙여넣을 필요가 없습니다.
사람 개입 없는 셀프서비스 가입
대부분의 스크립트 API는 에이전트가 첫 호출을 하기 전에 사람이 등록하고, 대시보드를 열고, 키를 복사해야 합니다. 이 서비스는 그렇지 않습니다. 요청 두 번이면 에이전트는 무료 크레딧 100개가 담긴 작동 가능한 키를 갖게 됩니다.
1단계 — 코드 요청 (API 키 불필요):
curl -X POST https://getyoutubetranscript.com/api/v1/signup \
-H "Content-Type: application/json" \
-d '{"email": "[email protected]"}'2단계 — 코드를 키로 교환:
curl -X POST https://getyoutubetranscript.com/api/v1/signup/verify \
-H "Content-Type: application/json" \
-d '{"email": "[email protected]", "otp": "123456"}'
# => { "success": true, "api_key": "sk_live_..." }MCP로 연결하기
Streamable HTTP 방식이라 로컬에서 아무것도 실행할 필요가 없습니다. Claude Desktop, Claude Code, Cursor, Windsurf 등 모든 MCP 호환 클라이언트와 작동합니다. 다른 방식으로 인증하는 클라이언트를 위해 동적 클라이언트 등록을 지원하는 OAuth 2.1도 지원합니다.
{
"mcpServers": {
"getyoutubetranscript": {
"url": "https://getyoutubetranscript.com/api/mcp",
"headers": {
"Authorization": "Bearer sk_live_..."
}
}
}
}| 도구 | 기능 | 비용 |
|---|---|---|
get_youtube_transcript | 전체 스크립트와 제목, 작성자, 썸네일 | 1크레딧 |
search_youtube | 동영상 또는 채널 검색, 페이지네이션 지원 | 1크레딧 |
get_channel_latest_videos | 채널의 메타데이터와 최근 업로드 | 무료 |
search_channel_videos | 특정 채널 내에서 검색 | 1크레딧 |
list_channel_videos | 채널이 업로드한 모든 동영상 | 1크레딧 |
list_playlist_videos | 재생목록의 모든 동영상 | 1크레딧 |
또는 REST API를 직접 호출하기
curl "https://getyoutubetranscript.com/api/v1/transcript?v=dQw4w9WgXcQ" \
-H "Authorization: Bearer sk_live_..."전체 엔드포인트 레퍼런스, 매개변수, 응답 형태는 API 문서에 있습니다. 다운로드 가능한 에이전트 스킬과 단계별 MCP 설정 가이드도 제공됩니다.
관리할 YouTube 할당량 없음
공식 YouTube Data API는 프로젝트마다 하루 10,000단위를 제공하며, captions.download 하나만으로도 호출당 200단위에 OAuth까지 필요합니다. 이 API는 사용자의 키로 해당 엔드포인트를 프록시하지 않으므로 예산으로 관리해야 할 일일 상한이 없습니다 — 요금제별 요청 속도만 지키면 됩니다. 전체 내용은 할당량 가이드를 참고하세요.
대시보드에서 시작하고 싶으신가요? 수동으로 키 생성하기 — 무료 크레딧 100개, 카드 등록 불필요.
에이전트 연동 FAQ
에이전트가 사람 없이 정말로 스스로 가입할 수 있나요?
네. /api/v1/signup으로 이메일을 POST하면 6자리 코드가 발급되고, 이메일과 코드를 /api/v1/signup/verify로 POST하면 응답에 실제 사용 가능한 API 키가 포함됩니다. 대시보드 방문도, 카드도, 사람의 개입도 필요 없습니다. 이 키에는 무료 크레딧 100개가 포함되어 있습니다.
MCP 서버가 필요한가요, 아니면 REST만 사용해도 되나요?
둘 다 가능합니다. 모델이 대화 도중 스크립트를 가져올지 스스로 판단해야 하는 경우에는 MCP가 더 적합합니다. 도구가 자체적으로 설명 가능한 형태라 클라이언트가 자동으로 발견하기 때문입니다. 자체 코드가 호출 시점을 결정하는 파이프라인 안에서는 일반 REST가 더 적합합니다.
이걸로 에이전트를 운영하는 데 비용이 얼마나 드나요?
시작 시 무료 크레딧 100개, 이후 월 $5에 1,000크레딧(또는 연간 결제 시 월 $4.50)입니다. 1크레딧은 성공한 요청 1건입니다. 실패하거나 속도 제한에 걸린 요청은 절대 과금되지 않으므로, 재시도 루프가 잔액을 몰래 소진시킬 수 없습니다.
속도 제한은 어떻게 되나요?
무료 등급은 분당 60회, 월간 요금제는 분당 200회, 연간 요금제는 분당 300회이며, API 키별로 고정된 1분 창으로 적용됩니다. 429는 크레딧 소진이 아니라 속도를 늦추라는 신호입니다 - 올바른 백오프 방법은 속도 제한 가이드를 참고하세요.
이게 제 YouTube Data API 할당량을 소모하나요?
아니요. 사용자의 키로 captions.download를 프록시하지 않으므로 관리해야 할 하루 10,000단위 상한이 없습니다. 오직 요금제별 요청 속도에만 제한됩니다.