요약
AI 에이전트가 웹 브라우저를 직접 쓰게 해 주는 오픈소스 파이썬 라이브러리. MIT
설명
오픈소스 브라우저 에이전트입니다. 작업을 주면 모델이 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를 처리해 운전면허 시험을 예약합니다.
💡 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가 필요할까요?
- 경로 1: 완전 호스팅 클라우드: 완전 호스팅되는 에이전트와 브라우저로 규모를 키웁니다.
- 경로 2: CLI: 내 브라우저 작업을 자동화합니다.
- 경로 3: Python 라이브러리: 오픈소스 Browser Use 에이전트를 내 코드에서 로컬로 실행합니다.
빠른 시작
경로 1: 완전 호스팅 클라우드
호스팅 에이전트, 스텔스 브라우저, 그리고 프로필 · 녹화 · 데이터 정책을 위한 인프라로 브라우저 자동화의 규모를 키우세요.
새로 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

이 매우 어려운 벤치마크는 가장 어려운 브라우저 작업을 대상으로 합니다. 더 쉬운 작업에서는 더 작은 모델도 매우 높은 성공률을 낼 수 있습니다. 위 결과는 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 Pi | Pi 위에 만든 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}
}
컴퓨터에게 할 일을 말하면, 알아서 해냅니다.
Zürich와 샌프란시스코에서 ❤️로 만들었습니다.
저장소
평점
- 5점
- 0
- 4점
- 0
- 3점
- 0
- 2점
- 0
- 1점
- 0