platonai/Browser4

Browser4 — an AI-native browser engine for autonomous agents, intelligent extraction, and large-scale web automation.

🤖 Browser4 – 개요

Browser4는 AI 네이티브 브라우저 자동화 엔진입니다. 대규모 언어 모델 에이전트(또는 인간)가 빠른 Rust 기반 CLI(browser4‑cli)를 통해 실제 Chromium 기반 브라우저를 구동할 수 있습니다. 이 시스템은 전통적인 웹 자동화(클릭, 입력, 스크롤, 스크린샷)와 제로 토큰 추출 – X‑SQL 및 CSS 선택자를 사용한 결정적 데이터 추출, 선택적으로 LLM 기반 추출 – 을 결합합니다. 또한 LLM 호출 없이 HTML 페이지를 스프레드시트로 클러스터링하는 WebMiner 파이프라인도 포함합니다.

주요 기능(README에서)

기능	설명
에이전트 브라우저	에이전트가 브라우저를 열고, 상호 작용(클릭, 입력, 스냅샷)하고, 배치 작업을 실행하고, 페이지를 반복할 수 있습니다.
제로 토큰 추출	X‑SQL + CSS 선택자 또는 WebMiner ML 클러스터링을 사용하여 LLM 토큰을 소비하지 않고 페이지를 구조화된 테이블로 변환합니다.
하이브리드 인텔리전스	LLM 추출, ML 클러스터링, 재사용 가능한 선택자 저장소를 혼합합니다.
고성능 런타임	코루틴 안전, CDP 네이티브 엔진으로 머신당 하루 10만~20만 페이지 방문을 목표로 하며, 스웜/크롤 규모 확장을 지원합니다.
엔터프라이즈 규모 자동화	스웜 크롤링, 배치/루프 작업, 상태 저장 세션, 플러그인, 런타임 스킬, 브라우저 확장, HTTP 기반 MCP를 지원합니다.
프로그래밍 에이전트 커널	에이전트가 Browser4 아티팩트를 생성, 검증, 자체 개발할 수 있는 50개 이상의 `coding.*` 도구를 제공합니다.

작동 방식(아키텍처 개요)

백엔드 – Chrome DevTools Protocol(CDP)을 통해 Chrome/Edge와 통신하는 Java/Kotlin 런타임(Maven Central에서 browser4‑core로 게시). 세션, 플러그인, 스킬, 에이전트 상태용 Pulsar SDK를 관리합니다.
CLI(browser4‑cli) – 백엔드에 HTTP/MCP 명령을 보내는 Rust 래퍼입니다. open, click, snapshot, htmlsnapshot, crawl, swarm 등 셸과 유사한 인터페이스를 제공하며 인간이나 AI 에이전트가 사용할 수 있습니다.
모듈 – 프로그래밍 에이전트 커널(browser4‑coding), 테스트 픽스처 서버(MockSite), WebMiner ML 클러스터링 도구와의 통합을 포함합니다.

일반적인 사용 사례

자율 에이전트 – 짧은 스킬 파일로 LLM(예: Claude, DeepSeek)에 프롬프트를 주고, browser4‑cli를 호출하여 사이트를 탐색하고, 양식을 작성하고, 데이터를 추출하게 합니다.
제로 토큰 데이터 파이프라인 – URL 목록을 크롤링하고, htmlsnapshot query --sql … 또는 webminer를 실행하여 LLM 비용 없이 Excel/HTML 보고서를 생성합니다.
대규모 크롤링 – swarm create + swarm query를 사용하여 수만 건의 페이지 방문을 여러 머신에 분산합니다.
인간 참여 테스트 – 헤드드 브라우저를 열고 요소 참조(snapshot -i --boxes)를 검사한 후 추가 작업을 스크립트로 작성합니다.

시작하기(빠른 시작 단계)

설치 – npm install -g browser4-cli 후 browser4-cli install(또는 제공된 curl/PowerShell 스크립트 실행).
브라우저 열기 – browser4-cli open --headed https://example.com.
검사 – browser4-cli snapshot --boxes로 e15와 같은 요소 참조를 확인합니다.
상호 작용 – browser4-cli click e15, browser4-cli fill e16 "text" --submit.
추출 – browser4-cli get text "h1" 또는 browser4-cli htmlsnapshot query --sql @query.sql.
규모 확장 – 배치 또는 주기적 작업에는 crawl, swarm, loop 명령을 사용합니다.

생태계 및 통합

DeepSeek 하네스 – 플러그인(dsh-browser4)을 통해 dsh 에이전트 프레임워크가 Browser4를 직접 호출할 수 있습니다.
WebMiner – 로컬(SMILE ML 라이브러리)에서 실행되어 HTML을 스프레드시트로 클러스터링합니다. 상업용 버전은 Apache Spark를 사용하여 1,000페이지 이상을 처리합니다.
플러그인 및 스킬 – 내장 플러그인 시스템으로 기능을 확장합니다. browser4-cli plugin-list로 확인할 수 있습니다.
LLM 제공자 – 환경 변수를 통해 DeepSeek, OpenRouter, Volcengine, OpenAI 호환, Aliyun Qwen을 지원합니다.

문서 및 지원

웹사이트 – https://browser4.io
GitHub – 이슈, 릴리스, CI 배지, Maven Central 아티팩트.
CLI 도움말 – browser4-cli --help 및 browser4-cli help <command>.
상태 대시보드 – http://127.0.0.1:18182/status에서 실시간 상태, 세션, 스웜 작업 등을 표시합니다.
커뮤니티 – 리포지토리의 "Support & Community" 아래에 지원 링크가 있습니다.

라이선스

Apache‑2.0.

요약: Browser4는 AI 에이전트와 대규모 웹 데이터 추출을 위해 설계된 풀스택, 고성능 브라우저 자동화 플랫폼으로, 전통적인 Selenium 스타일 상호 작용과 토큰 없는 ML 기반 웹 콘텐츠 구조화를 모두 제공합니다.