nativewright은(는) 무엇을 하나요?
AI 에이전트가 CLI 명령어로 지속적인 Chrome 브라우저를 제어하고 로그인 상태를 유지할 수 있도록 합니다.
개요
nativewright는 AI 에이전트가 명령줄 인터페이스를 통해 Chrome 브라우저 인스턴스를 제어할 수 있게 해주는 도구입니다. Playwright를 기반으로 하여 브라우저 프로필을 유지하므로, 로그인 세션과 쿠키가 브라우저 사용 간에 지속됩니다.
주요 명령어
| 명령어 | 설명 |
|---|---|
open | 새 브라우저 창 열기 |
close | 브라우저 닫기 |
goto <url> | 지정된 URL로 이동 |
screenshot [name] | 현재 페이지 스크린샷 캡처 |
html [selector] | 페이지 또는 선택자의 HTML 가져오기 |
text [selector] | 페이지 또는 선택자의 텍스트 콘텐츠 가져오기 |
click <selector> | 요소 클릭 |
type <selector> <text> | 입력 필드에 텍스트 입력 |
eval <code> | 페이지에서 JavaScript 실행 |
cookies | 현재 쿠키 나열 |
clear-cookies | 모든 쿠키 삭제 |
download <url> | URL에서 파일 다운로드 |
upload <selector> <path> | 파일 업로드 |
wait <ms> | 지정된 시간(밀리초) 동안 대기 |
설치
npm install -g nativewright
사용법
npx nativewright open
npx nativewright goto https://example.com
npx nativewright screenshot login-page
npx nativewright close
설정
환경 변수:
NATIVEWRIGHT_PORT- 브라우저 인스턴스가 수신할 포트 (기본값: 9222)NATIVEWRIGHT_PROFILE- 브라우저 프로필 디렉토리 경로 (기본값:./.nativewright-profile)NATIVEWRIGHT_HEADLESS- 헤드리스 모드 활성화 (true또는false, 기본값:false)
동작 방식
nativewright는 백그라운드에서 Playwright를 사용하여 Chrome 인스턴스를 실행합니다. 브라우저가 열리면 모든 후속 명령어는 해당 동일한 인스턴스를 대상으로 실행됩니다. 브라우저 프로필이 유지되므로 로그인 세션과 쿠키가 명령어 실행 간에 유지됩니다.
라이선스
MIT