Browserbase와 Browserless: 보고서 다운로드가 끊긴 뒤 로그인, 세션, 파일을 어떻게 인계할까

Browserbase는 관리형 파일 인계와 원인 분석을 중시하는 순차 작업에 적합하다. Browserless는 짧은 재연결, 영속 세션, 로그인 스냅샷 등 다른 경로를 제공한다. 로그인 저장이나 세션 재생을 실행 복구로 보지 말고 연결 복구, 인증 만료, 중복 내보내기를 검증해야 한다.

출처: docs.browserbase.com
2026년 11월 16일
13 min

운영 담당자가 접근 권한이 있는 공급자 포털에서 일일 보고서를 내보내는데 스크립트가 ‘보고서 생성’을 누른 뒤 끊겼다. 인계받는 사람은 원래 페이지로 다시 연결할 수 있는지, 내일 다시 로그인해야 하는지, 파일 다운로드가 실제로 성공했는지 알아야 한다. Browserbase와 Browserless 모두 원격 브라우저 인프라를 제공하지만 이는 각각 실행 중인 세션, 영속 로그인 정보, 업무 작업 기록의 문제다.

Context, 클라우드 다운로드, 시각적 문제 분석을 하나의 관리형 절차에 넣으려면 Browserbase를 우선 평가하자. 기존 Puppeteer나 Playwright 워크플로가 있고 짧은 재연결, 실행 간 상태, 독립 로그인 스냅샷을 명확히 선택해야 한다면 Browserless는 더 세분된 경로를 제공하지만 팀이 인터페이스를 구분해야 한다. 자체 소유 또는 허가받은 포털의 일반 보고서 다운로드만 다룬다. 접근 제한 우회나 인증 문제 자동 해결은 다루지 않으며 실제 로그인·다운로드 테스트는 하지 않았다.

내일 다시 실행하려면 무엇을 저장할까

Browserbase의 Contexts는 Chromium 사용자 데이터 디렉터리의 로그인·앱 정보를 저장하며 cookies, localStorage, IndexedDB를 포함한다. 새 세션에는 Context ID를 전달해야 한다. 변경 사항을 기록하려면 생성 시 persist: true로 설정하고 세션 종료 시 데이터가 저장되므로 재사용 전 몇 초간 동기화를 기다려야 한다. 공식 권고는 한 사이트의 한 로그인에 독립 Context를 써서 같은 Context를 동시에 사용하다 로그아웃되는 일을 피하는 것이다.

따라서 인계표에는 Context ID와 session ID를 따로 기록해야 한다. 전자는 새 브라우저가 정보를 로드하는 데, 후자는 한 번의 실행을 찾는 데 쓰인다. 프레임워크의 BrowserContext 객체, 영속 정보, 실행 중인 브라우저를 같은 것으로 보지 말자. Context가 있다고 로그인이 유효한 것은 아니다. 포털은 cookie를 만료시키거나 토큰을 취소하거나 재인증을 요구할 수 있다. MFA를 한 번 통과했다고 영구적으로 인증이 면제되는 것은 아니다.

Browserless의 현재 v2 문서에 있는 Session API는 cookies, localStorage, 캐시를 브라우저 재시작 후에도 유지할 수 있다. ttl은 정보 수명을 제어한다. 기본값 processKeepAlive: 0에서는 끊긴 뒤 다시 연결하면 새 프로세스와 빈 페이지가 열려 다시 탐색해야 한다. 유예 기간이 있고 프로세스가 살아 있을 때만 열린 페이지 등의 현장을 보존하며 이 프로세스 유지 기능은 Puppeteer에 한정된다. 영속 세션은 동시에 클라이언트 하나만 연결할 수 있어 여러 사람의 공유 작업대로 볼 수 없다.

다른 선택지는 Authenticated Profiles다. cookies, localStorage, IndexedDB 스냅샷을 저장하고 각 세션에 독립 복사본을 로드하며 sessionStorage는 저장하지 않는다. 실행 중 변경은 원래 profile을 자동 수정하지 않는다. 여러 허가된 작업이 로그인 시작점을 재사용하는 데 적합하며 같은 보고서 페이지를 공유하는 것은 아니다. 로그인 갱신 후 누가 스냅샷을 업데이트할지 미리 정해야 한다.

몇 분 뒤 돌아올 때 어느 브라우저를 살려 둘까

Browserbase의 keepAlive는 끊긴 뒤에도 같은 세션이 연결을 기다리게 하며 유료 요금제에서만 제공된다. 작업 종료 시 명시적으로 해제해야 한다. 그렇지 않으면 시간 초과까지 계속 실행되어 유휴 브라우저 사용량이 발생한다. 이는 짧은 인계를 해결하며 Context의 세션 간 저장을 대체하지 않는다.

Browserless의 Standard Sessions는 먼저 재연결 엔드포인트를 얻고 연결을 끊어야 하며 현재 전용 문서는 이 경로를 Puppeteer로 한정한다. 대기 시간도 최초 시작부터 계산하는 요금제 최대 세션 시간의 제약을 받으므로 반복 재연결로 무한 연장할 수 없다. 재연결마다 새 연결로 과금되고 대기 중에도 동시 실행 슬롯을 차지한다. Playwright 팀은 영속 상태 문서에 따라 설계해야 하며 Puppeteer의 연결 해제 의미를 그대로 옮겨서는 안 된다.

교대 계획에서는 사람이 브라우저를 기다리는지 브라우저가 사람을 기다리는지도 구분해야 한다. 보고서 생성 대기라면 짧게 세션을 유지할 수 있지만 다음 날 처리하려면 필요한 정보와 업무 체크포인트 저장을 우선하자. 그렇지 않으면 유휴 연결이 자원을 차지하고 교대자가 만료된 주소를 받을 수 있다. 작업 스케줄러가 유효 기간과 정리 책임을 기록해야 하며 재생 스크린샷 한 장에 맡길 수는 없다.

이는 두 교대 스크립트의 역할도 정한다. 짧은 네트워크 중단은 유효한 세션에 재연결을 시도할 수 있다. 브라우저가 끝났다면 업무 체크포인트를 읽고 보고서 목록을 다시 열어야지 무작정 ‘생성’을 다시 눌러서는 안 된다. 두 제품 모두 브라우저 재연결만으로 업무 시스템의 정확히 한 번 실행을 보장할 수 없다.

재생은 실패 설명을 돕지만 결과물은 파일이다

Browserbase의 다운로드 문서는 파일을 클라우드에 저장한 뒤 API로 가져오며 이름에 타임스탬프를 붙여 충돌을 줄인다고 설명한다. 스크립트가 클릭 한 번을 기록하는 것으로는 부족하고 가져온 파일의 보고서 날짜, 크기, 내용도 확인해야 한다. Browserless의 파일 전송 문서는 다운로드 이벤트를 켜고 파일 바이트를 받는 CDP 경로와 Playwright 기본 연결의 Download.saveAs를 보여 준다. 리스너는 다운로드를 유발하기 전에 등록해야 한다. 연결 방식을 선택할 때부터 파일이 팀 소유 저장소로 어떻게 들어갈지 확인해야 한다.

Browserbase의 현재 세션 재생은 탭별 HLS 재생과 녹화 다운로드를 지원한다. Browserless의 Session Replay는 replay=true로 켜고 DOM 변경 등의 이벤트를 기록하며 WebM을 반환하는 화면 녹화와 다르다. 둘 다 날짜를 잘못 골랐거나 어느 단계에서 멈췄는지 파악하는 데 도움이 되지만 기록을 본다고 사라진 프로세스가 복구되거나 다운로드가 자동 재전송되지는 않는다.

인계 시 작업 번호, 보고서 범위, 내보내기 상태, 파일 검증 결과, 세션 기록을 연결해야 한다. 재생에는 업무 페이지 정보가 들어갈 수 있고 로그인 정보는 계정 접근 가치가 있으므로 열람 범위와 보존 기간을 제한해야 한다. 토큰이 든 연결 주소를 일반 티켓에 붙이지 말자.

인계를 검증한 뒤 배포 방식을 정하자

같은 허가된 계정으로 연속 3일의 일일 보고서를 다운로드하는 가상 검증을 할 수 있다. 첫날은 ‘생성’을 누른 뒤 중단하고 교대 스크립트가 포털의 내보내기 기록부터 확인한다. 둘째 날은 브라우저를 종료한 뒤 영속 정보를 로드해 올바른 계정인지 확인하고 다시 탐색한다. 셋째 날은 로그인을 의도적으로 만료시켜 무한 재시도가 아니라 작업을 멈추고 계정 소유자에게 인증을 맡기는지 확인한다. 매일 파일 날짜, 비어 있지 않은 내용, 작업 번호를 확인하며 반복 실행에서는 기존 내보내기 기록과 파일 검증으로 중복을 제거한다. 이는 검증 설계이지 완료한 신뢰도 테스트가 아니다.

자동화 계층과 인프라도 구분해야 한다. Stagehand는 자연어 조작, 추출, 프로그래밍 제어 인터페이스를 제공하지만 Browserbase 서비스 전체는 아니다. 이를 선택한다고 세션, 파일, 재실행 책임이 자동 해결되지 않는다. 안정된 선택자가 있는 다운로드 스크립트를 클라우드 브라우저 구매 때문에 AI 에이전트로 다시 쓸 필요는 없다.

Browserless의 자체 호스팅 설명은 기본 Docker 이미지와 Enterprise 기능을 나눈다. 클라우드 재생, BrowserQL 등을 무료 이미지에 전부 기본 제공된다고 보아서는 안 된다. 저장소 LICENSE는 SSPL 또는 상용 라이선스를 채택하고 폐쇄형 상용 앱과 지속적 통합의 상용 라이선스 요구를 명시한다. 자체 호스팅 평가에는 브라우저 업그레이드, 용량, 저장소, 보안 유지보수도 넣어야 하며 클라우드 청구액과 서버 한 대 가격만 비교해서는 안 된다.

결국 단일 계정 순차 다운로드에서 관리형 파일 인계와 문제 분석을 중시하는 팀은 Browserbase부터 검증할 수 있다. 기존 클라이언트 재사용, profile과 영속 세션 세분화가 필요하거나 실제 자체 호스팅 능력이 있는 팀은 Browserless부터 검증할 수 있다. 포털에 허가된 보고서 API나 예약 전달이 이미 있다면 페이지 상태에 덜 의존하는 그 경로부터 평가하자. 선택의 합격 기준은 끊김, 만료, 반복 실행 뒤에도 각 파일의 출처를 설명할 수 있는지다.

콘텐츠 안내:이 글은 공개 자료를 바탕으로 정리한 도구 선택 참고 자료입니다. 제품 기능, 가격 및 관련 정책은 수시로 변경될 수 있으니 최신 공식 정보를 확인해 주세요.

원문 출처:docs.browserbase.com