클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
 
← 목록으로

agent-browser 브라우저 자동화 가이드

접근성 트리 스냅샷과 @eN 참조를 이용해 클로드가 실제 웹사이트를 열고 클릭·입력·추출·캡처하도록 만드는 브라우저 자동화 스킬.

자동화·워크플로중급★ 1,161⑂ 109AI 점수 10/10마지막 업데이트: 2026. 9. 29.

무엇을 해주나

  • agent-browser CLI를 이용한 브라우저 자동화의 표준 작업 루프(열기 → 스냅샷 → 조작 → 재스냅샷)를 클로드에게 학습시킵니다.
  • HTML 원문을 파싱하지 않고 접근성 트리 스냅샷의 @e1, @e2 같은 짧은 참조만으로 요소를 다루므로 토큰 소모가 매우 적습니다.
  • 페이지 읽기(read, get text), 클릭·입력·선택·업로드·드래그, 스크린샷/전체 페이지 캡처/주석 캡처, 탭 관리, iframe, 다이얼로그 처리를 모두 다룹니다.
  • 로그인 자동화(auth 저장소, 자격증명 플러그인), 세션 상태 저장·복원, 여러 브라우저 세션 병렬 실행 방법을 안내합니다.
  • 네트워크 요청 목킹/HAR 기록, 동작 영상 녹화, 접근성(axe-core) 감사, React 컴포넌트 트리·리렌더 프로파일·Web Vitals 측정까지 포함합니다.
  • 대기(wait) 전략과 "ref not found", 오버레이로 클릭 실패, 입력 이벤트 무시, 크로스오리진 iframe 등 실전 실패 사례별 해결법을 제시합니다.

이런 분께 추천

  • 웹 앱을 반복 테스트하거나 QA 시나리오를 자동화해야 하는 개발자·QA 엔지니어
  • 로그인이 필요한 사이트에서 데이터를 뽑아야 하는 데이터 담당자
  • UI 변경 후 스크린샷을 자동으로 모으고 싶은 프론트엔드 개발자
  • React 앱의 불필요한 리렌더나 Web Vitals를 점검하고 싶은 분

활용 예시

  1. "이 사이트에 로그인해서 대시보드 스크린샷 찍어줘" → 스냅샷으로 입력창 참조를 찾아 아이디·비밀번호를 채우고 wait --url "**/dashboard" 후 캡처.
  2. "상품 표를 JSON으로 정리해줘" → eval --stdin 히어독으로 테이블 행을 순회해 이름·가격 배열로 추출.
  3. "두 계정으로 동시에 채팅 기능을 테스트해줘" → --session a, --session b로 쿠키가 분리된 두 브라우저를 병렬 운용.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/fcakyon/claude-codex-settings/HEAD/plugins/agent-browser/skills/agent-browser/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 fcakyon/claude-codex-settings 의 plugins/agent-browser/skills/agent-browser 폴더를 내 ~/.claude/skills/fcakyon-agent-browser/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/fcakyon/claude-codex-settings.git /tmp/claude-codex-settings && mkdir -p ~/.claude/skills && cp -r /tmp/claude-codex-settings/plugins/agent-browser/skills/agent-browser ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. Node.js가 설치되어 있는지 확인합니다(node -v).
  2. CLI를 전역 설치하고 브라우저를 내려받습니다: npm i -g agent-browser && agent-browser install (리눅스라면 agent-browser install --with-deps).
  3. 스킬 저장소를 클론합니다: git clone https://github.com/fcakyon/claude-codex-settings.git
  4. 스킬 폴더를 복사합니다: mkdir -p ~/.claude/skills && cp -r claude-codex-settings/plugins/agent-browser/skills/agent-browser ~/.claude/skills/
  5. agent-browser doctor를 실행해 Chrome·데몬 상태가 정상인지 점검합니다(영상 녹화를 쓸 계획이면 ffmpeg도 설치).
  6. Claude Code를 재시작한 뒤 "example.com 열어서 스크린샷 찍어줘"처럼 요청해 스킬이 발동하는지 확인합니다.
  7. 작업이 끝나면 agent-browser close로 브라우저를 정리하세요.
GitHub에서 원본 보기 ↗라이선스: Apache-2.0