핑거프린트를 생성하고, 주입하고, 자연스럽게 섞이세요.
간단한 REST 호출로 일관된 실제 브라우저 핑거프린트를 요청한 다음, 그 필드를 Playwright, Puppeteer 또는 Selenium에 적용하여 자동화가 그럴듯하고 일관된 하나의 기기로 보고되도록 하세요.
1. 시작하기
대시보드에서 API 키를 받은 다음 핑거프린트를 요청하세요. /generate는 고유한 새 신원을 합성하고, /random은 풀에 있는 실제 신원을 반환합니다.
# Generate a fresh, coherent fingerprint (quota deducts on success)
curl "https://api.capzy.ai/fingerprint/generate?key=YOUR_API_KEY&format=chromium&tags=Windows&country=us"- tags(Windows, macOS, Linux, Android, iOS)와 country(ISO alpha-2)로 필터링하세요.
- format=chromium은 바로 주입 가능한 필드를, format=raw는 전체 데이터를 반환합니다.
- 할당량은 생성에 성공한 경우에만 차감됩니다.
2. 자동화에 적용하기
브라우저에 기기 수준 필드(userAgent, viewport, locale, timezone)를 설정한 다음, 페이지 스크립트가 실행되기 전에 JS에서 보이는 navigator를 같은 기기에 맞추세요.
import requests
from playwright.sync_api import sync_playwright
# 1. Generate a coherent fingerprint for a Windows visitor in the US
fp = requests.get("https://api.capzy.ai/fingerprint/generate", params={
"key": "YOUR_API_KEY",
"format": "chromium", # injection-ready
"tags": "Windows",
"country": "us",
}).json()
rect = fp["screen"]["screenRect"]
with sync_playwright() as p:
browser = p.chromium.launch()
# 2. Apply the machine-level fields on the context
context = browser.new_context(
user_agent=fp["userAgent"]["userAgent"],
locale=fp["intl"]["languages"][0],
timezone_id=fp["intl"]["timeZone"],
viewport={"width": rect["width"], "height": rect["height"]},
device_scale_factor=fp["screen"]["deviceScaleFactor"],
)
# 3. Match the JS-visible navigator to the SAME machine (before page scripts)
context.add_init_script(f"""
Object.defineProperty(navigator, 'hardwareConcurrency', {{ get: () => {fp['navigator']['hardwareConcurrency']} }});
Object.defineProperty(navigator, 'deviceMemory', {{ get: () => {fp['navigator']['deviceMemory']} }});
Object.defineProperty(navigator, 'platform', {{ get: () => '{fp['userAgent']['platform']}' }});
""")
page = context.new_page()
page.goto("https://example.com")
print(page.title())
browser.close()Firefox와 Safari 핑거프린트도 같은 방식으로 작동합니다. Chromium에 있는 기능 필드(deviceMemory, hardwareConcurrency, 클라이언트 힌트)는 실제 브라우저가 노출하지 않는 경우 생략됩니다.
3. 응답 형식
chromium 바로 주입 가능
브라우저에 설정하는 필드 그대로: userAgent, screen, intl, navigator, webgl. 위의 예제에 사용하세요.
raw 전체 데이터
저장하거나 자체 인젝터에 사용할 수 있는 전체 핑거프린트 페이로드(canvas, fonts, visitor_id, webgl_properties).
4. 일관성 유지하기
핑거프린트는 무작위 필드의 모음이 아니라 그럴듯한 실제 기기 하나입니다. 신뢰성을 유지하는 두 가지 규칙:
userAgent, 클라이언트 힌트, navigator를 같은 응답에서 설정하세요. 클라이언트 힌트는 원래 브라우저를 보고하는데 UA만 바꾸는 것이 가장 흔한 자동화 탐지 단서입니다.
특정 프로필/세션에는 같은 핑거프린트를 재사용하세요. 세션 중간에 필드를 바꾸면 하드웨어가 바뀐 기기처럼 보입니다.
요청한 국가와 같은 국가의 이그레스 IP를 함께 사용하여 시간대, 언어, IP가 일치하도록 하세요.
5. FAQ
random과 generate 중 어떤 엔드포인트를 써야 하나요?›
/fingerprint/random은 풀에서 이전에 수집된 실제 기기를 반환합니다(저렴함). /fingerprint/generate는 엄격한 일관성 제약 조건에 따라 고유한 새 기기를 합성합니다(성공한 경우에만 할당량 차감). 유일무이한 신원이 필요할 때 generate를 사용하세요.
chromium 형식과 raw 형식의 차이는요?›
chromium은 바로 주입할 수 있는 형식으로, 브라우저에 설정하는 필드(userAgent, screen, intl, navigator)를 정확히 담고 있습니다. raw는 저장하거나 자체 인젝터에 사용할 수 있도록 전체 핑거프린트 데이터(canvas, fonts, visitor_id, webgl_properties)를 반환합니다.
Sec-CH-UA 헤더도 설정해야 하나요?›
핑거프린트는 하나의 기기로 도출되므로 userAgent, 클라이언트 힌트 헤더, navigator가 모두 일치합니다. 가장 흔한 탐지 단서는 UA만 바꾸고 클라이언트 힌트는 원래 브라우저를 보고하도록 두는 것입니다. 필드를 함께 적용하고 하나만 따로 수정하지 마세요.
국가나 OS를 지정하려면 어떻게 하나요?›
country(ISO alpha-2, 언어 + 시간대 + 음성 결정)와 tags(Windows, macOS, Linux, Android, iOS)를 전달하세요. Fingerprint API 페이지의 매개변수 표를 참고하세요.
시작할 준비가 되셨나요?
API 키를 받고 첫 번째 일관된 핑거프린트를 생성해 보세요.