Browser Use

• 웹 스크래핑 및 데이터 추출: 데이터가 표시되기 전에 상호작용(로그인, 페이지네이션, 동적 렌더링)이 필요한 페이지에서 구조화된 정보를 가져와야 합니다.
• 자동화된 양식 작성 및 제출: 이전 페이지 상태에 따라 달라지는 다단계 마법사를 포함하여 웹 양식을 작성하고 제출해야 합니다.
• 엔드투엔드 웹 테스트: 실제 브라우저 환경에서 웹 앱의 UI를 실행하고, 스크린샷을 캡처하며 요소 상태를 검증하고자 합니다.
• 인증된 브라우징 워크플로우: 로컬 Chrome 프로필을 동기화하거나 저장된 쿠키로 클라우드 세션을 재사용하여 이미 로그인된 사이트 내에서 작업해야 합니다.
• 병렬 클라우드 AI 에이전트: 여러 자율 브라우저 에이전트를 동시에 디스패치하고(예: 경쟁사 조사, 대량 데이터 수집) 그 결과를 폴링해야 합니다.

• 단순 HTTP API 호출: 사이트가 REST 또는 GraphQL API를 제공하는 경우, 직접 호출하는 것이 브라우저 자동화보다 빠르고 안정적입니다.
• 정적 HTML 스크래핑: 페이지에 JavaScript 렌더링이나 상호작용이 필요하지 않은 경우, 경량 HTTP 요청이 더 효율적입니다.
• 비브라우저 자동화: 웹 브라우저와 관련 없는 작업(파일 시스템 작업, 데이터베이스 쿼리 등)은 이 스킬의 범위에 포함되지 않습니다.

브라우저는 명령 사이에도 계속 열려 있으므로, 재시작 없이 open, state, click, input, screenshot을 사용하여 여러 단계의 워크플로를 구성할 수 있습니다. 이름이 지정된 세션(--session NAME)을 사용하면 여러 개의 독립적인 브라우저를 병렬로 실행할 수 있습니다.

chromium (빠르고, 헤드리스이며, 격리됨), real (선택적 프로필 및 쿠키를 사용하는 설치된 Chrome 바이너리), 또는 remote (프록시 지원이 포함된 클라우드 호스팅 브라우저) 중에서 선택하세요. 각 모드는 격리성, 인증, 비용 간의 다양한 트레이드오프에 적합합니다.

브라우저 프로필과 쿠키를 목록 조회, 검사, 동기화, 가져오기 및 내보내기 — 로컬 또는 클라우드에서 사용 가능합니다. 도메인 범위 쿠키 동기화를 통해 관련 없는 세션 토큰을 노출하지 않고도 로컬 Chrome 프로필의 인증 정보를 클라우드 브라우저 세션으로 가져올 수 있습니다.

browser-use -b remote run "task"를 사용하여 클라우드에서 자율 브라우저 에이전트를 실행하세요. 비동기 실행, 병렬 세션, 순차 작업 간 세션 재사용, 구조화된 JSON 출력, LLM 모델 선택 (예: gpt-4o, claude-sonnet), 그리고 평가를 위한 판단 모드를 지원합니다.

browser-use python 명령어를 사용하여 브라우저 세션 내에서 임의의 Python 코드를 실행하세요. 변수와 browser 객체는 명령어 간에 유지되며, CLI를 벗어나지 않고도 탐색, 상호작용 및 페이지 데이터에 프로그래밍 방식으로 접근할 수 있습니다.

browser-use tunnel <port> 명령어를 사용하여 로컬 개발 서버를 클라우드 브라우저에 노출할 수 있습니다. 이 명령어는 Cloudflare 터널을 생성하고 공개 URL을 반환합니다. 터널은 브라우저 세션과 독립적으로 작동하며 close 명령어 이후에도 유지됩니다.

로컬 Chrome 프로필에서 쿠키를 동기화하고, SaaS 도구에 인증된 클라우드 세션을 열고, 내보내기 페이지로 이동하여 다운로드 버튼을 클릭한 후 완료될 때까지 기다리세요 — 수동 로그인 없이 모든 작업이 가능합니다.

각각 다른 경쟁사의 가격 페이지를 대상으로 하는 세 개의 클라우드 에이전트 작업을 동시에 실행합니다. task status로 상태를 폴링하고, 각 작업이 완료되면 구조화된 출력을 수집한 후, session stop --all로 모든 세션을 한 번에 중지합니다.

터널을 통해 로컬 개발 서버를 열고, state의 요소 인덱스를 사용하여 다단계 폼을 단계별로 진행하세요. 각 단계에서 browser-use screenshot path.png로 스크린샷을 캡처하고, browser-use wait text "Success"로 최종 페이지 텍스트를 확인하세요.

JavaScript로 렌더링된 목록 페이지로 이동하여 아래로 스크롤해 더 많은 결과를 불러온 다음, browser-use get html --selector ".results"를 사용해 관련 fragment를 추출하고, browser-use eval을 실행하여 DOM에서 구조화된 데이터를 가져옵니다.