Browser-Use: AI에게 웹 탐색과 클릭을 맡기는 브라우저 자동화 오픈소스

매번 같은 사이트를 열어 정보를 찾고, 메뉴를 누르고, 결과를 옮겨 적는 일이 있다면 브라우저 자동화를 떠올리게 됩니다. Browser-Use는 그 순서를 자연어 목표에서 출발하도록 만드는 라이브러리입니다. 정해진 좌표를 누르는 매크로와 달리, 모델이 현재 페이지 정보를 보고 다음 행동을 고릅니다.

AI는 브라우저에서 어떤 일을 할까요?

예를 들어 “이 공개 문서의 시작 가이드를 열고 설치 항목을 찾아줘”처럼 범위가 작은 요청을 줄 수 있습니다. 에이전트는 페이지 상태를 읽고 링크 이동과 입력을 반복합니다. 페이지가 바뀌거나 예상하지 못한 팝업이 뜨면 실패할 수 있어, 중요한 업무에는 결과 확인이 필요합니다.

평소 쓰는 크롬의 모든 계정이 자동 연결되는 것은 아닙니다. 로컬 브라우저 실행, 기존 브라우저 연결, 클라우드 실행은 설정과 데이터 처리 범위가 다릅니다. 처음에는 개인 프로필과 분리된 브라우저로 시작하는 편이 작업 범위를 이해하기 쉽습니다.

비전공자를 위한 3단계 시작 가이드

01. Python 환경을 준비합니다

Python과 터미널 사용이 처음이라면 설치 과정에 시간이 필요합니다. 아래는 uv를 이용해 별도 프로젝트를 만드는 예시입니다. 빈 폴더에서 실행하고, 이미 프로젝트가 있다면 uv init은 생략하세요.

python -m pip install uv
uv init --python 3.12
uv add browser-use python-dotenv
uvx browser-use install

02. API 키와 첫 작업을 설정합니다

프로젝트 폴더에 .env 파일을 만들고 BROWSER_USE_API_KEY=발급받은키를 한 줄로 저장합니다. 키는 공식 서비스에서 발급하며 저장소에 올리지 않습니다. 아래 코드를 agent.py로 저장합니다. 설치만 끝내서는 자동화가 실행되지 않으며, 모델과 작업을 지정하는 코드가 필요합니다.

import asyncio
from dotenv import load_dotenv
from browser_use import Agent, ChatBrowserUse

load_dotenv()

async def main():
    agent = Agent(
        task="Open https://example.com and report its page title. Do not follow other links.",
        llm=ChatBrowserUse(),
    )
    await agent.run()

if __name__ == "__main__":
    asyncio.run(main())

03. 실행하고 결과를 확인합니다

터미널에서 uv run agent.py를 실행합니다. 브라우저가 example.com을 열고 정보를 읽는지 살펴보세요. 첫 작업이 성공하면 같은 코드를 복사해 본인이 관리하는 공개 페이지의 제목이나 도움말을 찾는 정도로 확장해볼 수 있습니다.

API 비용과 개인정보는 어디서 생길까요?

웹페이지를 읽는 과정에서 모델 호출이 발생합니다. 화면이나 페이지 텍스트가 외부 모델로 전송될 수 있고, 반복 시도도 사용량에 영향을 줍니다. 로컬 브라우저를 쓴다는 사실만으로 완전한 로컬 처리가 보장되지는 않습니다. 계정의 이용량 한도를 확인하고 짧은 작업부터 실행하세요.

결제, 계정 변경, 비밀번호 입력 같은 작업은 사람이 확인하는 단계가 필요합니다. 모델은 웹페이지 안의 잘못된 안내를 그대로 따를 수도 있습니다. 공개 정보 수집으로 동작 방식을 익힌 뒤 허용할 사이트와 작업 범위를 좁혀 사용하는 것이 좋습니다.

라이선스와 비용을 확인하세요

Python 라이브러리는 MIT 라이선스입니다. 모델 API와 Browser Use의 호스팅 서비스는 별도의 요금·이용 조건을 확인해야 합니다.

2026.11.01 공식 자료 기준으로 작성했습니다. 설치 명령은 문서와 대조했으며 이 글을 위해 직접 실행 검증하지는 않았습니다. 설치와 다운로드 시간은 환경에 따라 달라집니다. 대표 이미지는 도구의 용도를 설명하기 위해 AI로 제작한 사진형 이미지이며, 실제 제품 화면이나 실행 결과가 아닙니다.