통과했다고 말하는 대신,
통과한 증거를 남깁니다
It doesn't tell you it passed.
It hands you the proof.
브라우저 QA 도구입니다. 사이트를 평소처럼 클릭하면 시나리오가 기록되고, 그 시나리오를 매번 같은 순서로 다시 돌립니다. 끝나면 단계마다 화면, 그 화면이 부른 API와 응답, 그리고 그 사이에 난 오류가 담긴 리포트 하나가 남습니다. 개발자가 아니어도 씁니다.
A browser QA tool. Click through your site the way you normally would and it records a scenario; it then replays that scenario the same way every time. What you get back is one report: the screen at every step, the APIs that screen called and what they returned, and every error in between. You do not need to be a developer to use it.
한 번 돌리면 무엇이 남나
What one run leaves behind
산출물Artifacts단계별 화면과 판정
A screen and a verdict per step
단계마다 스크린샷 한 장과 성공·실패 표시가 붙은 HTML 리포트. 링크 하나로 누구에게든 그대로 보냅니다.
One HTML report with a screenshot and a pass or fail mark for every step. Send the link to anyone as it is.
화면이 부른 API와 응답 본문
The APIs the screen called, and what came back
요청 URL과 상태코드만이 아니라 응답 본문까지 남깁니다. "화면은 멀쩡한데 값이 틀리다"를 프런트 문제인지 서버 문제인지 가릅니다.
Not just the URL and the status code but the response body. That is what settles "the screen looks fine but the number is wrong" as a frontend problem or a server one.
시나리오 밖에서 난 일
Everything that happened outside the script
콘솔 오류, 처리 안 된 JS 예외, 실패한 요청, HTTP 4xx·5xx, 예상 못 한 팝업과 새 탭. 같은 것은 횟수로 묶고, 직전 실행에 없던 유형은 회귀 신호로 표시합니다.
Console errors, unhandled JS exceptions, failed requests, HTTP 4xx and 5xx, popups and tabs nobody expected. Repeats collapse into counts, and any type that was not in the previous run is flagged as a regression signal.
실패한 순간의 되감기
A rewind of the moment it broke
실패한 실행은 trace로 남아 그 시점을 다시 열어볼 수 있습니다. 기준 화면을 정해두면 매 실행 스크린샷을 픽셀 비교해 레이아웃 변화를 붉은 diff로 보여줍니다.
A failed run keeps a trace you can reopen at that exact point. Adopt a baseline screenshot and every later run is compared pixel by pixel, with layout drift shown as a red diff.
쓰는 방법은 세 가지
Three ways in
사용법Usage클릭해서 기록하기
Record it by clicking
실제 크롬 창이 열리고, 사이트를 평소처럼 씁니다. 화면 구석 패널에서 잠시 멈추거나 확인할 내용을 덧붙이고 저장하면 끝. 입력한 비밀번호는 평문이 아니라 {{password}}로 저장됩니다.
A real Chrome window opens and you use the site as usual. A small panel lets you pause, add something to check, and save. A password you type is stored as {{password}}, never as plain text.
에이전트에게 맡기기
Hand it to an agent
"이 사이트 QA해줘" 한 줄이면 됩니다. 에이전트가 사이트를 돌아다니며 메뉴·로그인·팝업을 파악하고, 해피패스와 오류 경로 시나리오를 직접 써서 돌린 뒤, 결과를 우리말로 정리해 리포트 경로와 함께 보고합니다.
One line — "QA this site" — is enough. The agent explores it, maps the menus, login and popups, writes happy-path and error-path scenarios itself, runs them, then reports back in your language with the report path.
CLI와 CI
CLI and CI
저장된 시나리오 전체를 헤드리스로 돌리고 종료 코드로 파이프라인을 막습니다. 같은 시나리오를 스테이징이나 로컬 스택으로 돌릴 때는 주소만 바꿔 넘깁니다.
Run every saved scenario headless and gate the pipeline on the exit code. Point the same scenarios at staging or a local stack by passing a different base URL.
두 가지는 양보하지 않습니다
Two things it will not trade away
원칙Principles사이트 정보는 로컬에만
Site knowledge stays on your machine
진입 주소, 계정, 로그인 요령, 시나리오는 전부 ~/.superqa/에 있습니다. 저장소에는 어떤 사이트 정보도 올라가지 않습니다.
Entry URLs, accounts, login quirks and scenarios all live under ~/.superqa/. No site data is ever committed to the repository.
비밀값은 자동 가려짐
Secrets mask themselves
아이디와 비밀번호는 한 번만 저장하고 시나리오에서는 이름으로만 참조합니다. 비밀값처럼 보이는 키는 모든 리포트와 오류 메시지에서 자동으로 가려집니다.
Store a username and password once and scenarios reference them by name. Anything that looks like a secret is masked in every report and error message automatically.
브라우저는 목적에 맞게
The browser is chosen for the job
기본은 agent-browser입니다. 팝업과 새 창을 따라가고 API 응답 본문까지 남기며 macOS·Linux·Windows에서 그대로 돕니다. 깊은 네트워크 추적이 필요하면 Chrome DevTools로 넘어갑니다.
agent-browser by default: it follows popups and new windows, keeps API response bodies, and runs natively on macOS, Linux and Windows. For deeper network work it hands over to Chrome DevTools.
설치
Install
MIT · GITHUB.COM/CSKWORK/BROWSER-QA# Claude Code 플러그인으로 claude plugin marketplace add cskwork/browser-qa claude plugin install browser-qa@browser-qa # 새 세션에서 /browser-qa # 또는 직접 받아서 git clone https://github.com/cskwork/browser-qa ~/.claude/skills/browser-qa pip3 install textual playwright pyyaml python3 -m playwright install chromium # 실행 — 웹 대시보드에서 버튼으로 돌리기 python3 -m superqa_tui serve # 또는 터미널 TUI bash ~/.claude/skills/browser-qa/scripts/superqa.sh
# As a Claude Code plugin claude plugin marketplace add cskwork/browser-qa claude plugin install browser-qa@browser-qa # then type /browser-qa in a new session # Or clone it yourself git clone https://github.com/cskwork/browser-qa ~/.claude/skills/browser-qa pip3 install textual playwright pyyaml python3 -m playwright install chromium # Run it — web dashboard, click to execute python3 -m superqa_tui serve # or the terminal TUI bash ~/.claude/skills/browser-qa/scripts/superqa.sh