Playwright 스텔스 검증
이미 가지고 있는 Playwright·Puppeteer 페이지를 그대로 검사해 자동화 브라우저의 지문이 앞뒤가 맞는지 점수로 알려주는 스킬.
개발·코딩중급★ 237⑂ 0AI 점수 9/10마지막 업데이트: 2026. 8. 6.
무엇을 해주나
liarjs를 라이브러리로 써서 테스트 중인Page객체(evaluate만 있으면 됨)를 그대로 검사합니다. 실제 실행 플래그·플러그인·프록시가 적용된 상태를 측정합니다.navigator.webdriver잔존, UA의HeadlessChrome토큰, 메인 스레드와 Web Worker의 신원 불일치, 패치된 API가[native code]를 잃은 문제, WebGL과 WebGPU의 GPU 이름 불일치 등을 체크 ID별로 잡아냅니다.{ score, label, checks[], client, server, meta }형태의 결과를 돌려주어expect(result.score).toBeGreaterThanOrEqual(85)같은 단정문에 바로 쓸 수 있습니다.- 테스트 프로세스 밖에서 이미 돌고 있는 브라우저는 CDP 엔드포인트(
--cdp http://127.0.0.1:9222)로 붙어 검사합니다. - 브라우저를 고치거나 회피 코드를 주입하지 않습니다. 오직 '측정'만 합니다.
이런 분께 추천
- Playwright·Puppeteer·Selenium 기반 E2E/크롤링 하네스를 운영하며 "우리 헤드리스 설정이 정상 브라우저처럼 보이나?"를 추측이 아니라 수치로 확인하고 싶은 분
- 스텔스 플러그인을 적용했는데 실제 효과가 있는지 검증하고 싶은 QA·자동화 엔지니어
- 지문 품질을 회귀 테스트 항목으로 CI에 넣으려는 팀
활용 예시
- 테스트 안에서 단정문 추가:
const result = await checkPage(page);후status === 'bad'인 체크가 0개인지 검사해 스텔스 회귀를 잡습니다. - 외부 브라우저 점검: 로컬 패치를 적용한 Chromium을
--remote-debugging-port=9222로 띄운 뒤npx liarjs@0.3 --cdp http://127.0.0.1:9222로 실제 실행 중인 그 브라우저를 검사합니다. - 폐쇄망 검사: 외부 통신이 금지된 환경에서
--offline으로 JS 계층 32개 체크만 실행해 네트워크 요청 없이 결과를 얻습니다.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/liarjsdev/liarjs-skills/HEAD/skills/playwright-stealth-verify/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 liarjsdev/liarjs-skills 의 skills/playwright-stealth-verify 폴더를 내 ~/.claude/skills/playwright-stealth-verify/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/liarjsdev/liarjs-skills.git /tmp/liarjs-skills && mkdir -p ~/.claude/skills && cp -r /tmp/liarjs-skills/skills/playwright-stealth-verify ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- Node.js 22 이상이 설치되어 있는지 확인합니다 (
node -v). - 스킬 저장소를 클론합니다:
git clone https://github.com/liarjsdev/liarjs-skills.git - 스킬 폴더를 Claude 스킬 경로로 복사합니다:
mkdir -p ~/.claude/skills && cp -r liarjs-skills/skills/playwright-stealth-verify ~/.claude/skills/ - Claude Code를 다시 시작하고 "헤드리스 브라우저 지문 검사해줘"처럼 요청해 스킬이 인식되는지 확인합니다.
- 라이브러리로 쓰려면 테스트 프로젝트에서
npm install --save-dev liarjs를 실행해 버전을 lockfile에 고정합니다. - CLI만 써볼 경우 설치 없이
npx liarjs@0.3으로 임시 프로필 검사를 먼저 돌려봅니다. - 외부 통신을 막아야 하면
--offline을, 자체 수집 서버를 쓰려면--endpoint를 지정합니다.
GitHub에서 원본 보기 ↗라이선스: MIT