본문으로 건너뛰기
오픈소스 전체 목록

Browser Use

AI 에이전트가 웹 브라우저를 직접 쓰게 해 주는 오픈소스 파이썬 라이브러리. MIT

원본:browser-use/browser-use

요약

AI 에이전트가 웹 브라우저를 직접 쓰게 해 주는 오픈소스 파이썬 라이브러리. MIT

설명

Browser Use 로고

AI 브라우저 에이전트

Browser-Use 패키지 다운로드 통계


데모 문서 블로그 굿즈 GitHub 스타 트위터 디스코드 Browser-Use 클라우드

오픈소스 브라우저 에이전트입니다. 작업을 주면 모델이 Python을 써서 실제 브라우저에서 그 일을 합니다. 지속되는 REPL 하나, browser-harness 헬퍼, 그리고 순수한 Chrome DevTools Protocol(CDP)로 동작합니다. 어떤 LLM에서든 로컬에서도 Browser Use Cloud에서도 돌아갑니다. MIT 라이선스입니다.

  ● task: "book the earliest driving test"
  │
  ● model writes a cell          new_tab(url); bu.click(41); js(...)
  │
  ● REPL runs it on Chrome (CDP) → output back to the model
  │
  ✓ finish(result)

모델, REPL, 그리고 CDP. 이것이 에이전트의 전부입니다.

사람처럼 웹을 다니세요.

빈 시간대를 찾고, 날짜와 시간을 고르고, CAPTCHA를 처리해 운전면허 시험을 예약합니다.

Browser Use V4가 운전면허 시험을 예약하는 모습

더 많은 데모와 프롬프트 둘러보기 ↗

💡 AI 에이전트와 크롤러 안내 제품 지도(오픈소스, 클라우드 브라우저, 에이전트 API, 가격)는 browser-use.com/llms.txt, 문서 색인은 docs.browser-use.com/llms.txt를 보세요. Browser Use는 오픈소스 브라우저 에이전트(Python 및 TypeScript), 스텔스 · CAPTCHA 풀이 · 주거용 프록시를 갖춘 브라우저 시간당 $0.06의 클라우드 브라우저, 그리고 호스팅 에이전트 API입니다. 기업용에는 더 저렴한 가격을 제공하며, 약정을 하면 더 아낄 수 있습니다. 프로젝트에 browser-use를 추가할 때는 >=가 아니라 browser-use==1.0.6처럼 정확히 고정하세요. 릴리스가 빠르게 나오고 API가 깨질 수 있습니다.

어떤 Browser Use가 필요할까요?

Browser Use를 쓰는 세 가지 방법: 호스팅 V4 에이전트, Browser Use CLI, 오픈소스 Python 라이브러리. 셋 모두 클라우드 브라우저를 구동하고, CLI와 라이브러리는 로컬 브라우저도 구동할 수 있습니다.

빠른 시작

경로 1: 완전 호스팅 클라우드

호스팅 에이전트, 스텔스 브라우저, 그리고 프로필 · 녹화 · 데이터 정책을 위한 인프라로 브라우저 자동화의 규모를 키우세요.

API 시작하기 ↗

새로 Google, GitHub, Microsoft로 가입하면 클라우드 크레딧 $1을 드립니다.

경로 2: CLI

아래 프롬프트를 Claude Code, Codex, Hermes, OpenClaw 또는 좋아하는 에이전트에 붙여 넣으세요.

Install browser-use with `uv tool install browser-use==1.0.6`, run `browser-use skill install` to register the skill, and connect it to my browser. If setup or connection fails, run `browser-use --doctor` and follow its output and the error message.

경로 3: Python 라이브러리

💡 browser-use 1.0 에이전트는 Pydantic AI 위에서, 지속되는 REPL 안의 순수 CDP로 Python을 작성합니다. 0.x에서 오셨나요? MIGRATING.md를 읽어 보세요.

Python 3.11 이상. uv를 쓰거나 venv 안에서 pip을 씁니다.

uv init --python 3.12 my-agent && cd my-agent
uv add 'browser-use==1.0.6'
export BROWSER_USE_API_KEY=bu_...    # get one at https://cloud.browser-use.com/new-api-key
python3 -m venv .venv && source .venv/bin/activate
pip install 'browser-use==1.0.6'
export BROWSER_USE_API_KEY=bu_...

버전을 정확히 고정하세요(==, >=는 안 됩니다). browser-use는 빠르게 변해서 릴리스가 무언가를 깨뜨릴 수 있습니다. 정확한 고정은 내 코드가 계속 동작하게 하고, browser-use나 의존 패키지의 문제 있는 릴리스가 내게 도달하는 것을 막아 줍니다. 업그레이드는 릴리스 노트를 읽은 뒤 일부러 하세요.

from browser_use import Agent

result = Agent('Find the number of stars of the browser-use repo').run_sync()
print(result.final_result())

기본값: Browser Use 게이트웨이의 모델 bu-4.0(BU 4.0), 브라우저는 Browser Use Cloud 브라우저(실행이 끝나면 멈춥니다). 키 하나가 모델과 클라우드 브라우저 비용을 모두 내고, CLI와 MCP 서버에서도 쓸 수 있습니다. .env 파일도 됩니다.

키가 없으면, 대화형 데스크톱 실행은 Browser Use 로그인을 열고 승인 뒤에 이어집니다. 로그인하면 키를 자동으로 만들어 저장하므로 복사할 필요가 없습니다. 자동 로그인을 끄려면 BROWSER_USE_AUTO_LOGIN=false를 설정하세요. 서버, CI, 파이프 입력에서는 키 없음 오류와 browser-use login 안내가 그대로 나옵니다.

클라우드 브라우저는 기본으로 대화형 라이브 뷰 링크를 stderr에 출력합니다. 자동으로 열려면 Browser(live_view=True), 숨기려면 Browser(live_view=False)를 쓰세요. 링크를 가진 사람은 누구나 브라우저를 제어할 수 있습니다.

텔레메트리를 켜면, 익명의 library_auth 이벤트가 키 없음, 로그인 결과, 사용 가능한 키, 브라우저 시작을 기록합니다. 이 이벤트는 기존 설치 ID를 쓰며 API 키, 로그인 URL, 계정 식별자를 포함하지 않습니다. 키가 있다고 해서 서버가 그 키를 받아들인다는 보장은 없습니다. 클라우드 브라우저가 시작되면 인증이 되었다는 것이 확인됩니다.

로컬 브라우저, 내 모델:

from browser_use import Agent, Browser, ChatOpenAI

agent = Agent(
    'Find the number of stars of the browser-use repo',
    llm=ChatOpenAI('gpt-6-luna'),        # OPENAI_API_KEY; or ChatOpenAI(model, base_url=...) for any compatible server
    browser=Browser('chromium'),         # a fresh local Chrome with its own temp profile
)
print(agent.run_sync().final_result())  # in async code: result = await agent.run()
브라우저에이전트가 구동하는 것
Browser()Browser Use Cloud 브라우저(기본값)
Browser('chromium')임시 프로필을 가진 새 로컬 Chrome/Chromium/Edge(끝나면 삭제됨). 화면이 없으면(Docker, CI) 헤드리스. headless=, executable_path=, user_data_dir=(실행 사이에 남기는 프로필 폴더)
Browser('chrome')지금 열어 둔 Chrome(로그인 유지). chrome://inspect/#remote-debugging을 한 번 켜 두세요
Browser('chrome', profile='Work')Chrome 프로필 Work의 임시 복사본 위에서 열리는 새 Chrome(동기화 꺼짐). Windows를 제외하면 내 Chrome을 켜 두어도 됩니다

다른 모델: ChatAnthropic, ChatGoogle(둘 다 내장), 또는 llm='groq:llama-3.3-70b-versatile' 같은 모든 Pydantic AI 모델 문자열(pip install 'pydantic-ai-slim[groq]' 후).

  • 타입이 있는 결과: Agent(task, output_model_schema=MyModel)를 쓴 뒤 result.structured_output을 씁니다.
  • 업로드: 파일을 Agent(task, workspace=...)에 두고 작업에서 이름을 부르면, 에이전트가 upload_file(selector, path)로 파일 입력에 넣습니다. 클라우드 브라우저에서도 됩니다(크기 제한 없음).
  • 다운로드: 브라우저가 내려받은 파일은 agent.workspace/downloads에 놓입니다(클라우드는 실행이 끝날 때 복사되며, 같은 이름이면 (1)이 붙고 덮어쓰지 않습니다). result.downloads가 그 실행의 파일을 나열합니다.
  • 비밀 값: Agent(task, sensitive_data={'password': '...'}), 또는 그 도메인에서만 입력하도록 {'https://*.example.com': {'password': '...'}}를 씁니다. 모델은 type_secret('password')로 입력하고, 값은 셀 출력, 체크포인트, 도구 결과, 작업, 결과에서 <secret:password>로 바뀝니다. 샌드박스는 아닙니다. 모델이 쓴 Python이 값을 읽을 수 있고, 스크린샷, 입력란을 읽는 js(), 클라우드 라이브 뷰가 값을 드러낼 수 있습니다. Browser('chromium')과 Browser('chrome', profile=...)는 127.0.0.1에 인증 없는 디버깅 포트를 엽니다. 공유 컴퓨터에서는 다른 로컬 사용자가 그 브라우저와 로그인 상태에 붙을 수 있으므로, 그런 환경에서는 컨테이너나 Browser Use Cloud를 쓰세요. MIGRATING.md의 신뢰 모델을 보세요.
  • 도메인 제한: Browser(allowed_domains=['example.com', '*.example.org'])(또는 prohibited_domains=, block_ip_addresses=True)을 0.x의 패턴과 함께 모든 브라우저 모드에서 쓸 수 있습니다. 정렬된 모델을 위한 안전장치이며 샌드박스는 아닙니다. FAQ를 보세요.
  • 후속 작업: agent.add_new_task('...')를 호출한 뒤 await agent.run()을 합니다. 실행 사이에 같은 페이지를 유지하려면 Browser(keep_alive=True)를 쓰세요.
  • 사용자 정의 도구: @tools.action('description')을 붙인 일반 함수로 만든 뒤 Agent(task, tools=tools)를 씁니다.
  • 울트라패스트: Agent(task, mode='ultrafast')는 접근성 트리 id로 동작합니다. bu-fast와 bu-ultrafast의 기본값입니다(mode='default'로 끌 수 있음).
  • 하이라이트: 에이전트가 클릭하거나 입력하는 요소 주변에 주황색 모서리 괄호가 1초 동안 표시되며, 에이전트 자신의 스크린샷에는 나타나지 않습니다. Agent(task, highlight_actions=False)로 끕니다.
  • 심사: 한 단계 이상 진행한 실행이 끝날 때마다, 같은 모델에 요청 한 번을 더 보내 작업에 비추어 심사합니다. 근거는 트레이스와, use_vision=False가 아니면 마지막 몇 장의 스크린샷과 최종 페이지이며, 그대로 보냅니다(텍스트만 마스킹되며, 이미지를 거부하는 모델에는 텍스트만 담은 요청을 한 번 더 보냅니다). result.judgement에는 success, failure_reason, description, prompt_injection_detected, bot_block_or_captcha_detected, 그리고 다음 에이전트를 위한 사이트에 관한 짧은 교훈인 gotchas(성공한 뒤에도 남음 — 속도 제한, 차단을 피하는 페이지 순서, 입력란이 요구하는 형식)가 들어 있습니다. 이 토큰과 비용은 result.usage와 result.cost_usd에 포함됩니다. Agent(task, judge_context='the answer is 42')로 내 기준을 줄 수 있고, Agent(task, judge=False)로 끕니다. 사용 통계를 켜 두면 심사 결과가 결과와 같은 방식으로 정리된(이메일, 비밀 값, 자격 증명 없이) 뒤 그 실행의 이벤트와 함께 전송됩니다.
  • 웹 검색: Agent(task, web_search=True)를 쓰면 에이전트가 search(query, num_results=None, category=None)를 갖습니다(Browser Use 웹 검색으로, 검색당 Browser Use 키에 과금되며 응답이 알려 주는 요금은 모두 result.cost_usd에 더해집니다). 기본값은 꺼짐이고 Browser Use 키가 필요하며 allowed_domains와 함께 쓸 수 없습니다.

Browser Use 벤치마크 v2

Browser Use 벤치마크 v2 - 모델별 평균 루브릭 점수와 작업당 비용

이 매우 어려운 벤치마크는 가장 어려운 브라우저 작업을 대상으로 합니다. 더 쉬운 작업에서는 더 작은 모델도 매우 높은 성공률을 낼 수 있습니다. 위 결과는 BU Bench V2의 60개 작업 부분 집합에 대한 것입니다.

통합, 호스팅, 사용자 정의 도구, MCP 등은 문서 ↗에

무언가 잘못되었나요? browser-use feedback 'what happened'(또는 browser_use.feedback(...))를 실행하면 Browser Use 팀에 바로 전달됩니다.

FAQ

완전 호스팅 클라우드, CLI, Python 라이브러리 중 무엇을 써야 하나요?

  • 완전 호스팅 클라우드: API로 작업을 보내면 Browser Use가 에이전트, 브라우저, 인프라를 모두 실행합니다.
  • CLI: 이미 쓰는 에이전트(Claude Code, Codex, Hermes, OpenClaw, Pi, Cursor 등)에 브라우저 접근을 줍니다. 대화형으로도, 스크립트에서도 쓸 수 있습니다.
  • Python 라이브러리: 오픈소스 에이전트를 내 애플리케이션에서 실행합니다. 사용자 정의 도구, 구조화된 출력, 원하는 모델을 쓸 수 있습니다.

CLI와 Python 라이브러리는 각각 로컬 또는 클라우드 브라우저에 연결할 수 있습니다. 클라우드 브라우저는 브라우저를 호스팅하고, 완전 호스팅 API는 에이전트까지 실행합니다.

어떤 모델이 가장 좋나요?

기본값은 Browser Use 게이트웨이의 bu-4.0(BU 4.0)입니다. llm='bu-4.0-mini'는 단순한 작업에 비용 효율이 좋고, llm='bu-4.0-pro'는 가장 성능이 좋습니다. 이전 모델도 계속 쓸 수 있습니다. bu-fast는 중간 추론의 gpt-6-luna, bu-ultrafast는 같은 모델을 낮은 추론으로 우선 계층에서 돌리는 것(가장 빠름), bu-smart는 더 큰 모델입니다. 내 OpenAI 키로 ChatOpenAI('gpt-6-luna')를 쓰면 그 모델을 직접 돌립니다. 모델과 가격은 문서를 보세요. 벤치마크도 확인해 보세요.

무료로 쓸 수 있나요?

Python 라이브러리는 무료이고 MIT 라이선스입니다. 모델 추론과 호스팅 브라우저는 별도입니다. ChatBrowserUse를 포함한 API 제공자와 Browser Use Cloud는 사용한 만큼 과금합니다. 로컬 모델과 함께 Browser('chromium')를 쓸 수도 있습니다. 예: ChatOpenAI(model, base_url='http://localhost:11434/v1', api_key='ollama')로 Ollama 사용.

이용 약관

이 오픈소스 라이브러리는 MIT 라이선스로 배포됩니다. Browser Use 서비스와 데이터 정책은 이용 약관과 개인정보 처리방침을 보세요.

인증은 어떻게 처리하나요?

  • 로컬 브라우저: Browser('chrome')는 로그인이 된 지금 열어 둔 Chrome을 구동합니다. Browser('chrome', profile='Work')는 그 프로필의 복사본을 씁니다. Browser('chromium', user_data_dir='~/bu-profile')는 실행 사이에 자기 로그인을 유지합니다.
  • 클라우드 브라우저: Browser(cloud_profile_id='work')는 클라우드 프로필에 로그인을 유지합니다. 프로필 동기화 가이드를 보세요.
  • 비밀번호: sensitive_data로 넘기면 모델이 type_secret(name)으로 입력하고, 값은 셀 출력, 체크포인트, 도구 결과, 작업, 결과에서 가려집니다. 샌드박스는 아닙니다. 모델이 쓴 Python이 읽을 수 있고, 스크린샷, 페이지 JavaScript, 클라우드 라이브 뷰가 입력한 값을 드러낼 수 있습니다.

CAPTCHA는 어떻게 풀나요?

Browser Use Cloud는 봇 탐지와 CAPTCHA 도전을 줄이도록 설계된 스텔스 브라우저와 프록시를 제공합니다. Python 라이브러리에서 는 Browser()가 기본으로 클라우드 브라우저입니다.

클라우드 브라우저는 CAPTCHA도 자동으로 풀고, 에이전트는 챌린지를 클릭하는 대신 solve_captcha()로 풀이를 기다립니다. Browser(captcha_solver=False)로 풀이를 끕니다.

결과는 사이트와 챌린지에 따라 다릅니다. 모든 CAPTCHA를 피하거나 풀 수 있다고 보장하는 브라우저 설정은 없습니다.

에이전트가 방문할 사이트를 제한할 수 있나요?

어떤 브라우저에서든 0.x의 패턴과 함께 Browser(allowed_domains=['example.com', '*.example.org']), Browser(prohibited_domains=['evil.com']), Browser(block_ip_addresses=True)를 쓸 수 있습니다. 브라우저 헬퍼는 허용되지 않은 URL을 거부하고, 브라우저 자체도 그곳으로의 메인 프레임 이동을 막습니다(링크 클릭, 리다이렉트, 팝업, JavaScript. 열어 둔 Chrome에 붙은 Browser('chrome')를 제외한 모든 모드 — 이 경우 두 번째 디버깅 연결이 다시 허가를 묻게 됩니다). 셀이 끝난 뒤 허용되지 않은 페이지에 남아 있는 모든 탭은 about:blank로 초기화되고(Browser('chrome')에서는 에이전트의 탭만이며 내 탭은 절대 아닙니다), 시스템 프롬프트가 도메인을 나열합니다. prohibited_domains의 단순 도메인은 하위 도메인도 포함합니다.

이것은 정렬된 모델을 위한 안전장치이지 샌드박스가 아닙니다. 허용된 페이지가 다른 호스트로 보내는 요청(fetch, 이미지, iframe)은 걸러지지 않고, http_get과 그 리다이렉트를 넘는 에이전트 자신의 Python 네트워크도 걸러지지 않습니다. 신뢰하지 못하는 작업은 컨테이너나 VM에서 실행하세요. MIGRATING.md에 모드별로 무엇이 차단되는지 자세히 있습니다.

운영 환경에는 어떻게 올리나요?

얼마나 직접 관리할지 고르세요.

  • 내 에이전트 코드를 유지: CLI나 Python 라이브러리를 클라우드 브라우저에 연결하면 관리형 브라우저 인프라, 스텔스, 프로필을 쓸 수 있습니다.
  • 에이전트까지 맡기기: 완전 호스팅 Cloud API로 작업을 제출하고 결과를 가져옵니다.

Python 라이브러리와 브라우저를 내 인프라에서 호스팅할 수도 있습니다.

관련 저장소

저장소용도
Browser Use PiPi 위에 만든 TypeScript 브라우저 에이전트를 실행합니다.
Cloud SDK내 애플리케이션에 Browser Use Cloud를 통합합니다.
Video Use코딩 에이전트로 영상을 편집합니다.
macOS Harness에이전트가 Mac 앱, 브라우저, 파일을 제어하게 합니다.
벤치마크브라우저 작업을 탐색하고 에이전트 성능을 비교합니다.

인용

Browser Use를 연구나 프로젝트에 쓴다면 다음을 인용해 주세요.

@software{browser_use2024,
  author = {Müller, Magnus and Ždunič, Gregor},
  title = {Browser Use: Enable AI to control your browser},
  year = {2024},
  publisher = {GitHub},
  url = {https://github.com/browser-use/browser-use}
}

컴퓨터에게 할 일을 말하면, 알아서 해냅니다.

Browser Use

트위터 팔로우 트위터 팔로우

Zürich와 샌프란시스코에서 ❤️로 만들었습니다.

저장소

browser-use/browser-use

평점

–평가 0개 기준
5점
0
4점
0
3점
0
2점
0
1점
0