outcrawlai/scout
Scout: the open-source browser agent, by Outcrawl. Mirrored automatically from Outcrawl's own repository.
Outcrawl의 Scout – 오픈소스 브라우저 에이전트
개요
- TypeScript/Node 라이브러리(
@outcrawl/scout)로, 일반 영어로 웹 작업을 설명할 수 있습니다. Scout는 실제 Chrome/Chromium 브라우저를 구동하여 클릭, 입력, 스크롤, 정보 추출을 수행하고 답변(또는 부분 결과)과 재생 링크를 반환합니다. - 핵심 아이디어는 각 브라우저 동작을 결정하는 실습형 AI 모델이며, 필요에 따라 계획 모델(브레인)과 비전 모델(아이즈)이 보조합니다. 라이브러리 자체에는 모델이 포함되어 있지 않으며, 표준 채팅 완성 API(OpenAI, Anthropic, 로컬 LLM 등)를 구현한 모든 서비스를 플러그인할 수 있습니다.
시작하기
- npm 패키지를 설치합니다(Node 22+).
npm i @outcrawl/scout - 환경 변수를 설정합니다:
OUTCRAWL_API_KEY– 무료 Outcrawl 브라우저 키(월 1,000 크레딧).SCOUT_BASE_URL,SCOUT_API_KEY,SCOUT_HANDS_MODEL– 핸즈 작업에 사용할 LLM을 지정합니다.
Scout인스턴스를 생성하고run('자연어 작업')을 호출하는 짧은 스크립트를 작성합니다.
README의 예제는 Hacker News 상위 3개 기사를 가져오는 한 줄짜리 코드를 보여줍니다.
실행 위치
- Outcrawl 클라우드(권장): 라이브러리가 원격 브라우저에 연결되어 주거용 IP에서 오는 것처럼 보이고, 캡차를 해결하며, 모든 단계를 기록합니다. API 키만 필요하며 로컬 브라우저 설치가 필요 없습니다.
- 로컬 머신: Playwright의 Chromium을 설치하고(
npm i playwright-core && npx playwright install chromium),browser: { launch: {} }를 설정합니다. CDP를 통해 기존 Chrome에 연결할 수도 있습니다.
실행할 수 있는 작업
- 리서치(예: 상위 뉴스 항목 스크래핑).
- 양식 작성(예: 피자 주문 및 주문 확인 보고).
- 페이지 간 항목 비교.
- 사이트에 로그인하고 보호된 메시지 읽기.
- 브라우저에서 일반적으로 수동으로 수행하는 모든 작업을 자연어 지시로 표현합니다.
모델 아키텍처
| 작업 | 역할 |
|---|---|
hands |
페이지를 읽고 다음 저수준 동작(클릭, 입력, 스크롤)을 결정합니다. 매 단계마다 실행되므로 빠른 모델이 필요합니다. |
brain |
페이지의 전체 순서를 계획하는 고수준 플래너. 긴 다중 페이지 작업에 유용합니다(선택 사항). |
eyes |
시각적 단서가 필요할 때 스크린샷을 해석할 수 있는 비전 모델. |
extract |
구조화 추출 모델. 생략하면 hands가 일반 텍스트 추출로 대체됩니다. |
각 작업에 대해 별도의 모델 구성을 제공하며, 모두 동일한 채팅 완성 API 형식을 사용합니다.
출력
result 객체에는 다음이 포함됩니다:
status(completed,partial,capped,failed).data– 답변(제공한 JSON 스키마로 형태가 지정될 수 있음).error– 얻을 수 없었던 내용에 대한 설명.steps– 모든 브라우저 상호작용의 타임라인.costUsd– 모델 호출 비용(알려진 경우).replayUrl– 실행의 단계별 비디오 링크(클라우드 전용).
성능 주장 Outcrawl 클라우드 버전은 Browser Use 80개 사이트 벤치마크(2026년 10월)에서 92.5% 성공률을 달성하여, 차점 오픈소스 솔루션(81.4%)을 능가했습니다.
리포지토리 구조
packages/scout– 공개 API(new Scout(...).run).packages/runtime– 페이지를 반복적으로 관찰하고, 모델을 호출하고, 작업을 실행하는 에이전트 루프.packages/model– 프롬프트 템플릿, 작업 분할, 공급자 비종속 클라이언트 코드.packages/scout-cdp– 탐색 및 상호작용을 위한 Chrome DevTools Protocol의 얇은 래퍼.packages/agenthands– 로컬 전용 입력 계획 유틸리티(MIT 라이선스).
대상
- 브라우저 자동화 스택을 처음부터 구축하지 않고 프로그래밍 가능한 웹 에이전트가 필요한 개발자.
- 실제 브라우저 충실도(캡차, 동적 JS 등)를 요구하는 LLM 기반 에이전트를 실험하는 연구자.
- 관리형 클라우드 브라우저에서 작업을 실행하여 안티봇 차단을 피하려는 팀.
라이선스
주요 코드는 Apache-2.0, agenthands 하위 패키지는 MIT.
위의 모든 정보는 리포지토리 README에서 직접 가져온 것이며, 추가 기능은 추론되지 않았습니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트