Communitygithub.com

Bovidtiberius960/CloakBrowser

커스텀 Chromium 빌드로 C++ 소스 수준의 핑거프린트 조작을 통해 봇 탐지를 우회합니다. Playwright 및 Puppeteer의 드롭인 대체 도구입니다.

CloakBrowser란 무엇인가요?

이 스킬은 웹 스크래핑 및 브라우저 자동화 도구가 봇 탐지 시스템을 우회할 수 있도록 도와줍니다. C++ 소스 코드 수준에서 Chromium의 핑거프린트를 수정한 커스텀 빌드를 사용하여, 일반적인 자동화 도구가 감지되는 것을 방지합니다. Playwright와 Puppeteer에 대한 드롭인(drop-in) 대체 역할을 하므로, 기존 코드베이스를 최소한으로 변경하여 적용할 수 있습니다. 개발자와 AI 에이전트 사용자는 복잡한 설정 없이도 더 안정적으로 브라우저 자동화를 수행할 수 있으며, 사이트 차단 위험을 줄일 수 있습니다. macOS 및 Linux 환경을 지원하며, 환경 변수 설정과 Docker 이미지 사용을 통해 쉽게 배포할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add Bovidtiberius960/CloakBrowser

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

CloakBrowser은(는) 무엇을 하나요?

봇 탐지를 우회하기 위해 C++ 소스 수준의 핑거프린트 수정이 포함된 커스텀 Chromium 빌드입니다. Playwright 및 Puppeteer의 드롭인(drop-in) 대체 도구입니다.

사용 방법

1. 설치

다음 명령어로 CloakBrowser와 해당 패키지를 설치합니다:

npm install @cloakbrowser/playwright
# 또는
npm install @cloakbrowser/puppeteer

2. Playwright와 함께 사용

const { chromium } = require('@cloakbrowser/playwright');

(async () => {
  const browser = await chromium.launch();
  const page = await browser.newPage();
  await page.goto('https://example.com');
  console.log(await page.title());
  await browser.close();
})();

3. Puppeteer와 함께 사용

const puppeteer = require('@cloakbrowser/puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.goto('https://example.com');
  console.log(await page.title());
  await browser.close();
})();

설정

환경 변수를 통해 핑거프린트 수정을 구성할 수 있습니다:

  • CLOAK_USER_AGENT: 사용자 에이전트 문자열 설정
  • CLOAK_VIEWPORT: 뷰포트 크기 설정 (예: 1920x1080)
  • CLOAK_LOCALE: 로케일 설정 (예: en-US)
  • CLOAK_TIMEZONE: 시간대 설정 (예: America/New_York)

지원되는 플랫폼

  • macOS (Intel 및 Apple Silicon)
  • Linux (x64 및 arm64)
  • Windows는 아직 지원되지 않습니다.

Docker 사용

Docker 이미지도 사용할 수 있습니다:

docker pull bovidtiberius960/cloakbrowser:latest

라이선스

MIT

관련 스킬