브라우저 CDP 자동화
Chrome DevTools Protocol로 이미 로그인된 Chrome을 그대로 재사용해 페이지 열기·JS 실행·요소 클릭·토큰 추출까지 자동화하는 스킬.
자동화·워크플로중급★ 7,057⑂ 1,003AI 점수 9/10마지막 업데이트: 2026. 9. 22.
무엇을 해주나
- Chrome을 디버그 모드(포트 9222)로 띄우고 기존 로그인 세션(프로필)을 복사해 재사용합니다. 로그인 자동화를 다시 만들 필요가 없습니다.
agent-browser --cdp 9222명령으로 URL 열기, 로딩 대기,eval로 JS 실행,snapshot -i로 상호작용 요소 목록 확보,click/type조작을 수행합니다.- 페이지 본문 텍스트 추출,
localStorage/쿠키에서 인증 토큰 꺼내기 같은 실무 패턴을 그대로 제공합니다. - 따옴표·백틱이 섞인 복잡한 JS는 base64(
eval -b) 또는 heredoc(--stdin) 방식으로 셸 이스케이프 문제를 우회합니다. - 안전 절차 내장: 먼저
--detect-only로 상태만 확인하고, 실행 중인 Chrome이 있으면 사용자 동의를 받은 뒤에만--yes로 재시작합니다. 종료 시에도 debug 프로필 PID만 골라 끄도록 안내합니다.
이런 분께 추천
- 로그인이 필요한 사내 시스템·SaaS 대시보드에서 데이터를 반복 수집해야 하는 실무자
- API 문서가 없어 브라우저 세션 토큰을 얻어 요청을 재현해야 하는 개발자
- Playwright 새 세션 로그인 대신, 평소 쓰는 Chrome 로그인 상태를 그대로 활용하고 싶은 분
활용 예시
- "로그인된 관리자 페이지 열어서 본문 텍스트 8000자만 뽑아줘" →
open→wait 3000→eval 'document.body.innerText.substring(0,8000)' - "이 서비스의 API 토큰 좀 꺼내줘" →
eval 'localStorage.getItem("token") || document.cookie' - "순위 페이지 여러 장 넘겨가며 목록 수집" →
snapshot -i로 다음 페이지 버튼 참조 확보 후click, 페이지마다timeout 30으로 감싸 세션 멈춤 방지
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/worldwonderer/oh-story-claudecode/HEAD/skills/browser-cdp/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 worldwonderer/oh-story-claudecode 의 skills/browser-cdp 폴더를 내 ~/.claude/skills/browser-cdp/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/worldwonderer/oh-story-claudecode.git /tmp/oh-story-claudecode && mkdir -p ~/.claude/skills && cp -r /tmp/oh-story-claudecode/skills/browser-cdp ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 사전 준비: Google Chrome, Node.js 20 이상이 설치되어 있는지 확인합니다(
node -v). - 필수 CLI 설치: 터미널에서
npm install -g agent-browser를 실행합니다. - 스킬 폴더 준비:
mkdir -p ~/.claude/skills - 저장소를 내려받습니다:
git clone https://github.com/worldwonderer/oh-story-claudecode.git /tmp/oh-story-claudecode - 스킬만 복사합니다:
cp -r /tmp/oh-story-claudecode/skills/browser-cdp ~/.claude/skills/ - Claude Code를 재시작하고 "CDP로 브라우저 자동화해줘"처럼 요청하면 스킬이 발동합니다.
- 첫 실행 시 실행 중인 일반 Chrome이 종료될 수 있으므로, 저장하지 않은 탭·작성 중인 글을 먼저 저장하고 동의하세요.
GitHub에서 원본 보기 ↗라이선스: MIT