Browser Use

에이전트가 사람처럼 웹을 쓰게 하는 파이썬 라이브러리

uv add browser-use

에이전트가 브라우저를 사람처럼 쓰게 하는 파이썬 라이브러리입니다. 페이지를 열고 클릭하고 입력해 지시한 작업을 끝냅니다. 스킬 설치 명령으로 코딩 에이전트에 붙여 쓰는 경로도 제공합니다.

판단

이럴 때 씁니다

  • API 가 없는 웹 서비스를 자동화해야 할 때
  • 폼 작성이나 자료 수집처럼 여러 페이지를 오가는 작업을 맡기고 싶을 때
  • 파이썬 코드 안에서 브라우저 에이전트를 직접 다루고 싶을 때
  • 코딩 에이전트에 브라우저 능력을 스킬로 붙이고 싶을 때

이럴 땐 쓰지 마세요

  • 대상 서비스가 공식 API 를 제공할 때. 그쪽이 훨씬 안정적입니다
  • 약관이 자동 접근을 금지하는 사이트일 때
  • 결정적인 재현성이 필요한 테스트 자동화일 때

차별점

  • 자연어 지시만으로 브라우저 조작 전 과정을 맡깁니다.
  • 코딩 에이전트용 스킬 설치 경로를 함께 제공합니다.
  • MCP 연동을 지원해 다른 도구와 붙습니다.
  • 스타 11만을 넘는 규모라 사례와 문제 보고가 풍부합니다.

워크플로

  1. 01uv add browser-use 로 설치합니다.
  2. 02작업을 자연어로 기술하고 에이전트를 실행합니다.
  3. 03실행 기록을 보며 어느 단계에서 어긋났는지 확인하고 지시를 다듬습니다.
  4. 04코딩 에이전트에 붙일 때는 스킬 설치 명령으로 등록합니다.

주요 명령

명령설명
uv add browser-use프로젝트에 설치합니다. 파이썬 3.12 기준을 권장합니다.
browser-use skill install코딩 에이전트에 스킬로 등록합니다.

함정

설치 전에 확인하세요

  • 웹 자동화는 페이지 구조가 바뀌면 깨집니다. 중요한 작업이라면 실패를 전제로 재시도와 검증을 붙여야 합니다.
  • 로그인 세션과 자격 증명을 다루므로 실행 환경 격리가 필요합니다.
  • 의존성이 많고 최근 릴리스가 버전을 정확히 고정하는 방향으로 바뀌었습니다. 다른 패키지와 충돌할 수 있습니다.

비교

Stagehand 가 자연어와 코드를 섞어 안정성을 확보하려 한다면, Browser Use 는 지시 한 줄로 끝까지 맡기는 쪽에 가깝습니다. 탐색적 작업에는 후자가 편하고, 반복 실행할 파이프라인에는 코드로 고정할 수 있는 전자가 안전합니다.

최근 변경

0.13.10 은 의존성 정리가 중심입니다. 선언된 런타임과 개발, 빌드 의존성을 모두 정확한 버전으로 고정하고 MCP 파이썬 SDK 2.1.1 로 옮겼습니다. pypdf 를 올려 보안 권고 세 건을 해소했고, 알 수 없는 MCP 도구 호출을 성공으로 처리하던 동작을 오류로 바꿨습니다.