🤖
Puppeteer
브라우저 제어 브라우저 및 자동화설치 명령어
npx clawhub@latest install puppeteer
설치 안내
1
환경 확인
Node.js 22 이상과 OpenClaw가 설치되어 있는지 확인하세요. 터미널에서 openclaw --version을 실행하여 확인할 수 있습니다.
2
설치 실행
위의 설치 명령어를 터미널에서 실행하세요. ClawHub가 자동으로 Puppeteer을(를) ~/.openclaw/skills/ 디렉토리에 다운로드하고 설치합니다.
3
설치 확인
openclaw skills list를 실행하여 설치된 스킬 목록을 확인하고, Puppeteer이(가) 목록에 표시되는지 확인하세요.
4
매개변수 설정 (선택사항)
아래 소개의 설정 안내에 따라 ~/.config/openclaw/openclaw.json5에 스킬 설정 항목을 추가하세요.
수동 설치 방법: Skill 폴더를
~/.openclaw/skills/ 또는 프로젝트의 skills/ 디렉토리에 복사하세요. 폴더에 SKILL.md 파일이 포함되어 있어야 합니다.
브라우저 스크린샷 및 PDF 생성
JavaScript 콘솔 실행
웹 요소 클릭 및 폼 조작
상세 소개
Puppeteer MCP 서버는 Google의 Puppeteer 라이브러리를 기반으로 Chrome/Chromium 브라우저에 대한 완전한 제어 기능을 제공하며, 스크린샷, 내비게이션, 스크립트 실행 등을 지원하는 브라우저 자동화의 클래식한 솔루션입니다.
핵심 기능
- 페이지 스크린샷(puppeteer_screenshot): 현재 페이지 또는 지정된 요소의 스크린샷을 캡처하며, 전체 페이지 및 특정 영역 스크린샷을 지원하고 base64 이미지 데이터 반환
- 페이지 내비게이션(puppeteer_navigate): 지정된 URL로 이동하며 대기 조건(load/networkidle 등) 설정 지원
- JavaScript 실행(puppeteer_evaluate): 페이지 컨텍스트에서 JavaScript 코드를 실행하고 반환값 획득
- 요소 조작: 클릭(puppeteer_click), 입력란 작성(puppeteer_fill), 드롭다운 메뉴 선택, 페이지 스크롤 등
- PDF 생성: 현재 페이지를 PDF 파일로 내보내기
설정 방법
{
"mcpServers": {
"puppeteer": {
"command": "npx",
"args": ["-y", "@anthropic/puppeteer-mcp"]
// 기본적으로 headless 모드 사용
}
}
}
사용 시나리오
- 웹페이지 스크린샷 서비스: 정기적으로 웹페이지를 캡처하여 보고서 또는 썸네일 생성
- UI 회귀 테스트: 스크린샷 비교를 통한 페이지 시각적 변화 감지
- 자동화 조작: 웹사이트 로그인, 폼 작성, 파일 다운로드
- 데이터 스크래핑: JavaScript 렌더링이 필요한 동적 페이지에서 콘텐츠 추출