Communitygithub.com

ScreenBeaver/ScreenBeaver

데모 빌더로, 사용자가 앉아 있는 동안 부드러운 커서 이동, 클릭, 실제 타이핑으로 제품을 구동하며 Screen Beaver 영상을 제작합니다.

ScreenBeaver란 무엇인가요?

Screen Beaver는 개발자가 제품 데모 비디오를 자동으로 제작할 수 있는 AI 에이전트 스킬입니다. 이 스킬은 Cursor, Claude Code 등의 AI 코딩 도구와 함께 사용되며, Screen Beaver MCP 서버를 통해 데모 자동화를 제공합니다. 사용자는 수동으로 조작할 필요 없이, 에이전트가 부드러운 커서 이동, 클릭, 실제 키보드 입력을 통해 UI를 직접 구동하고 캡처합니다. 네이티브 창 캡처를 사용하며, Windows 환경에서만 동작합니다. 주요 기능으로는 record_and_build를 통한 원클릭 데모 생성, 자동 줌/캡션 생성, 음성 해설(TTS), 배경 음악 추가 등이 포함됩니다. 에이전트는 좌표 계산을 위해 get_window_layout을 사용하며, 클립보드 붙여넣기 대신 키-by-키 타이핑을 사용하고, 불필요한 대기 시간을 최소화하여 효율적인 데모를 제작합니다. 사용자는 Export 버튼만 클릭하면 완성된 비디오를 내보낼 수 있습니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ScreenBeaver/ScreenBeaver/tree/main/.cursor/skills/screen-weaver-demo

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

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

문서

Screen Beaver 라이브 데모 빌더

사용자는 가만히 앉아 있고, 당신이 그들의 제품을 구동(부드러운 커서 + 클릭 + 실제 타이핑)하여 Screen Beaver 영상을 만듭니다. 네이티브 캡처(Windows 공유 선택기 없음)를 선호하세요. 편집은 자동 모드(하나의 레시피)에서 적용됩니다. 사용자가 직접 Export를 클릭합니다.

엄격한 규칙

  1. screen-beaver MCP만 사용하세요. record_and_build(데모 자동화 포함)를 선호하세요. 사용자 지정 클릭 경로에는 개별 demo_* 도구나 run_demo를 사용하세요.
  2. 이 세션의 MCP 도구 목록에 screen-beaver가 없으면, 중단하세요. 사용자에게 Customize → MCPs에서 활성화하고, npm run mcp:install을 한 번 실행한 다음, Cursor를 다시 로드하거나 새 채팅을 시작하라고 알리세요. 127.0.0.1:17355에 대해 원시 HTTP, curl, fetch, Shell로 대체하지 마세요.
  3. 절대 .ps1, .bat, .cmd 또는 기타 셸 스크립트를 작성하거나 실행하여 Screen Beaver와 통신하지 마세요.
  4. 절대 JSON 데모/레시피 파일을 디스크에 생성하지 마세요. 대신 MCP 도구 인수로 단계/페이로드를 전달하세요.
  5. 사용자가 명시적으로 내보내기를 요청하지 않는 한 export_mp4를 호출하지 마세요.
  6. Screen Beaver 데스크톱을 열어 두세요(npm run desktop:dev 또는 설치된 앱). 브리지: http://127.0.0.1:17355(MCP 서버만 사용). ping_studio가 실패하면 앱을 열라고 알리세요. 멈추지 마세요.
  7. 절대 OS 화면 공유 선택기를 클릭하도록 요청하지 마세요. start_capture / record_and_build(네이티브 창 선택)를 사용하세요.
  8. 절대 빈 페이지만 캡처하고 캡션만 넣지 마세요. 항상 캡처 중에 UI를 구동하세요.
  9. 테이크는 스크립트에 필요한 만큼만 짧게 유지하세요. 마지막 클릭/타이핑이 끝나면 즉시 중단하세요(durationSec 패딩 ≤ ~0.4초). 긴 후행 대기를 추가하지 마세요.
  10. 타이핑에는 demo_type / { op: "type", text }를 사용하세요. 키-by-키로, 클립보드 붙여넣기는 절대 사용하지 마세요.
  11. 채팅에서 간략히 설명하여 사용자가 Screen Beaver 창을 볼 수 있도록 하세요.
  12. 좌표: get_window_layout을 호출하세요(또는 contentNx/contentNy 사용). Cursor의 내장 브라우저 크기를 신뢰하지 마세요. 페이지 상대적인 contentNx/contentNy는 브라우저 크롬을 통해 자동으로 매핑됩니다.
  13. 자동 모드: 스튜디오가 실제 클릭/키 입력에서 줌 및 타이핑 효과음을 자동으로 파생하도록 하세요. 자동 모드와 충돌하는 에이전트 줌/사운드를 수동으로 배치하지 마세요. record_and_build 캡션만 + regenerateAutoZooms.
  14. 음성 해설: 캡션 후 generate_voiceover를 호출하세요(기본 영어). 사용자가 다른 언어를 요청하면 targetLang(예: hi-IN)을 전달하세요. 캡션이 먼저 번역된 다음 Edge TTS가 실행됩니다. 이를 자동으로 처리하는 record_and_build({ voiceover: true, voiceoverLang })를 선호하세요.
  15. 배경 음악: MCP를 통해 Openverse를 사용하세요(pick_background_music / backgroundMusic: true와 함께 record_and_build). Pixabay / .env 키는 사용하지 마세요. Glare / clear 효과는 번들 shimmer SFX(Shining.mp3)를 재생합니다.

워크플로우 A — 완전 자동 (먼저 Screen Beaver UI 열기)

record_and_build는 이제:

  1. focus_studio — Screen Beaver를 전면으로 가져옴
  2. open_record_picker — "새 녹음 시작" / 공유 옵션 UI를 염
  3. productUrl / 앱을 염
  4. start_capture — 창을 네이티브로 선택(애플리케이션), "녹음 중..." 표시
  5. demoSteps 실행
  6. 즉시 중단 + 테이크에서 자동 줌/캡션 생성
  7. generate_voiceover — 기본 영어; voiceoverLang이 설정된 경우 번역+TTS
  8. pick_background_music — Openverse CC 배경음(부드러운 기업 악기)
ping_studio
  → record_and_build({
      productName, productUrl, titleContains: "Edge",
      voiceover: true,
      voiceoverLang: "en-US",   // 또는 "hi-IN" / "es-ES" 등
      backgroundMusic: true,
      musicQuery: "upbeat corporate instrumental",
      demoSteps: [ ... ],
      introCaption: "...",
      features: [{ title: "Sign in", atSeconds: 3 }]
    })
  → 사용자에게 알림: 준비되면 Export 클릭

또는 기존 테이크에서: generate_voiceover({ targetLang: "en-US" }) pick_background_music({ query: "calm tech ambient instrumental" }) generate_voiceover({ speakLang: "en-US", targetLang: "hi-IN" })

데모 단계

op의미
wait{ ms } — 짧게 유지; 긴 끝 패딩 없음
move / click웹페이지에서는 { contentNx, contentNy } 0..1 선호; 외부 창은 { nx, ny }
type{ text, delayMs? } 키-by-키(타이핑 SFX 방출)
scroll / focus / right_click이전과 동일

제한 사항

  • 네이티브 캡처 + 입력 자동화는 Windows 데스크톱 전용입니다.
  • 데모 마우스/키보드 입력은 캡처가 실행 중일 때만 작동합니다.
  • OS 공유 대화상자는 에이전트에게 절대 표시되지 않습니다. Screen Beaver는 인앱 공유 옵션을 표시한 다음 창을 네이티브로 캡처합니다.

관련 스킬