외부 API를 이용한 유튜브 영상 자막 추출기 - n8n 워크플로우

• 영상 콘텐츠를 재가공해야 하는 콘텐츠 제작자


• 영상 콘텐츠에 대한 감성 분석을 수행하는 데이터 과학자 및 분석가


• AI 요약을 위한 맞춤형 n8n 템플릿을 개발하는 개발자


• 신뢰할 수 있는 OAuth 비연동 방식으로 유튜브 스크립트 추출이 필요한 모든 사용자

이 전문가용 n8n 워크플로우는 공개된 유튜브 영상에서 깔끔하고 구조화된 스크립트를 얻기 위한 간소화된 방법을 제공합니다. 복잡한 유튜브 데이터 API 자격 증명과 OAuth 설정이 필요한 솔루션과 달리, 이 자동화는 전용 외부 스크립트 서비스(youtube-transcript.io)를 활용합니다.

전체 n8n 워크플로우는 재사용 가능한 구성 요소로 설계되었으며, 다른 메인 워크플로우에 의해 트리거되고 입력으로 youtubeVideoId만 필요로 합니다. 핵심 가치는 커스텀 n8n 노드를 사용하여 구현된 강력한 파싱 및 정리 단계에 있으며, 이를 통해 타임스탬프가 제거되고 표준화된 출력을 얻어 고급 자연어 처리(NLP) 또는 AI 요약 작업에 바로 사용할 수 있습니다. 이 안정적인 n8n 노드 시퀀스는 미디어 파이프라인 통합을 위한 가장 효율적인 n8n 템플릿 중 하나로 만듭니다.

이 n8n 워크플로우의 실행은 데이터 수집으로 시작하여 구조화되고 정리된 텍스트 또는 정의된 오류로 끝나는 5단계 프로세스를 따릅니다.

1. 입력 트리거: 프로세스는 다른 워크플로우에 의해 실행 시(When Executed by Another Workflow) n8n 트리거로 시작되며, 이 서브 워크플로우가 호출되었음을 알립니다. 파라미터로 youtubeVideoId가 전달될 것으로 예상합니다.


2. 입력 설정: 변수 설정(Set Variables) n8n 노드는 입력된 영상 ID를 안전하게 저장하여 후속 노드에서 쉽게 참조할 수 있도록 합니다.


3. API 요청: 스크립트 가져오기(Get Transcript (YouTube Transcript API)) n8n 노드는 youtube-transcript.io API로 POST 요청을 보냅니다. 요청 본문에 영상 ID를 포함합니다. 최대의 안정성을 위해 전체 응답을 텍스트로 받도록 구성되어 있습니다.


4. 데이터 파싱 및 검증: API 응답 파싱(Parse API Response) 코드 n8n 노드는 API의 출력을 처리합니다. 파싱을 위한 오류 처리(try/catch)가 포함되어 있으며, API 응답 JSON 구조의 약간의 변형에도 불구하고 스크립트 텍스트를 추출하려고 시도합니다.


5. 흐름 제어: 스크립트 존재 여부 확인?(IF Has Transcript?) n8n 노드는 추출된 텍스트 유무에 따라 흐름을 제어합니다. 텍스트가 존재하면 정리 단계로 진행하고, 그렇지 않으면 오류 처리 단계로 진행합니다.


6. 성공 경로 (정리): 스크립트 정리(Clean Transcript) 코드 n8n 노드는 줄 바꿈 및 과도한 공백을 제거하고 [음악]과 같은 일반적인 스크립트 주석을 필터링하는 등 불필요한 메타데이터를 제거합니다. 그런 다음 계산된 메트릭(wordCount, charCount)과 함께 최종 정리된 텍스트를 반환합니다.


7. 실패 경로 (오류): 스크립트를 찾을 수 없는 경우, 스크립트 없음 폴백(No Transcript Fallback) 코드 n8n 노드는 오류 페이로드를 구조화하고, 중지 및 오류(Stop and Error) n8n 노드는 상위 n8n 워크플로우 실행을 깔끔하게 중단시킵니다.

이 n8n 워크플로우를 사용하려면 다음 단계를 따르세요.

1. 가져오기: 제공된 JSON 코드를 복사하여 n8n 인스턴스의 '새로 만들기(New)' 메뉴 -> 'JSON에서 가져오기(Import from JSON)'를 사용하여 직접 가져옵니다.


2. 자격 증명: 이 특정 n8n 워크플로우는 youtube-transcript.io API의 무료 등급에 의존하며, 간단한 GET/POST 요청에는 일반적으로 API 키가 필요하지 않지만, 스크립트 가져오기(Get Transcript (YouTube Transcript API)) n8n 노드 설정이 구성에 맞는지 확인하세요.


3. 통합: 이 워크플로우는 다른 워크플로우에 의해 실행 시(Execute Workflow) 트리거를 사용하므로, 메인 n8n 워크플로우에서 '워크플로우 실행(Execute Workflow)' n8n 노드를 사용하여 youtubeVideoId를 입력 파라미터로 전달하여 호출해야 합니다.

• 다른 워크플로우에 의해 실행 시 (When Executed by Another Workflow) (n8n 트리거): 진입점 역할을 하며, 필수 입력 파라미터인 youtubeVideoId를 정의합니다.


• 변수 설정 (Set Variables) (n8n 노드): 입력 데이터를 표준화하여 n8n 워크플로우의 나머지 부분에서 youtubeVideoId를 쉽게 참조할 수 있도록 합니다.


• 스크립트 가져오기 (Get Transcript (YouTube Transcript API)) (HTTP 요청 n8n 노드): 외부 스크립트 서비스로 POST 요청을 보냅니다. 주요 구성에는 메서드를 POST로 설정, URL을 API 엔드포인트로 설정, 강력한 파싱을 위해 응답을 '전체 응답(Full Response)' 및 '텍스트(text)'로 처리하도록 구성하는 것이 포함됩니다.


• API 응답 파싱 (Parse API Response) (코드 n8n 노드): 이 중요한 커스텀 n8n 노드는 안전한 JSON 파싱을 처리하고 잠재적으로 다양한 API 응답 구조로부터 출력 필드(텍스트, 언어)를 표준화합니다.


• 스크립트 존재 여부 확인? (IF Has Transcript?) (IF n8n 노드): 이전 n8n 노드에서 추출된 text 필드가 null이 아니고 비어 있지 않은지 확인하는 논리 게이트입니다.


• 스크립트 정리 (Clean Transcript) (코드 n8n 노드): 최종 텍스트 정리(줄 바꿈, 과도한 공백 제거 및 [음악] 주석 필터링)를 수행하고 단어 수(wordCount), 문자 수(charCount)와 같은 유용한 메트릭을 생성하여 n8n 워크플로우의 성공적인 출력을 완성합니다.


• 중지 및 오류 (Stop and Error) (n8n 노드): 스크립트를 찾을 수 없는 경우 상위 n8n 워크플로우에 명확한 실패 표시를 보내어 실행 중 오류가 조용히 발생하는 것을 방지합니다.