브라우저 에이전트로 디렉터리에 SaaS 출시하기

브라우저 에이전트에 필요한 것

저장소 파일 접근

에이전트는 플랫폼별 플레이북, product.json, identity.json을 읽어야 합니다. 브라우저 도구가 있는 코딩 에이전트는 직접 읽지만, 순수 호스팅형 브라우저 에이전트라면 플랫폼마다 관련 플레이북과 제품 정보를 내가 건네줘야 합니다.

내가 로그인한 브라우저

제출은 내 계정으로 이뤄집니다. 자체 원격 브라우저에서 돌아가는 브라우저 에이전트는 내 계정으로 로그인되어 있지 않고, 인증 코드를 확인하러 내 메일함을 읽을 수도 없습니다. 저장소의 가이드는 내가 볼 수 있는 Chrome을 전제로 합니다.

결과를 기록할 방법

record.py와 로컬 대시보드는 내 컴퓨터에서 도는 Python 스크립트입니다. 브라우저 에이전트가 이를 실행할 수 없다면, 실행이 끝난 뒤 대시보드에서 결과를 하나씩 직접 기록하세요.

런북의 중단 조건

먼저 중복 검색, 플랫폼마다 신원 확인, 구매 금지, CAPTCHA나 애매한 상황에서는 멈춤. 에이전트에 기본으로 들어 있는 기능이 아니라, 에이전트가 실제로 따라야 하는 지침입니다.

브라우저 에이전트를 내 Chrome에 연결하기

BROWSER-SETUP.md는 내가 지켜보는 Chrome에 연결하는 에이전트를 위해 쓰였습니다. 내 브라우저 에이전트가 브라우저 도구를 갖춘 코딩 에이전트라면 가이드를 그대로 적용할 수 있습니다. 평소 쓰는 Chrome(144 이상)에서 자동 연결로 Chrome DevTools MCP를 쓰거나, 로컬 디버깅 포트를 쓰는 전용 Chrome 프로필을 쓰며, 배치마다 오래 유지되는 연결 하나를 둡니다.

자체 원격 브라우저만 제공하는 에이전트는 지원되는 연결 요건을 충족하지 않습니다. 로컬 Chrome으로 Chrome DevTools MCP를 설정하고, 시작하기 전에 눈으로 확인하는 간단한 점검을 하세요.

관련 없는 민감한 탭은 닫고, 해당 제품에 허용된 사이트만 쓰고, 쿠키나 브라우저 프로필은 절대 내보내지 마세요. 도구 호출이 완료됐다는 것은 도구 호출이 끝났다는 뜻일 뿐입니다. 저장됐는지는 페이지를 다시 읽어 확인하세요.

브라우저 에이전트가 브라우저 도구를 갖춘 코딩 에이전트라면, 아래가 BROWSER-SETUP.md의 일반 서버 정의입니다. 에이전트에 따라 다른 파일이나 형식에 둘 수 있으며, 어디에 넣을지는 해당 에이전트의 설정 화면이 정합니다.

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--autoConnect",
        "--no-usage-statistics",
        "--no-performance-crux"
      ]
    }
  }
}

github.com 문서에 나온 형식이며, 2026년 9월 30일에 확인했습니다. ↗

이런 서버를 불러올 수 없는 에이전트는 지원 경로에 해당하지 않습니다. 그래도 붙여 넣은 플레이북으로 양식 하나는 채울 수 있고, 결과는 내가 대시보드에 직접 기록하면 됩니다.

코딩 에이전트를 내 Chrome에 연결하기 →

시작 프롬프트

START.md의 공개 시작 프롬프트를 고치지 않고 그대로 씁니다. 이 프롬프트는 클론한 폴더에서 Python을 실행할 수 있는 에이전트, 보통은 브라우저 도구를 갖춘 코딩 에이전트를 전제로 합니다. 순수 호스팅형 브라우저 에이전트라면 START.md의 “doing it yourself” 명령을 터미널에서 직접 실행하고, 대시보드에서 플랫폼별 프롬프트를 복사해 에이전트에게 건네세요.

Recommend Claude Code CLI or Codex CLI in a terminal instead of the desktop apps for best results. If session metadata confirms desktop hosting, explicitly advise me to switch to the CLI and resume this same private workspace. Do not infer the host from a CLI engine version alone.

Read AGENTS.md, then follow "Start the dashboard for the owner". Create my private
workspace if I do not have one yet, start the dashboard, and give me the link.
Then lead ONBOARDING.md one phase at a time. Reuse recorded permissions instead of
asking again unless their scope is missing or conflicting. Actually test my visible
existing Chrome profile and intended identity as BROWSER-SETUP.md requires; use the
OS fallback if needed. Use one platform/browser worker by default. Build the normal
run only from suitable free-ready routes, keep research separate, and preserve any
draft that needs one exact human CAPTCHA/2FA action. Never claim browser control
bypasses or reduces those challenges.

플레이북과 지침은 코딩 에이전트가 가장 잘 다루는 영어 Markdown으로 되어 있습니다. 제품 문구는 디렉터리가 받는 언어라면 무엇이든 괜찮고, 에이전트는 내 언어로 답합니다.

어느 쪽이든 워크스페이스, product.json, authorizations.json, submissions.json은 내 컴퓨터에 파일로 남고, 대시보드는 무엇이 게시됐는지, 대기 중인지, 예약됐는지, 내 처리를 기다리는지 보여 줍니다.

세 단계로 LaunchRepo 시작하기 →

실행 모습

아래 예시는 홈페이지와 같습니다. 배치 하나에서 각 플랫폼이 실제로 확인된 상태로 끝납니다. 브라우저 에이전트를 쓰면 실행 후 내가 상태를 입력할 수도 있습니다. 어느 쪽이든 상태는 이 페이지가 아니라 트래커에서 옵니다.

브라우저 에이전트가 막혔을 때

브라우저 에이전트는 코딩 에이전트와 다른 방식으로 실패합니다. 배치가 엇나가기 전에 일찍 알아차려야 할 세 가지 상황입니다.

어디에도 로그인되어 있지 않음

에이전트가 자체 원격 브라우저나 관리형 브라우저에서 작업하고 있습니다. 디렉터리 계정과 메일함은 내 Chrome에 있으니, Chrome DevTools MCP로 실행을 그쪽으로 옮기거나 에이전트의 작업을 내가 마무리할 초안으로 여기세요.

사이트가 거부함

어떤 사이트는 내 브라우저에서는 문제없이 열리는데도 호스팅된 브라우저의 자동화 에이전트는 제한합니다. 해당 플랫폼을 내 처리가 필요한 것으로 표시하고, 플레이북을 열어 둔 채 직접 제출하세요.

지난번에 한 일을 잊어버림

브라우저 에이전트는 세션 사이에 기록을 거의 남기지 않습니다. 실행 직후 대시보드에 결과를 하나씩 입력하세요. 그러면 다음 배치는 기억이 아니라 트래커에서 시작합니다.

--autoConnect에서 브라우저 도구가 시간 초과되면 네 가지를 확인하세요. Chrome 144 이상이 이미 실행 중인지, chrome://inspect/#remote-debugging에서 원격 디버깅이 켜져 있는지, Chrome의 연결 요청을 허용했는지, 다른 도구가 같은 브라우저를 잡고 있지 않은지입니다. Chrome DevTools MCP는 열린 탭을 모두 불러오므로 필요 없는 탭은 닫아 두세요.

여전히 내가 할 일

LaunchRepo는 일부러 백그라운드 서비스로 만들지 않았습니다. 아래 순간에는 실행이 멈추고 사람에게 넘기는 인계로 기록되며, 에이전트는 이를 절대 우회하지 않습니다.

CAPTCHA와 봇 확인

어떤 에이전트든 챌린지는 원래 쓰던 창에서 내가 풀어야 합니다. 트래커는 prepared_needs_human으로 기록하며, 어떤 플레이북에도 탐지 회피나 우회 단계는 없습니다.

2FA와 인증 코드

대부분의 디렉터리는 이메일로 확인합니다. 브라우저 에이전트가 내 메일함을 읽을 수 없다면 코드 입력과 확인 클릭은 사람에게 넘기는 인계이며, 자동 접근이 아니라 인계로 기록됩니다.

유료 옵션 권유

유료로만 가능한 경로는 deferred_paid로 기록됩니다. 브라우저 에이전트에게는 구매하지 말라고 알려 줘야 합니다. 플레이북은 모든 플랫폼에서 이를 명시하며, 결정은 언제나 내 몫입니다.

기록과 확인

에이전트가 record.py를 실행할 수 없다면 로컬 대시보드에 결과를 입력하세요. “게시됨”에는 언제나 공개 URL과 내 확인이 필요합니다.

벤치마크도 순위도 없습니다. 브라우저 에이전트의 호환성을 말하는 이유는 위의 두 가지 요건을 충족하기 때문이지, 다른 에이전트와 비교해 측정했기 때문이 아닙니다.

자주 묻는 질문