노드 사용법 익히기 - Playwright 노드

Playwright 노드는 원격 Playwright 서버(또는 CDP를 지원하는 브라우저)에 접속하여 브라우저를 자동으로 제어하는 노드입니다. 브라우저 자동화를 위한 사용자 정의 Playwright 스크립트를 실행합니다.

웹 요청(Web Request) 노드가 REST API처럼 정형화된 응답을 반환하는 서버와 통신하는 데 적합하다면, Playwright 노드는 API가 제공되지 않는 웹페이지에서 실제 브라우저 동작(페이지 이동, 클릭, 입력, 스크롤, 텍스트·데이터 추출 등)이 필요할 때 사용합니다. 에이전트리아(Agentria)가 브라우저를 직접 실행하는 것이 아니라, 사용자가 미리 준비한 원격 Playwright 서버에 접속해 Python 코드로 브라우저를 제어하는 방식입니다.

노드 추가하기

캔버스에서 +노드 추가(Add Node)를 클릭하고 유틸리티/생산성(Utility/Productivity) 카테고리에서 Playwright 노드를 찾아 배치합니다.

필드 설명

Playwright 노드는 아래 필드·옵션을 제공합니다.

옵션 변수는 노드 편집기의 + 변수 추가 버튼을 눌러 필요한 항목만 체크박스로 활성화합니다.

Playwright 코드 작성하기

노드 편집기의 "원격 Playwright 서버 URL" 필드에 서버 주소를 입력하면, Playwright 코드 영역에서 바로 자동화 로직을 작성할 수 있습니다. 코드는 비동기(Async) Playwright API를 사용하며, browser, context(BrowserContext), page, logger, print가 이미 연결된 상태로 코드 안에 주입되어 있어 별도로 서버에 연결하는 코드를 작성할 필요가 없습니다. 사용 가능한 모듈은 base64이며, return 문으로 반환한 값이 result 변수에 담깁니다.

테스트 및 결과 확인

테스트 실행(RUN TEST) 버튼으로 노드를 테스트해 정상 동작을 확인합니다. 반환값은 result 변수에 담겨 다음 노드로 전달됩니다.