Player-YN/BrowserKitten

Paw Work - selection-first web agent for Chrome: select on the live page, describe the outcome, take away an editable office file. BYOK, sandboxed, no server.

소개

PawWork · 爪爪 (저장소 Player-YN/BrowserKitten)는 로그인된 Chrome 브라우저를 프로그래밍 가능한 컴퓨터로 바꿔주는 Chrome MV3 확장 프로그램입니다. 사이드 패널 UI를 추가하여 AI 기반 "에이전트"를 호스팅하며, 이 에이전트는 현재 탭에 명령을 내리고, 페이지 컨텍스트에서 임의의 JavaScript를 실행하며, 세션용 소규모 아티팩트(시트 데이터, HTML 스니펫 등)를 저장할 수 있습니다.

작동 방식

사이드 패널 UI – 사용자가 확장 프로그램의 사이드 패널을 열고 OpenAI 호환 API 키(직접 준비)를 붙여넣은 뒤 작업을 입력합니다.
Service worker – Chrome 확장 프로그램 service worker가 요청을 받아 SessionWorkspaceService라는 off-screen worker로 전달합니다.
Off-screen worker – 이 worker는 핵심 AI SDK 구성 요소인 ToolLoopAgent를 호스팅합니다. 사용자의 요청을 해석하고 호출할 도구를 결정한 뒤 적절한 Chrome API를 호출합니다.
도구 – 에이전트는 다음을 수행할 수 있습니다:
- action – 활성 탭 제어 (클릭, 스크롤, 탐색 등).
- sys – 페이지에서 게스트 JavaScript 실행 (sys.eval) 또는 Chrome DevTools Protocol (sys.cdp)을 통한 상호작용.
- store – 세션 내 소규모 데이터 아티팩트(시트, HTML 스니펫) 보관.
결과 – 에이전트가 사이드 패널에 응답을 반환하며, 모든 부작용(페이지 탐색, DOM 변경, 저장된 데이터)은 Chrome 세션 동안 유지됩니다.

주요 기능

빌드 단계 없음 – 확장 프로그램은 압축 해제된 상태로 제공되며 소스 폴더에서 직접 로드할 수 있습니다.
BYOK (Bring-Your-Own-Key) – 모델 호스팅을 제공하지 않으며, 사용자가 직접 OpenAI 호환 API 키를 제공하여 Chrome 로컬 저장소에 저장합니다.
Chrome MV3 준수 – Chrome 135+에서 작동하며, Chrome 138+에서는 Allow User Scripts를 활성화하여 sys.eval 및 페이지 ID 가져오기를 사용할 수 있습니다.
도구 지향 아키텍처 – UI, service worker, off-screen 워크스페이스, AI 도구 루프가 명확하게 분리되어 있습니다(AGENTS.md 참조).
테스트 – 순수 Node 런타임 회귀 테스트와 실제 확장 프로그램을 로드하는 Playwright 기반 스모크 테스트가 포함되어 있습니다.
패키징 스크립트 – 압축 해제된 확장 프로그램을 배포용으로 zip 파일로 만드는 작은 Python 도우미가 포함되어 있습니다.

권장 사용자

파워 유저：자연어 프롬프트를 사용하여 반복적인 웹 작업(양식 작성, 데이터 추출, 탐색)을 자동화하려는 사용자.
개발자：사용자 지정 스크립트를 작성하지 않고 AI 강화 브라우저 자동화를 실험하려는 개발자.
연구원：실시간 브라우저 환경과 상호작용하는 LLM 기반 에이전트를 연구하는 연구원.

시작하기

저장소를 복제하거나 릴리스 zip 파일을 다운로드합니다.
Chrome에서 chrome://extensions로 이동하여 개발자 모드를 활성화하고 Load unpacked를 클릭한 뒤 manifest.json이 포함된 폴더를 선택합니다.
사이드 패널을 열고 OpenAI API 키를 붙여넣은 뒤 일반 http(s) 페이지에서 작업을 시작합니다.
소스를 수정했다면 확장 프로그램 카드에서 重新加载 (Reload)를 클릭하세요.

제한 사항

일반 웹 페이지에서만 작동하며, Chrome 내부 페이지(chrome://*) 및 Chrome 웹 스토어는 차단됩니다.
Chrome 135+가 필요합니다(고급 사용자 스크립트 기능은 Chrome 138+ 필요).
내장 모델 호스팅이 없으므로 유효한 OpenAI 호환 키가 있어야 합니다.
일부 DevTools 상호작용은 CDP_BUSY 오류를 방지하기 위해 대상 탭에서 DevTools를 닫아야 할 수 있습니다.

라이선스: MIT (LICENSE 참조). 타사 고지: THIRD_PARTY_NOTICES.md에 나열됨.