# Browser Tool (/ko/docs/verdent-for-vscode/core-features/browser-tool)
> 브라우저 세션을 사용해 웹 상호작용을 자동화하고, UI를 테스트하고, 스크린샷을 캡처합니다
Browser Tool는 AI 기반 브라우저 상호작용을 지원합니다. 자연어 명령으로 브라우저 세션을 실행하고, 요소를 선택하고, 텍스트를 입력하고, 페이지를 스크롤하고, 스크린샷을 캡처할 수 있습니다.
### 배우는 내용 [#배우는-내용]
* 세션 수명 주기: 실행 → 상호작용 → 닫기
* 브라우저 동작: 선택, 입력, 스크롤
* 사용 사례: UI 테스트, 스크린샷, 탐색
***
## 세션 수명 주기 [#세션-수명-주기]
모든 브라우저 자동화 워크플로는 엄격한 순서를 따릅니다.
1. **실행** - 대상 URL에서 브라우저 세션을 시작합니다
2. **상호작용** - 동작을 수행합니다(선택, 입력, 스크롤)
3. **닫기** - 세션을 종료해 리소스를 해제합니다
브라우저 상태는 세션 내 동작 사이에 유지됩니다. 다른 Verdent 도구를 사용하기 전에 반드시 브라우저를 닫아야 합니다.
각 동작은 현재 브라우저 상태를 보여 주는 스크린샷을 반환합니다. 다음 단계로 진행하기 전에 동작 사이의 스크린샷을 확인해 성공 여부를 검증합니다.
***
## 브라우저 동작 [#브라우저-동작]
**새 브라우저 세션 시작**
* 필수: 대상 URL
* 1920x1080 해상도로 브라우저를 엽니다
* 모든 워크플로에서 항상 첫 번째 동작입니다
```
Launch browser at https://example.com
```
**특정 좌표 선택**
* 필수: x,y 좌표
* 좌표는 뷰포트를 기준으로 합니다
* 안정성을 위해 대상 요소의 중앙을 지정합니다
```
Click coordinates 450,300
```
**키보드로 텍스트 입력**
* 필수: 입력할 텍스트
* 현재 포커스된 요소에 입력합니다
* 보통 입력 필드를 선택한 뒤 이어서 사용합니다
```
Type "user@example.com"
```
**페이지 스크롤**
* `scroll_down` - 한 페이지 높이만큼 아래로 스크롤합니다
* `scroll_up` - 한 페이지 높이만큼 위로 스크롤합니다
* 화면 밖 콘텐츠를 표시합니다
```
Scroll down to load more content
```
**브라우저 세션 종료**
* 모든 워크플로에서 항상 마지막 동작입니다
* 다른 도구를 사용하기 전에 필요합니다
* 브라우저 리소스를 해제합니다
```
Close browser
```
좌표는 1920x1080 뷰포트를 기준으로 합니다. 중앙은 대략 (960, 540)입니다. 스크린샷을 사용해 요소 위치를 추정합니다.
***
## 일반적인 사용 사례 [#일반적인-사용-사례]
**폼 제출과 탐색 흐름 테스트**
로그인 페이지에서 시작해 입력 필드를 선택하고, 인증 정보를 입력하고, 폼을 제출한 뒤 스크린샷으로 결과를 확인합니다.
```
Launch browser at https://app.example.com/login
Click coordinates 450,280
Type "testuser@example.com"
Click coordinates 450,340
Type "password123"
Click coordinates 500,420
Close browser
```
**문서화를 위한 페이지 캡처**
스크린샷은 각 동작 후 자동으로 캡처됩니다. 대상 페이지와 섹션으로 이동해 시각적 문서를 만듭니다.
```
Launch browser at https://docs.example.com
Scroll down to API section
Close browser
```
**대상 콘텐츠로 이동**
추출 전에 브라우저 자동화를 사용해 상호작용이 필요한 콘텐츠로 이동합니다(메뉴 선택, 지연 로드 콘텐츠 불러오기 등).
```
Launch browser at https://store.example.com
Scroll down three times
Click "Next Page" at 960,800
Close browser
```
***
## 제한 사항 [#제한-사항]
* **도구 단독 사용** - 활성 세션 중에는 browser\_action만 사용할 수 있습니다
* **좌표 기반** - CSS 선택자가 아니라 x,y 좌표가 필요합니다
* **고정 해상도** - 브라우저 뷰포트는 1920x1080으로 고정됩니다
* **Chrome 전용** - Puppeteer는 Chrome/Chromium 브라우저를 지원합니다
* **지속성 없음** - 세션은 Verdent 재시작 후 유지되지 않습니다
* **WSL 지원 없음** - Browser Tool는 WSL 환경에서 작동하지 않습니다
* **저장된 상태 없음** - 각 세션은 쿠키나 인증 없이 새로 시작합니다
* **단일 세션** - 한 번에 하나의 브라우저 세션만 활성화할 수 있습니다
파일 작업, 검색 도구, bash 명령을 사용하기 전에 항상 브라우저 세션을 닫습니다. 활성 세션 중에는 브라우저가 다른 도구를 잠급니다.
***
## 함께 보기 [#함께-보기]
코드 변경 사항을 검토하고 승인합니다