CDP 모드
크롬 개발자 도구 프로토콜(Chrome DevTools Protocol)을 통해 기존 브라우저에 연결합니다:
# Chrome 시작 시: google-chrome --remote-debugging-port=9222
# 한 번만 연결한 후, --cdp 없이 명령 실행
agent-browser connect 9222
agent-browser snapshot
agent-browser tab
agent-browser close
# 또는 각 명령어마다 --cdp 전달
agent-browser --cdp 9222 snapshot원격 WebSocket URL
WebSocket URL을 통해 원격 브라우저 서비스에 연결합니다:
# 원격 브라우저 서비스에 연결
agent-browser --cdp "wss://browser-service.com/cdp?token=..." snapshot
# 모든 CDP 호환 서비스와 함께 작동
agent-browser --cdp "ws://localhost:9222/devtools/browser/abc123" open example.com--cdp 플래그는 다음 중 하나를 허용합니다:
- 로컬 연결을 위한 포트 번호 (예:
9222) →http://localhost:{port}사용 - 원격 브라우저 서비스를 위한 완전한 WebSocket URL (예:
wss://...또는ws://...)
자동 연결
--auto-connect를 사용하여 포트를 지정하지 않고도 실행 중인 크롬 인스턴스를 자동으로 탐지하고 연결할 수 있습니다:
# 원격 디버깅이 활성화된 실행 중인 크롬 자동 탐지
agent-browser --auto-connect open example.com
agent-browser --auto-connect snapshot
# 환경 변수를 통해 설정하기
AGENT_BROWSER_AUTO_CONNECT=1 agent-browser snapshot자동 연결은 다음 방식으로 크롬을 탐지합니다:
- 기본 사용자 데이터 디렉터리에서 크롬의
DevToolsActivePort파일을 읽음 - 일반적으로 사용되는 디버깅 포트(9222, 9229)를 조사하는 대체 방법
이 기능은 다음 경우에 유용합니다:
- 크롬 144 이상에서
chrome://inspect/#remote-debugging를 통해 원격 디버깅이 활성화됨 (동적 포트 사용) - 기존 브라우저에 구성 없이 연결하고 싶을 때
- 크롬이 사용하는 포트를 추적하지 않아도 될 때
색상 테마
CDP를 통해 연결할 때 플레이워라이트는 기본적으로 브라우저의 색상 테마를 light로 재정의합니다. 영구적인 선호 설정을 위해 --color-scheme를 사용하세요:
agent-browser --cdp 9222 --color-scheme dark open https://example.com
agent-browser --cdp 9222 snapshot # 다크 모드 유지또는 구성 파일이나 환경 변수를 통해 전역적으로 설정할 수 있습니다:
AGENT_BROWSER_COLOR_SCHEME=dark agent-browser --cdp 9222 open https://example.com활용 사례
이 기능은 다음과 같은 제어를 가능하게 합니다:
- 일렉트론 앱
- 원격 디버깅이 가능한 크롬/크로미움
- 웹뷰2 애플리케이션
- 원격 브라우저 서비스 (웹소켓 URL을 통한)
- 어떤 브라우저든 CDP 엔드포인트를 노출하는 경우
전역 옵션
| 옵션 | 설명 |
|---|---|
--session <이름> | 고립된 세션 사용 |
--profile <경로> | 지속적인 브라우저 프로필 디렉터리 |
-p <공급자> | 클라우드 브라우저 공급자 (browserbase, browseruse, kernel) |
--headers <json> | 원본 범위 내의 HTTP 헤더 |
--executable-path | 사용자 정의 브라우저 실행 파일 |
--args <args> | 브라우저 시작 인수 (쉼표로 구분) |
--user-agent <ua> | 사용자 정의 사용자 에이전트 문자열 |
--proxy <url> | 프록시 서버 URL |
--proxy-bypass <hosts> | 프록시를 우회할 호스트 목록 |
--json | 스크립트용 JSON 출력 |
--full, -f | 전체 페이지 스크린샷 |
--name, -n | 로케이터 이름 필터 |
--exact | 정확한 텍스트 매칭 |
--headed | 브라우저 창 표시 |
--cdp <포트|URL> | CDP 연결 (포트 또는 웹소켓 URL) |
--auto-connect | 실행 중인 크롬 자동 탐지 및 연결 |
--color-scheme <테마> | 영구 색상 테마 (dark, light, no-preference) |
--debug | 디버그 출력 |
클라우드 공급자
로컬 브라우저가 사용 불가능할 경우 클라우드 브라우저 인프라를 사용합니다:
# Browserbase
export BROWSERBASE_API_KEY="your-api-key"
export BROWSERBASE_PROJECT_ID="your-project-id"
agent-browser -p browserbase open https://example.com
# Browser Use
export BROWSER_USE_API_KEY="your-api-key"
agent-browser -p browseruse open https://example.com
# Kernel
export KERNEL_API_KEY="your-api-key"
agent-browser -p kernel open https://example.com
# 또는 환경 변수를 통해 설정
export AGENT_BROWSER_PROVIDER=browserbase
agent-browser open https://example.com-p 플래그는 AGENT_BROWSER_PROVIDER보다 우선순위가 높습니다.