universal-browser-skill은(는) 무엇을 하나요?
AI 에이전트를 위한 범용 브라우저 자동화 기술: 탐색, 데이터 추출, 양식 작성, 페이지 매김 처리, 반복적인 웹 워크플로를 재사용 가능한 사이트 레시피로 변환합니다.
개요
이 스킬은 AI 에이전트가 웹 브라우저와 상호작용할 수 있는 포괄적인 인터페이스를 제공합니다. 주요 기능은 다음과 같습니다:
- 페이지 탐색 및 URL 관리
- HTML 콘텐츠 및 텍스트 추출
- 양식 작성 및 제출
- 페이지 매김(페이지네이션) 처리
- 쿠키 및 세션 관리
- 스크린샷 캡처
- 사이트 레시피 생성 및 실행
설치
# npm을 통해 설치
npm install @KeNan-tech620/universal-browser-skill
# 또는 yarn 사용
yarn add @KeNan-tech620/universal-browser-skill
사용법
기본 탐색
import { BrowserSkill } from '@KeNan-tech620/universal-browser-skill';
const skill = new BrowserSkill();
// 페이지 열기
await skill.navigate('https://example.com');
// 페이지 제목 가져오기
const title = await skill.getTitle();
console.log(title);
// 페이지 콘텐츠 추출
const content = await skill.extractContent();
console.log(content);
양식 작성
// 양식 필드 작성
await skill.fillForm({
'#username': 'myuser',
'#password': 'mypassword'
});
// 양식 제출
await skill.submitForm('#login-form');
사이트 레시피 사용
레시피는 JSON 파일로 정의됩니다:
{
"name": "로그인 및 데이터 추출",
"steps": [
{"action": "navigate", "url": "https://example.com/login"},
{"action": "fillForm", "fields": {
"#username": "user",
"#password": "pass"
}},
{"action": "submitForm", "selector": "#login-form"},
{"action": "extractContent", "selector": ".data-table"}
]
}
레시피 실행:
await skill.runRecipe('login-and-extract.json');
API 참조
| 메서드 | 설명 |
|---|---|
navigate(url) | 지정된 URL로 이동합니다 |
getTitle() | 현재 페이지의 제목을 반환합니다 |
extractContent(selector?) | 선택자에 해당하는 콘텐츠를 추출합니다 |
fillForm(fields) | 양식 필드를 채웁니다 |
submitForm(selector) | 양식을 제출합니다 |
handlePagination() | 페이지 매김을 처리합니다 |
screenshot(path?) | 스크린샷을 캡처합니다 |
runRecipe(recipePath) | 사이트 레시피를 실행합니다 |
환경 변수
BROWSER_HEADLESS: 헤드리스 모드 활성화 (기본값:true)BROWSER_TIMEOUT: 작업 시간 초과 (밀리초, 기본값:30000)RECIPE_DIR: 레시피 파일 디렉토리 (기본값:./recipes)
라이선스
MIT