Communitygithub.com

tmarkTai/web2clip-setup

웹-투-비디오(web2clip) 프로젝트를 시작할 때나 클립 단계에서 도구, 커넥터, 네트워크 도메인, 계정 또는 크레딧 부족으로 실패할 때 사용합니다 — "kiểm tra máy", "cần cài gì để làm clip", "không tải được giọng", "/web2clip-setup".

web2clip-setup란 무엇인가요?

이 스킬은 web2clip(웹-투-비디오) 파이프라인의 1~2단계 설정 및 사전 점검을 자동화합니다. 사용자의 환경에 필수 도구(ffmpeg, ffprobe, Playwright/Chromium)가 설치되어 있는지 확인하고, ElevenLabs(베트남어 TTS), Google Drive, Canva, Netlify 등 주요 커넥터의 연결 상태와 네트워크 접근 권한을 검사합니다. 특히 ElevenLabs의 도메인(api.elevenlabs.io, files.elevenlabsusercontent.com 등)이 허용 목록에 있는지 확인하여 음성 파일 다운로드 실패를 방지합니다. 또한 계정 크레딧 상태를 점검하고, 상업적 사용을 위한 적절한 요금제(Starter)를 권장하며, 권한 승인 대화상자 처리 및 대용량 파일 전송 방법을 안내합니다. Claude Code, Cursor, Windsurf, Cline 등 다양한 AI 코딩 에이전트에서 실행 가능하며, 오류 메시지가 발생하면 정확한 진단과 해결 단계를 제공합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tmarkTai/web2clip/tree/HEAD/skills/web2clip-setup

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

web2clip-setup · 1~2단계: 점검 및 준비

1. 빌드 머신의 도구 확인

cd <skill web2clip>/scripts && python -m w2c.check_env

필요: ffmpeg, ffprobe, playwright (Chromium). 없으면: pip install playwright && playwright install chromium.

2. 연결 확인 (커넥터 / MCP)

연결용도필수 여부
ElevenLabs베트남어 AI 음성예
Google Drive텍스트 문서 저장(대본, 프로필)권장
Canva썸네일 이미지선택
Netlify / 호스팅웹페이지를 실제 링크로 게시하여 촬영웹에 링크가 없을 때
ElevenLabs가 없으면 사용자에게 커넥터 목록에서 연결하도록 요청합니다. 다른 업체로 대체하지 마세요.

3. 빌드 머신의 네트워크 권한 (가장 자주 막히는 부분)

check_env에서 차단이 보고되면 사용자에게 안내: 설정 → 기능(Capabilities) → 코드 실행 및 파일 생성 → 도메인 목록에 다음 5개 도메인을 추가: elevenlabs.io, api.elevenlabs.io, api.us.elevenlabs.io, elevenlabsusercontent.com, storage.googleapis.com (음성 파일은 elevenlabsusercontent.com에 있음 — 자주 잊힘).

4. 계정 및 크레딧

  • ElevenLabs는 글자 수 기준 크레딧을 부과합니다(긴 파일을 합쳐도 절약되지 않음). 추정: v4 모델 기준 약 1크레딧/글자; 12분 클립 ≈ 6001,500크레딧.
  • 무료 요금제(약 월 10,000크레딧)에는 상업적 사용 권한이 없습니다. 비즈니스용 클립 → Starter 요금제 권장(첫 달 할인 혜택 자주 제공).
  • 여러 무료 계정을 만들지 말 것(약관 위반, 차단 위험).
  • 결제: 사용자가 직접 처리하며, 카드를 대신 입력하지 않음. 링크 전송: https://elevenlabs.io/app/subscription.

5. 도구 권한 요청 대화상자

ElevenLabs 명령이나 게시물 업로드 시 권한 요청 대화상자가 나타날 수 있습니다. 사용자에게 **"항상 허용"**을 선택하도록 안내합니다. 명령이 "승인을 받지 못했습니다"라고 보고하면 명확히 설명하고 다시 전송합니다.

6. 대용량 파일 저장

Drive 커넥터는 큰 비디오를 처리할 수 없습니다. 채팅에서 파일을 전달하고 디렉토리로 드래그 앤 드롭하거나 mv ~/Downloads/<접두사>*.mp4 "<드라이브 로컬 경로>" 명령을 사용하도록 안내합니다. 직접 저장하려면 컴퓨터에서 Claude Cowork를 사용하세요.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬