cloud

cloud skill 개요

cloud skill은 무엇에 쓰이나요

cloud skill은 호스팅형 브라우저 자동화 플랫폼이자 API인 Browser Use Cloud를 문서 중심으로 안내해 주는 도우미입니다. 클라우드 서비스로 웹사이트를 자동화해야 하거나, REST API 또는 SDK를 사용해야 하거나, CDP로 외부 브라우저 도구를 연결해야 하거나, 세션·프로필·프록시·실시간 모니터링을 기준으로 워크플로를 설계해야 할 때 특히 잘 맞습니다.

어떤 사람이 이 cloud skill을 설치해야 하나요

실제 하고 싶은 일이 아래에 가깝다면 이 cloud skill 설치가 적합합니다.

• 모든 레퍼런스 파일을 일일이 읽지 않고 Browser Use Cloud를 빠르게 시작하고 싶다
• v2 REST API, v3 agent API, SDK 사용, 직접 브라우저 연결 중 어떤 방식을 써야 할지 판단해야 한다
• Python, TypeScript, cURL, 또는 외부 도구에서 브라우저 작업을 자동화하고 싶다
• Browser Automation 용도로 호스팅 인프라에서 브라우저 자동화를 실행하고 싶다
• 세션, 영속 프로필, residential proxies, CAPTCHA 처리, webhooks를 다뤄야 한다

반대로, 오픈소스 로컬 browser-use Python 라이브러리 설정이 필요한 경우라면 이 skill은 맞지 않습니다. 이 skill은 클라우드 사용과 오픈소스 agent 패키지를 명확히 구분합니다.

일반적인 프롬프트와 다른 점

일반 프롬프트도 브라우저 자동화를 큰 그림에서 설명할 수는 있습니다. 하지만 cloud skill은 Browser Use Cloud의 정확한 경로가 필요할 때 훨씬 유용합니다. 예를 들어 어떤 API 버전을 봐야 하는지, 인증은 어떻게 처리하는지, liveUrl은 어디서 오는지, 클라우드 세션이 일회성 실행과 어떻게 다른지, CDP 접근은 어떻게 시작하는지, 현재 스택에는 어떤 통합 패턴이 맞는지까지 짚어줍니다.

이 skill의 가장 큰 가치는 숨겨진 도구가 아니라 탐색과 적합성 가이드입니다. 필요한 레퍼런스 파일로 빠르게 안내해 줍니다.

• 첫 설정과 가격 확인: references/quickstart.md
• 안정적인 REST 엔드포인트: references/api-v2.md
• 더 새로운 세션 기반 agent API: references/api-v3.md
• Playwright, Puppeteer, Selenium, raw CDP: references/browser-api.md
• 세션 및 프로필 설계: references/sessions.md
• proxies, webhooks, workspaces, skills, MCP, live view: references/features.md
• 병렬 실행, streaming, geo-scraping, structured output: references/patterns.md

Browser Automation을 위한 cloud에 특히 잘 맞는 사용 사례

로컬 브라우저 제어보다 Browser Automation을 위한 cloud가 필요한 경우, 이 cloud skill의 가치가 더 커집니다. 대표적인 적합 사례는 다음과 같습니다.

• stealth와 proxies의 이점을 살릴 수 있는 scraping 또는 extraction
• 영속 브라우저 프로필이 필요한 인증 기반 워크플로
• liveUrl로 관찰할 수 있는 원격 브라우저 세션
• Playwright, Puppeteer, Selenium에서 hosted CDP로 직접 자동화
• agent 시스템, chat UI, no-code 도구, webhook 기반 백엔드와의 연동

설치 전에 먼저 확인할 도입 장애 요소

대부분의 설치 판단은 몇 가지 실무 질문으로 정리됩니다.

• 호스팅형 cloud 자동화가 필요한가, 아니면 로컬 오픈소스 제어가 필요한가?
• 안정적인 v2 REST 엔드포인트가 필요한가, 아니면 더 새로운 v3 session/message 모델이 필요한가?
• 단순한 run() 작업이면 되는가, 아니면 세션/프로필을 명시적으로 관리해야 하는가?
• SDK, cURL, 외부 브라우저 프레임워크(CDP)를 쓰는가?
• 지역 라우팅, 인증 상태 유지, webhook callback이 필요한가?

이 질문들이 아직 정리되지 않았다면, 이 skill이 특히 도움이 됩니다. 저장소가 하나의 선형 튜토리얼이 아니라 의사결정 경로 중심으로 구성되어 있기 때문입니다.

cloud skill 사용 방법

cloud skill 설치하기

표준 skills installer를 사용해 저장소에서 cloud skill을 대상으로 설치하세요.

npx skills add https://github.com/browser-use/browser-use --skill cloud

설치 후에는 요청이 로컬 오픈소스 패키지가 아니라 Browser Use Cloud와 직접 관련될 때 이 skill을 호출하면 됩니다.

목적에 맞는 파일부터 읽기

파일 순서대로 읽기보다, 결정해야 할 사항에 따라 읽는 편이 좋습니다.

• 플랫폼이 처음이라면: references/quickstart.md
• 안정적인 API 범위와 cURL 예제가 필요하다면: references/api-v2.md
• 더 새로운 agent/session 모델이 필요하다면: references/api-v3.md
• 기존 브라우저 프레임워크에서 hosted browser에 접속해야 한다면: references/browser-api.md
• 영속 상태, 인증, 프로필 전략이 필요하다면: references/sessions.md
• proxies나 webhooks 같은 고급 기능이 필요하다면: references/features.md
• 구현 패턴이 필요하다면: references/patterns.md

이 순서가 중요한 이유는, 이 skill이 제품의 복잡성을 감추는 것이 아니라 가장 짧고 실용적인 읽기 경로를 고르게 도와주기 때문입니다.

cloud의 네 가지 주요 사용 경로를 먼저 이해하기

프롬프트를 쓰기 전에 아래 네 가지 중 무엇을 원하는지 먼저 정하세요.

1. SDK를 통한 run() 작업 실행
2. v2 REST API의 task/session/browser 엔드포인트 사용
3. sessions, messages, workspaces를 포함한 v3 agent API 사용
4. Playwright, Puppeteer, Selenium을 위한 직접 CDP 브라우저 연결

약한 프롬프트가 자주 실패하는 이유는 “Browser Use Cloud 사용법”만 묻고, 어떤 경로를 의도하는지 밝히지 않기 때문입니다.

인증 설정을 정확히 하기

Browser Use Cloud는 X-Browser-Use-API-Key 헤더를 사용하고, SDK는 일반적으로 환경 변수에서 BROWSER_USE_API_KEY를 읽습니다.

export BROWSER_USE_API_KEY=your-key

레퍼런스에서 바로 확인할 수 있는 유용한 정보는 다음과 같습니다.

• v2 API base: https://api.browser-use.com/api/v2
• v3 API base: https://api.browser-use.com/api/v3
• API key 생성: https://cloud.browser-use.com/new-api-key

프롬프트에서 인증을 어떤 방식으로 처리할지 언급하지 않으면, 답변이 지나치게 추상적으로 남기 쉽습니다.

예제를 요청하기 전에 SDK, REST, CDP 중 무엇인지 정하기

가장 단순한 개발 경험을 원한다면 SDK 예제를 보세요.
엔드포인트 수준의 제어가 필요하다면 REST가 맞습니다.
이미 브라우저 자동화 코드가 있고 hosted browser 대상만 필요하다면 CDP가 가장 자연스럽습니다.

이 구분에 따라 답변 내용이 크게 달라집니다.

• SDK 답변은 run(), sessions, profiles, structured output 중심
• REST 답변은 endpoints, polling, schemas, headers 중심
• CDP 답변은 WebSocket URL과 브라우저 도구 통합 중심

막연한 목표를 강한 cloud 사용 프롬프트로 바꾸기

약한 프롬프트:

Help me use Browser Use Cloud.

더 좋은 프롬프트:

I want cloud usage guidance for Python. I need a hosted browser workflow that logs into a site, persists cookies across runs, uses a US proxy, and lets me monitor progress live. Show whether I should use run() with auto-created sessions or manual sessions with a profile, and point me to the exact repo files to read first.

왜 이 프롬프트가 더 좋은가:

• 사용 언어를 밝힌다
• 워크플로 유형을 밝힌다
• 세션 지속성 요구를 포함한다
• 프록시 요구사항을 포함한다
• 실시간 모니터링을 요청한다
• 코드만이 아니라 읽어야 할 파일 경로까지 요청한다

출력 품질을 높이는 입력 정보

cloud skill에서 더 좋은 답을 얻으려면 다음 정보를 포함하세요.

• 언어: Python, TypeScript, cURL
• API 모드: v2, v3, 또는 아직 미정
• 실행 방식: one-shot task, multi-step session, 또는 직접 브라우저 제어
• 상태 요구: stateless인지, persistent profile이 필요한지
• 인프라 요구: proxy country, custom proxy, timeout, screen size
• 모니터링 요구: liveUrl, streaming, webhooks
• 출력 형태: 자유 텍스트인지, structured schema인지
• 연동 대상: Playwright, Puppeteer, Selenium, chat UI, subagent, no-code tool

이 정보가 없으면 답변 자체는 대체로 정확하더라도, 실제 구현까지 빠르게 이어가기에는 너무 넓고 추상적일 가능성이 큽니다.

세션과 프로필 설계에 cloud skill 활용하기

cloud skill의 실무적 가치는 잘못된 세션 설계를 피하게 도와준다는 점에도 있습니다.

레퍼런스 기준으로 보면:

• run()은 보통 세션을 자동 생성한다
• 수동 세션은 여러 단계의 워크플로에 더 적합하다
• profiles는 세션 간에 cookies와 local storage를 유지한다
• 같은 profile을 쓰는 동시 세션은 snapshot에서 시작하며, 서로의 상태 변화를 보지 못한다

마지막 항목은 대충 훑어보면 놓치기 쉽지만, 인증이 필요한 병렬 작업에서는 매우 중요합니다.

Browser Automation 프레임워크용 cloud skill 활용하기

이미 Playwright, Puppeteer, Selenium을 쓰고 있다면, agent task보다 직접적인 cloud browser 접근이 더 나은 경로일 수 있습니다.

저장소에는 다음과 같은 CDP 진입점이 나옵니다.

wss://connect.browser-use.com?apiKey=YOUR_KEY&proxyCountryCode=us&timeout=30

이 점이 중요한 이유는, 브라우저가 연결 시 자동 시작되고 연결 해제 시 자동 종료될 수 있기 때문입니다. 이는 task를 수동으로 생성·정리하는 운영 방식과는 다릅니다.

고급 cloud 기능을 판단할 때 cloud skill 활용하기

이 skill은 문법보다 플랫폼 기능이 도입 판단의 핵심일 때도 유용합니다.

• stealth 기본값
• 여러 국가를 지원하는 residential proxies
• custom proxies
• CAPTCHA 처리
• signature verification이 있는 webhooks
• live viewing 및 share links
• workspaces
• skills 및 marketplace 지원
• MCP 관련 플랫폼 레퍼런스

이런 요소들이 실제로 Browser Use Cloud가 프로덕션 요구사항에 맞는지 결정합니다.

설치 후 추천하는 첫 워크플로

처음 사용하는 사람에게는 아래 순서를 권합니다.

1. references/quickstart.md를 읽는다
2. SDK 또는 cURL로 아주 단순한 첫 task를 실행한다
3. 실제 워크플로에 manual sessions가 필요한지 판단한다
4. 영속 로그인이나 상태가 필요할 때만 profiles를 추가한다
5. 필요한 경우에만 proxy와 geography 설정을 추가한다
6. 기본 경로가 동작한 뒤 structured output이나 webhooks를 붙인다
7. 동시성이나 streaming이 필요해지면 references/patterns.md로 넘어간다

이 순서는 처음 성공하는 실행 전에 과도하게 설계하는 일을 줄이고, 혼란도 줄여줍니다.

cloud skill FAQ

이 cloud skill은 문서 안내용인가요, 아니면 동작도 바꾸나요?

주된 역할은 레퍼런스 경로를 잡아주는 것입니다. agent나 사용자가 올바른 Browser Use Cloud 문서 경로를 선택하고, 잘못된 가정 없이 답하도록 돕는 데 가치가 있습니다. 플랫폼 SDK나 API 자체를 대체하지는 않습니다.

cloud skill은 초보자에게도 괜찮나요?

네, Browser Use Cloud 자체가 처음인 초보자라면 유용합니다. 가장 좋은 시작점은 references/quickstart.md입니다. 다만 단순 task 실행이 필요한지, session 관리가 필요한지, 프레임워크 수준의 browser control이 필요한지는 스스로 구분하고 들어가는 편이 좋습니다.

언제 이 cloud skill을 쓰지 말아야 하나요?

오픈소스 browser-use 로컬 라이브러리 내부 구조, agent config, 비클라우드 패키지 설정 관련 질문에는 이 cloud skill을 쓰지 마세요. 이 skill은 그런 경우 오픈소스 전용 skill을 사용하라고 명확히 안내합니다.

v2와 v3 중 무엇을 써야 하나요?

안정적인 REST API와 넓은 엔드포인트 커버리지가 필요하다면 v2를 쓰세요.
sessions, messages, files, workspaces를 포함한 더 새로운 BU Agent API 모델이 필요하고, 레퍼런스에서 experimental로 표시된 점을 감수할 수 있다면 v3가 맞습니다.

일반적인 브라우저 프레임워크에도 이 cloud skill이 도움이 되나요?

그렇습니다. 저장소에는 hosted browser에 대한 Playwright, Puppeteer, Selenium, 직접 CDP 연결을 다루는 references/browser-api.md가 별도로 있습니다.

Browser Automation용 cloud는 일반 프롬프트보다 낫나요?

Browser Use Cloud 작업이라면 보통은 그렇습니다. 일반 프롬프트는 auth header, endpoint 버전, liveUrl, profile 동작 방식, webhook signature, 자동 시작 CDP 연결 모델 같은 플랫폼 고유 사실을 놓치기 쉽습니다.

이 cloud skill은 가격이나 운영 제약도 다루나요?

네. quickstart 레퍼런스에는 가격과 FAQ 성격의 내용이 포함되어 있고, 다른 레퍼런스에서는 timeout, session handling, concurrency 관련 주의점, 기능별 제약 사항까지 다룹니다.

cloud skill을 더 잘 활용하는 방법

설명만 말고, 판단을 요청하세요

cloud skill의 답변 품질을 가장 빠르게 높이는 방법은 옵션 중 하나를 고르게 만드는 것입니다.

• “Should I use v2, v3, or CDP?”
• “Should this be auto-session or manual session?”
• “Should I use a profile or keep it stateless?”

이렇게 물으면 넓은 요약 대신 실제 구현 판단에 가까운 가이드를 받을 수 있습니다.

작업과 환경을 구체적으로 알려주세요

더 좋은 예시:

I need cloud install and usage help for a TypeScript backend. The workflow logs into a dashboard weekly, downloads a file, and posts completion to my server. I need persistent auth, webhook notifications, and a recommendation between SDK and REST.

이 프롬프트가 좋은 이유는 언어, 실행 주기, 상태 요구사항, 완료 신호 방식을 모두 드러내기 때문입니다.

실행 간 무엇이 유지되어야 하는지 분명히 말하세요

흔한 실패 패턴 중 하나는 상태 요구를 너무 모호하게 주는 것입니다. 로그인, cookies, local storage, 저장된 credentials가 중요하다면 그 점을 분명히 적고, references/sessions.md를 기준으로 profile 기반 가이드를 요청하세요.

반대로 상태가 중요하지 않다면 그 점도 분명히 적으세요. 그러면 이 skill이 더 단순한 one-shot 실행을 추천할 수 있습니다.

관찰이 필요한지, callback이 필요한지 명시하세요

많은 사용자가 실제로는 아래 중 하나를 원하면서도 질문에서 빠뜨립니다.

• liveUrl로 실행을 실시간 관찰하기
• 단계별 업데이트를 stream으로 받기
• 작업 완료 시 webhook callback 받기

이 요구에 따라 구현 패턴도, 먼저 읽어야 할 파일도 달라집니다.

먼저 최소 실행 경로부터 요청하세요

좋은 개선 패턴은 아래와 같습니다.

1. 가장 작은 working example을 요청한다
2. 직접 실행한다
3. 그 다음 profiles, proxies, webhooks를 어떻게 붙일지 묻는다

이 skill은 한 번에 전체 프로덕션 아키텍처를 설계할 때보다, 도입 순서를 잡아줄 때 가장 강합니다.

API 버전 혼동을 경계하세요

약한 답변을 받는 가장 쉬운 방법 중 하나는 v2와 v3 개념을 한 요청 안에서 섞는 것입니다. 비교가 필요하면 비교를 요청하세요. 구현이 필요하면 한 버전을 지정하세요.

좋은 프롬프트:

Compare Browser Use Cloud v2 vs v3 for a multi-step agent workflow, then recommend one and give only that version's starter example.

파일 단위 읽기 경로를 물어보세요

저장소에는 레퍼런스가 충분히 많아서, 읽기 경로를 정확히 잡는 것만으로도 시간을 크게 아낄 수 있습니다. 예를 들면 이렇게 물어보세요.

• “Which file should I read first for webhook verification?”
• “Which reference covers CDP and Playwright setup?”
• “Which document explains concurrent sessions with the same profile?”

이렇게 하면 cloud 가이드가 일반 요약보다 훨씬 실행 가능한 답으로 바뀝니다.

성공 기준을 명시하면 출력 품질이 좋아집니다

이렇게 묻기보다:

Show me cloud usage.

이렇게 묻는 편이 좋습니다:

Show me a cloud usage path that gets from API key to first successful task in under 10 minutes, then list the next file to read if I need structured output.

성공 기준이 있으면 답변이 실제 도입 경로 중심으로 정리됩니다.

첫 답변 뒤에는 처음부터 다시 묻지 말고, 빠진 부분을 지정해 보완하세요

첫 답변을 받은 뒤에는, 아직 빠진 항목을 짚어 보완하는 방식이 더 좋습니다.

• missing auth handling
• missing polling example
• missing session cleanup
• missing proxy config
• missing structured output schema
• missing webhook verification
• missing Playwright connection details

이 방식이 처음부터 다시 물어보는 것보다 두 번째 답변의 밀도를 더 높여줍니다.

고품질 cloud 가이드를 받는 가장 좋은 방법

cloud skill은 아래 정보가 프롬프트에 들어갈 때 가장 잘 작동합니다.

• 사용하는 스택
• 브라우저 자동화 목표
• 상태가 유지되어야 하는지 여부
• hosted browser control과 agent execution 중 어느 쪽을 선호하는지
• monitoring, streaming, webhooks가 필요한지 여부
• geo-routing이나 stealth 제약을 신경 쓰는지 여부

이 조합이면 skill이 적절한 Browser Use Cloud 자료로 정확히 연결해 주고, 바로 구현 가능한 수준의 가이드를 내놓기 쉬워집니다.