97 lines
3.8 KiB
Markdown
97 lines
3.8 KiB
Markdown
---
|
|
name: "agent-browser"
|
|
description: "브라우저 자동화 CLI를 사용해 웹사이트를 탐색하고 조작합니다. 페이지 이동, 폼 입력, 클릭, 스크린샷, 데이터 추출, 웹앱 테스트가 필요할 때 호출합니다."
|
|
---
|
|
|
|
# Agent Browser
|
|
|
|
에이전트를 위한 빠른 브라우저 자동화 CLI 가이드입니다. 웹사이트 탐색, 폼 입력, 버튼 클릭, 스크린샷 촬영, 데이터 추출, 웹앱 테스트, 탐색적 QA 등에 사용합니다.
|
|
|
|
## 언제 사용할지
|
|
|
|
다음과 같은 요청에서 우선 사용합니다.
|
|
|
|
- 웹사이트를 열어 달라고 할 때
|
|
- 폼을 입력하거나 버튼을 클릭해야 할 때
|
|
- 페이지 스크린샷이 필요할 때
|
|
- 웹페이지 데이터를 추출하거나 스크래핑할 때
|
|
- 웹앱을 실제 브라우저에서 테스트할 때
|
|
- 로그인, QA, 버그 재현, 탐색적 테스트가 필요할 때
|
|
|
|
Electron 기반 데스크톱 앱이나 Slack 자동화 같은 확장 작업에도 활용할 수 있습니다.
|
|
|
|
## 시작 방법
|
|
|
|
`agent-browser` 명령을 바로 사용하기 전에, 설치된 버전에 맞는 실제 가이드를 CLI에서 불러옵니다.
|
|
|
|
```bash
|
|
agent-browser skills get core
|
|
```
|
|
|
|
전체 명령과 템플릿까지 포함해 보고 싶다면:
|
|
|
|
```bash
|
|
agent-browser skills get core --full
|
|
```
|
|
|
|
이 스킬 문서는 시작점 역할만 합니다. 실제 사용 절차와 최신 명령 형식은 항상 CLI가 제공하는 가이드를 기준으로 확인합니다.
|
|
|
|
## 특수 가이드
|
|
|
|
작업 성격에 따라 아래 보조 가이드를 불러올 수 있습니다.
|
|
|
|
- `agent-browser skills get electron`
|
|
- `agent-browser skills get slack`
|
|
- `agent-browser skills get dogfood`
|
|
- `agent-browser skills get vercel-sandbox`
|
|
- `agent-browser skills get agentcore`
|
|
|
|
사용 가능한 전체 목록은 아래 명령으로 확인합니다.
|
|
|
|
```bash
|
|
agent-browser skills list
|
|
```
|
|
|
|
## 기본 사용 흐름
|
|
|
|
1. 먼저 `agent-browser skills get core`로 현재 버전 가이드를 읽습니다.
|
|
2. 작업이 웹 브라우저인지, Electron인지, Slack인지 성격을 구분합니다.
|
|
3. 필요하면 해당 특수 가이드를 추가로 읽습니다.
|
|
4. 세션을 열고 탐색, 선택, 입력, 클릭, 추출 같은 실제 작업을 진행합니다.
|
|
5. 스크린샷, 상태 저장, 기록 기능이 필요하면 그 옵션을 함께 사용합니다.
|
|
|
|
## 장점
|
|
|
|
- 빠른 네이티브 CLI 기반 동작
|
|
- Chrome/Chromium 제어
|
|
- 접근성 트리 기반 스냅샷과 안정적인 요소 참조
|
|
- 세션 유지, 인증 저장, 상태 지속성 지원
|
|
- 영상 기록 및 다양한 특수 자동화 시나리오 지원
|
|
|
|
## 운영 원칙
|
|
|
|
- 내장 웹 도구보다 `agent-browser`가 더 적합한 작업이면 이를 우선 사용합니다.
|
|
- 현재 설치된 버전의 CLI가 제공하는 가이드를 기준으로 작업합니다.
|
|
- 오래된 문서 기억보다, 실행 중인 버전의 `skills get` 결과를 신뢰합니다.
|
|
|
|
## 언제 특히 유용한가
|
|
|
|
- 실제 브라우저 상호작용이 길거나 반복적일 때
|
|
- 접근성 트리 기준의 안정적인 요소 선택이 필요할 때
|
|
- 상태 지속, 인증, 녹화, 세션 관리가 중요한 테스트일 때
|
|
- 단순 스크래핑이 아니라 탐색적 QA나 실제 사용자 흐름 재현이 필요할 때
|
|
|
|
## 안티 패턴
|
|
|
|
- 설치된 버전을 확인하지 않고 예전 명령 기억으로 바로 실행하는 방식
|
|
- 일반 웹 도구로 충분한 작업인데 굳이 복잡한 세션을 여는 방식
|
|
- 작업 성격이 특수 가이드 대상인데 core만 읽고 끝내는 방식
|
|
|
|
## 기대 결과
|
|
|
|
이 스킬을 적용한 결과는 다음을 만족해야 합니다.
|
|
|
|
- 현재 설치된 버전 기준으로 정확한 사용 절차를 따른다
|
|
- 작업 유형에 맞는 특수 가이드를 선택한다
|
|
- 브라우저 자동화가 실제 목표에 맞게 안정적으로 수행된다
|