건설도면프로젝트 — 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호 상세)

2 요청 ① — YouTube 채널 전사 MCP

2.1 도구 명세 시안

도구파라미터반환비고
youtube_list_channel_videoschannel_url(또는 channelId)·limit(기본 50)·page_token(옵션)videos[]: videoId·제목·게시일·길이·재생목록 정보·next_page_token·total(근사)725편 전수 페이징 지원 필수. 신규 lockupViewModel 레이아웃 대응
youtube_get_video_transcriptvideo_id·lang(기본 en·ko 등)·auto_generated 허용 플래그transcript: 세그먼트 배열(시작초·텍스트) + 전체 plain text·언어·출처(manual/asr/translated)핵심 요구 — pot 토큰 등 유튜브 차단을 MCP 서버 측에서 해결(브라우저 세션·공식 API 자격 중 택일)
youtube_get_video_metavideo_id제목·설명·썸네일·챕터·조회수학습자료 인용 메타
(선택) youtube_list_playlistplaylist_id·limit재생목록 단위 영상 목록주제별 우선순위 처리용

2.2 수용 기준 (검증 방법 — 이 세션에서 즉시 시험)

  1. youtube_list_channel_videos로 OpenSearchProject 채널 725편 전수 페이징 성공 — 마지막 page에서 next_page_token 소멸·합계 725 일치.
  2. youtube_get_video_transcript로 시험 영상(콘솔 로그의 yhUsmXXp5Rw 등 3편)의 영어 전사 획득 — 빈 응답 없음, 세그먼트 수·총 길이가 영상 길이와 정합.
  3. 연속 10편 호출 시 레이트리밋 동작·재시도 안내가 명시적으로 반환됨.
  4. 자막이 없는 영상은 transcript: null + 사유(자막 부재/비공개/차단)를 구분 반환.

2.3 제약·보안 요구

3 요청 ② — AI Ready 「AI인텔리전스」 블로그 게시 MCP

3.1 도구 명세 시안

도구파라미터반환비고
aiready_blog_create_drafttitle·body_markdown·tags[]·series(옵션)draft_id·preview_url초안 생성 — 게시 전 사람 검수 단계 확보
aiready_blog_publishdraft_id·confirm(true 필수)post_url·published_at·statusconfirm 파라미터 없이 게시 금지 — 실수 발사 방지
aiready_blog_statuspost_url 또는 draft_id게시 상태·최종 본문 해시게시 대사 검증용

3.2 수용 기준

  1. create_draft로 markdown 1건 등록 → preview_url에서 본문·코드블록·표가 유지됨(HTML 변환 품질 확인).
  2. publish는 confirm: true 없이는 거부되고, 게시 후 post_url이 실제 접속 가능(200·내용 일치).
  3. 인증은 런타임 크리덴셜(세션 주입)로 동작 — 문서·설정 파일에 평문 토큰이 남지 않음.
  4. 실패 시(할당량·권한) 오류 코드와 재시도 안내가 구조적으로 반환됨.

3.3 제약·보안 요구

4 실행 계획 제안 (도구 수용 후)

단계내용승인
파일럿3편 E2E — 목록→전사→정제→publish→학습자료 발행(19 시트9 연결)·전 과정 실측 기록사용자
단가 보고영상당 시간·호출 수·실패율 실측 보고사용자
전량 배치725편 — 주제별 재생목록 우선순위(프로젝트 관련: 하이브리드·벡터·ML 운영 등)부터 세션 분할 실행사용자(스케줄·할당량 합의 후)

5 첨부 참조