OpenSource-Hub

browser-use

라이브러리

browser-use/browser-use

AI 에이전트가 인간처럼 브라우저를 조작하여 작업을 완료하도록 합니다.

개요

Browser Use는 Python 기반 라이브러리로, 대규모 언어 모델 에이전트가 Playwright를 통해 실제 브라우저를 조작하여 클릭, 입력, 양식 작성, 데이터 추출 등의 작업을 수행할 수 있게 하며, 로컬 실행 또는 클라우드 호스팅을 지원합니다.

README 미리보기

\n\n  \n  \n  \n\n\n\n    \n    \n    \n    \n    \n\n\n\n\n\n\n---\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n# What can Browser Use do?\n\nBrowser Use lets an AI agent use a web browser the same way humans do — it opens pages, clicks buttons, types, and fills in forms. You describe the task, and it completes it. For example, you can have it:\n\n\n### 📋 Fill Forms\n#### Task: "Fill in this job application with my resume and information."\n\n\n\n[Example code ↗](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/apply_to_job.py)\n\n\n### 🍎 Extract data\n#### Task: "Extract structured data about my followers and export it as a CSV."\n\nhttps://github.com/user-attachments/assets/485fd3ec-61b9-4afc-9e86-ee9b85acb592\n\n[Browser Use Cloud Docs ↗](https://docs.browser-use.com/cloud/quickstart)\n\n\n\n\n# Start with Browser Use Cloud\n\nEligible new Google, GitHub or Microsoft signups get a one-time **$15 Cloud credit**. No card required; email/password signups do not qualify. [Pricing and eligibility](https://browser-use.com/pricing.md).\n\n- **Hosted agent:** [V4 quickstart](https://docs.browser-use.com/cloud/agent/quickstart), using `browser-use-sdk`.\n- **Your own agent:** [Managed browser quickstart](https://docs.browser-use.com/cloud/browser/quickstart).\n- **Local framework:** the `browser-use` Python library below.\n\n# Quickstart\n\nIf you want to use Browser Use in your agent (Claude Code, Codex, Cursor, Hermes, OpenClaw, etc.), paste this prompt, and it sets everything up itself:\n\n```text\nInstall or upgrade browser-use to the latest stable version with uv using Python 3.12, run `browser-use skill install` to register the skill, and connect it to my browser. If setup or connection fails, follow https://github.com/browser-use/browser-harness/blob/main/install.md.\n```\n\nThen tell your agent what you want done.\n\n\n\n# Python library: the easiest way to automate the web\n\nWant to automate the web at scale, from your own code, and with 

FAQ (1)

문제 해결
Windows 11에서 browser-use를 실행할 때 발생하는 'An Application Control policy has blocked this file' (WinError 4551) 오류를 해결하는 방법

이것은 악성코드가 아닙니다: Windows 11 Smart App Control (SAC)이 uv/uvx가 생성하는 서명되지 않은 browser-use.exe 콘솔 스크립트 런처를 차단합니다(Code Integrity 이벤트 3033/3077, Authenticode 상태 NotSigned). 소비자용 SAC에는 앱별 허용 목록이 없으므로 이를 예외로 설정할 수 있는 토글이 없습니다.

우회 방법: 대신 Python 인터프리터를 통해 패키지를 호출하여 서명되지 않은 .exe 스텁을 완전히 우회합니다:

python -m browser-use <command>

또는 uv를 통해:

uv run python -m browser-use <command>

이렇게 하면 차단된 PE 런처를 건너뛰고 신뢰할 수 있는 인터프리터를 통해 CLI를 실행하여 로컬 Chrome/CDP 및 Browser Use Cloud 세션이 복원됩니다.

기타 옵션:
- 엔터프라이즈 관리 디바이스에서는 관리자가 좁은 범위로 지정된 App Control/WDAC 정책을 추가할 수 있습니다(서명된 릴리스에는 게시자 규칙을 권장합니다. 해시 규칙은 업데이트할 때마다 깨집니다).
- 로컬 Browser Use CLI를 호출하지 않는 CDP 기반 자동화 백엔드를 사용합니다.
- 런처를 실행하기 위해 Smart App Control을 비활성화하지 마세요. 시스템 전체의 코드 실행 보호가 약화됩니다.

영구적인 해결책: 업스트림에서 Microsoft 평판을 갖춘 Authenticode 서명 Windows CLI/설치 관리자를 제공해야 합니다. browser-use 이슈 #5539에서 이를 추적하세요.

원본 Issue #5539