Lightpanda Browser: AI 에이전트와 웹 자동화를 위한 경량 헤드리스 브라우저
AI 에이전트와 웹 자동화를 위해 만든 경량 헤드리스 브라우저예요. Chromium 포크가 아니라 Zig 기반의 독립 구현이에요.
주요 기능
- JavaScript·DOM·쿠키·네트워크 요청을 처리하고 HTML·Markdown·구조화 데이터 추출을 제공해요.
- CDP와 WebDriver BiDi 서버, stdio·HTTP MCP로 자동화 클라이언트와 연결해요.
- 내장 agent 모드에서 작업을 탐색하고 PandaScript로 저장해 모델 없이 재실행하는 경로를 제공해요.
구조
Zig로 작성된 실행 파일에 V8 JavaScript 엔진, libcurl HTTP 로더, html5ever HTML 파서 등을 결합해요. 일반 브라우저의 그래픽 렌더링 엔진은 없으며 PNG·PDF 출력도 README에서 텍스트 전용 렌더라고 설명해요. build.zig.zon의 개발 버전은 1.1.0-dev예요.
누구에게 쓸모 있나요
서버에서 웹 데이터 추출·에이전트 브라우징·반복 자동화를 운영하는 개발자에게 적합해요. 시각 회귀 테스트나 모든 Chrome 기능의 대체재로 가정하면 안 돼요.
설치 전 준비
- 공식 Linux·macOS 바이너리는 x86_64와 aarch64를 안내해요. Linux 릴리스는 glibc 기반이며 README 기준 x86_64 2.35, arm64 2.38 이상이 필요해요.
- Windows는 네이티브 바이너리 대신 WSL2 경로를 안내해요. Android/Termux의 Bionic 환경에는 네이티브 빌드가 없어요.
- 소스 빌드는 Zig 0.17.0, Rust와 V8 빌드 도구 등이 필요해요. Docker 이미지는 Linux amd64·arm64용이에요.
- Linux glibc x86_64·aarch64
- macOS x86_64·Apple Silicon
- Windows WSL2 및 Linux Docker; Android 네이티브 미제공
설치 방법
공식 Docker 경로
Docker가 준비된 환경에서 CDP 포트를 loopback에만 연결하는 공식 예제예요. latest는 바뀌므로 배포 시 검토한 이미지 버전을 고정하십시오.
docker run -d --name lightpanda -p 127.0.0.1:9222:9222 lightpanda/browser:latestHomebrew nightly
공식 탭의 nightly 설치 경로예요. 안정 버전과 같다고 보장되지 않으며 실행·설치하지 않았어요.
brew install lightpanda-io/browser/lightpanda사용 방법
- 단일 URL은 fetch –dump html 또는 –dump markdown으로 추출하고 사이트의 접근 정책을 확인해요. robots.txt 존중은 –obey-robots 옵션이에요.
- serve를 127.0.0.1:9222에서 실행한 뒤 Puppeteer 등의 CDP 연결 주소를 ws://127.0.0.1:9222로 지정해요.
- MCP·agent·저장 스크립트는 별도 실행 모드예요. agent 모드의 모델 공급자를 구성하더라도 브라우저 호환성 검증은 필요해요.
비용과 API 키
브라우저 소스 이용과 모델 없는 스크립트 실행은 모델 토큰 비용을 요구하지 않지만 컴퓨팅·네트워크·호스팅은 별도예요. 내장 agent에서 외부 모델을 선택하면 그 공급자의 과금이 발생할 수 있어요.
라이선스
루트 LICENSE는 GNU AGPL version 3예요. 수정·배포·네트워크 제공 시 해당 소스 제공 조건을 검토해야 하며 MIT처럼 취급하면 안 돼요. 이 조사는 법률 자문이 아니에요.
주의사항과 알려진 이슈
- README의 16배 메모리 절감·9배 속도 수치는 프로젝트 벤치마크 결과이며 이번 조사에서 재현하지 않았어요.
- 일반 브라우저와 렌더링·레이아웃·웹 API 동작이 다를 수 있어요. 실제 대상 사이트와 자동화 흐름을 검증해야 해요.
- 사용량 텔레메트리가 기본 활성화돼요. 문서상 LIGHTPANDA_DISABLE_TELEMETRY=true로 끌 수 있어요.
- CDP·MCP 포트는 브라우저 제어 권한을 제공해요. 외부에 무방비로 노출하지 말고 방문 페이지·쿠키·스크립트를 신뢰 경계로 취급해야 해요.
#4371 nightly 레이아웃·클릭 대상 회귀 보고
특정 nightly에서 빈 블록이 컨트롤 위를 덮어 hit target이 바뀐다는 보고이며 1.0.1과 비교해요. 현재 커밋에서 직접 재현하지 않았어요.
#4352 textarea 자동 높이·Playwright 보고
높이 0인 textarea의 scrollHeight가 0으로 남아 입력 대상으로 보이지 않는다는 보고예요. 모든 사이트에 적용되는 결함으로 일반화하지 않았어요.
확인 범위
확인 날짜: 2026-11-02
확인 커밋: daa09e7a6aa8da82fbace78d547db55b2753e2d4
확인한 범위: 공식 main 커밋, 고정 커밋의 README·LICENSE·manifest 및 공개 이슈를 읽기 전용으로 확인했어요.
확인 한계: 외부 코드·의존성 설치나 실행, 모델 호출, 로그인, 성능 측정, 전체 보안 감사는 하지 않았어요. 설치·사용법은 공식 문서의 안내이며 실기 검증 결과가 아니에요. 이슈는 보고 내용으로, 재현하거나 확정 결함으로 판정하지 않았어요.