건설도면프로젝트 — MCP팀 요청서 (유튜브 전사 MCP · AI Ready 블로그 게시 MCP)
| 항목 | 내용 |
|---|---|
| 작성일 | 2026년 11월 17일 |
| 발신 | 건설도면프로젝트(문서 작성 세션) |
| 수신 | MCP팀(도구 개발·제공 담당) |
| 제안 유형 | 신규 MCP 도구 2종 — ①YouTube 채널 전사 ②AI Ready 「AI인텔리전스」 블로그 게시 |
| 첨부·근거 | 23 파이프라인 체크리스트 — 모든 판정에 실측 근거 포함 |
| 수용 결과 | 2026-11-17 stable-261117 승격으로 2종 전부 제공 완료 — 수신 가이드 25·수용 판정 26. 본 문서는 요청 원문 보존 |
| 요약 | 유튜브 채널(OpenSearchProject·총 725편) 전사→AI Ready 블로그 게시→학습자료 발행 파이프라인 중, 목록 수집은 부분 가능하나 자막 다운로드(실측 차단)와 게시 도구(부재) 때문에 전 단계가 막혀 있다. 아래 사양 시안대로 2종을 제공받으면 파일럿 3편 E2E → 전량 배치 순으로 진행한다 |
1 배경 (실측 — 23호 상세)
- 요구: 채널 전 영상의 전사 원문 확보 → AI Ready 「AI인텔리전스」에 게시(publish) → 게시 내용을 학습자료 HTML(A2 모션·문서 뷰어)로 발행.
- 실측 결과(2026-11-17):
- 채널 /videos 페이지는 단순 HTTP로 획득 가능 — 총 725편·초기 30편 contentId·continuation token 확인. 2025 신규 레이아웃(lockupViewModel)이라 제목 파싱은 추가 작업 필요.
- watch 페이지에는 captionTracks(서명 timedtext URL·자동생성 asr·8개 이상 언어 트랙·isTranslatable)가 존재하나, 해당 URL의 GET은 HTTP 200에 0바이트를 돌려준다(원본·json3·srv3 3포맷×풀헤더 실측 동일) — 유튜브의 증명 토큰(pot) 요구로 판단. 즉 단순 fetch로는 전사 불가.
- 세션에는 AI Ready 블로그 게시 도구가 없다(도구 전수 검색 완료 — aiready 계열은 엔진 통합 ZIP 패키징 스킬뿐).
- 결론: 단계 ②(전사)와 ④(게시)가 막힘 — 이 2점만 도구화되면 나머지(정제·학습자료 발행)는 기존 검증된 체계로 즉시 수행 가능.
2 요청 ① — YouTube 채널 전사 MCP
2.1 도구 명세 시안
| 도구 | 파라미터 | 반환 | 비고 |
|---|---|---|---|
youtube_list_channel_videos | channel_url(또는 channelId)·limit(기본 50)·page_token(옵션) | videos[]: videoId·제목·게시일·길이·재생목록 정보·next_page_token·total(근사) | 725편 전수 페이징 지원 필수. 신규 lockupViewModel 레이아웃 대응 |
youtube_get_video_transcript | video_id·lang(기본 en·ko 등)·auto_generated 허용 플래그 | transcript: 세그먼트 배열(시작초·텍스트) + 전체 plain text·언어·출처(manual/asr/translated) | 핵심 요구 — pot 토큰 등 유튜브 차단을 MCP 서버 측에서 해결(브라우저 세션·공식 API 자격 중 택일) |
youtube_get_video_meta | video_id | 제목·설명·썸네일·챕터·조회수 | 학습자료 인용 메타 |
(선택) youtube_list_playlist | playlist_id·limit | 재생목록 단위 영상 목록 | 주제별 우선순위 처리용 |
2.2 수용 기준 (검증 방법 — 이 세션에서 즉시 시험)
youtube_list_channel_videos로 OpenSearchProject 채널 725편 전수 페이징 성공 — 마지막 page에서 next_page_token 소멸·합계 725 일치.youtube_get_video_transcript로 시험 영상(콘솔 로그의 yhUsmXXp5Rw 등 3편)의 영어 전사 획득 — 빈 응답 없음, 세그먼트 수·총 길이가 영상 길이와 정합.- 연속 10편 호출 시 레이트리밋 동작·재시도 안내가 명시적으로 반환됨.
- 자막이 없는 영상은
transcript: null+ 사유(자막 부재/비공개/차단)를 구분 반환.
2.3 제약·보안 요구
- 유튜브 이용약관·저작권 준수 — 전사물은 내부 학습자료 용도로 한정(외부 재게시 시 채널·라이선스 표기 정책을 응답에 포함).
- 자격증명은 런타임 주입(평문 저장 금지 — 프로젝트 보안 관행 준수).
- 다운로드 전사물은 신뢰 불가 데이터 — MCP 응답에 출처·취득 시각을 명시해 격리·검증이 가능하도록.
3 요청 ② — AI Ready 「AI인텔리전스」 블로그 게시 MCP
3.1 도구 명세 시안
| 도구 | 파라미터 | 반환 | 비고 |
|---|---|---|---|
aiready_blog_create_draft | title·body_markdown·tags[]·series(옵션) | draft_id·preview_url | 초안 생성 — 게시 전 사람 검수 단계 확보 |
aiready_blog_publish | draft_id·confirm(true 필수) | post_url·published_at·status | confirm 파라미터 없이 게시 금지 — 실수 발사 방지 |
aiready_blog_status | post_url 또는 draft_id | 게시 상태·최종 본문 해시 | 게시 대사 검증용 |
3.2 수용 기준
create_draft로 markdown 1건 등록 →preview_url에서 본문·코드블록·표가 유지됨(HTML 변환 품질 확인).publish는confirm: true없이는 거부되고, 게시 후post_url이 실제 접속 가능(200·내용 일치).- 인증은 런타임 크리덴셜(세션 주입)로 동작 — 문서·설정 파일에 평문 토큰이 남지 않음.
- 실패 시(할당량·권한) 오류 코드와 재시도 안내가 구조적으로 반환됨.
3.3 제약·보안 요구
- 게시물 저작·원칙: 게시 내용에는 원 출처(유튜브 채널·영상 링크)를 본문에 명시(2.3 준수와 연동).
- 계정·할당량 정보는 사용자와 사전 합의 — MCP가 임의로 게시 한도를 늘리지 않음.
4 실행 계획 제안 (도구 수용 후)
| 단계 | 내용 | 승인 |
|---|---|---|
| 파일럿 | 3편 E2E — 목록→전사→정제→publish→학습자료 발행(19 시트9 연결)·전 과정 실측 기록 | 사용자 |
| 단가 보고 | 영상당 시간·호출 수·실패율 실측 보고 | 사용자 |
| 전량 배치 | 725편 — 주제별 재생목록 우선순위(프로젝트 관련: 하이브리드·벡터·ML 운영 등)부터 세션 분할 실행 | 사용자(스케줄·할당량 합의 후) |
- 대체안(도구 없이 진행할 경우): ①사용자가 AI Ready 플랫폼에서 수동 게시(원문 md 전달) ②브라우저 자동화로 소표본 전사(영상당 수분 — 전량 부적합) ③yt-dlp+PoToken(외부 도구 설치·정책 검토 선행) — 이 중 어떤 경로도 전 영상 전사의 정식 해법은 아니며, 본 요청서가 유일한 정식 경로다.
5 첨부 참조
- 판정 근거 전문: 23 유튜브 전사 파이프라인 체크리스트
- 발행 체계·검증 실적: 19 시트9 발행 목차 · 21·22호 학습자료 · linkaudit.py(링크 검증기)