자동화 API
Selenium · Playwright · Puppeteer에서 핑거프린트 적용된 Chrome을 5분 만에 띄우세요.
호출당 ₩5 · 하루 300번 사용해도 ₩1,500. 마이페이지에서 API 키 발급 + 포인트 충전 (1만/3만/5만/10만원 단위).
빠른 시작 (5분)
- Antidetect 데스크톱 앱 설치 + 로그인
- 마이페이지에서 API 키 발급
- 같은 마이페이지에서 포인트 충전 (최소 1만원 = 2,000 호출)
- 아래 예시 코드 실행
두 가지 사용 모드
Persistent — 고정 페르소나
같은 프로필을 반복 사용. 매번 같은 fingerprint + 쿠키 유지 → 사이트가 "같은 사용자"로 인식.
적합: 계정 운영, 단일 페르소나, SEO 모니터링 등 "같은 신원으로 반복 방문"이 필요한 작업
Burst — 일회용 신원
1회 호출 = Antidetect 앱이 새 fingerprint Chrome 1개 띄움. 사용자는 debug port 받아서 Selenium/Puppeteer attach. 프로필 저장 안 됨, 종료 시 흔적 자동 정리.
적합: 광고 검증, 다중 신원 트래픽 시뮬레이션, 자기 사이트 부하 테스트
Mode 1 · Python (Selenium)
pip install antidetect-sdk seleniumfrom antidetect_sdk import Antidetect
from selenium import webdriver
from selenium.webdriver.chrome.options import Options
client = Antidetect(api_key="sk_xxx...")
# 1. 프로필 생성 (또는 기존 프로필 사용)
profile = client.create_profile("my-store-1")
# 2. Antidetect 앱이 fingerprint Chrome 띄움 (debug port 포함)
session = client.start_browser(profile["id"], headless=False)
# session = { sessionId, profileId, balance, debugAddress, wsEndpoint }
# 3. Selenium을 이미 띄워진 fingerprint Chrome에 attach (새 Chrome X)
opts = Options()
opts.add_experimental_option("debuggerAddress", session["debugAddress"])
driver = webdriver.Chrome(options=opts)
driver.get("https://example.com")
print(driver.title)
# 4. 종료 — Antidetect가 Chrome 관리. driver.quit() 호출 X.
client.stop_browser(session["sessionId"])
print(f"남은 포인트: {session['balance']}")Mode 1 · Node.js (Puppeteer)
npm install @antidetect/sdk puppeteerimport { Antidetect } from '@antidetect/sdk';
import puppeteer from 'puppeteer';
const client = new Antidetect({ apiKey: 'sk_xxx...' });
const profile = await client.createProfile('my-store-1');
// Antidetect 앱이 fingerprint Chrome 띄움 → wsEndpoint 반환
const session = await client.startBrowser(profile.id);
// Puppeteer를 이미 띄워진 fingerprint Chrome에 attach
const browser = await puppeteer.connect({
browserWSEndpoint: session.wsEndpoint
});
const page = await browser.newPage();
await page.goto('https://example.com');
console.log(await page.title());
// 종료 — disconnect만, close X (Antidetect가 관리)
browser.disconnect();
await client.stopBrowser(session.sessionId);
console.log(`남은 포인트: ${session.balance}`);Mode 2 · Burst — Python (Selenium)
1회 호출 = Antidetect 앱이 새 fingerprint Chrome 1개 띄우고 debug port 반환. 사용자는 그 port 에 Selenium attach 만 하면 됨. fingerprint/proxy 노출 X. 호출당 ₩5 차감.
from antidetect_sdk import Antidetect
from selenium import webdriver
from selenium.webdriver.chrome.options import Options
client = Antidetect(api_key="sk_xxx...")
# 100명의 다른 "신원"으로 사이트 방문 (순차 — 동시 실행은 PC 성능 몫)
for i in range(100):
s = client.launch_ephemeral(os="windows")
# s = { sessionId, debugAddress, wsEndpoint, balance, autoLocalized }
opts = Options()
opts.add_experimental_option("debuggerAddress", s["debugAddress"])
driver = webdriver.Chrome(options=opts)
driver.get("https://example.com")
print(f"#{i+1} title:", driver.title)
# 종료 — driver.quit() 호출 X, stop_browser 만 (Antidetect가 Chrome + 임시 dir 정리)
client.stop_browser(s["sessionId"])
print(f" 잔액: {s['balance']}원")
Mode 2 · Burst — Node.js (Puppeteer)
import { Antidetect } from '@antidetect/sdk';
import puppeteer from 'puppeteer';
const client = new Antidetect({ apiKey: 'sk_xxx...' });
for (let i = 0; i < 100; i++) {
const s = await client.launchEphemeral({ os: 'windows' });
// s = { sessionId, debugAddress, wsEndpoint, balance, autoLocalized }
const browser = await puppeteer.connect({ browserWSEndpoint: s.wsEndpoint });
const page = await browser.newPage();
await page.goto('https://example.com');
console.log(`#${i+1} ${await page.title()} · 잔액: ${s.balance}`);
// 종료 — disconnect만, close X (Antidetect가 정리)
browser.disconnect();
await client.stopBrowser(s.sessionId);
}Mode 2 · 프록시 옵션
기본: rotating proxy 자동
아무것도 안 넘기면 우리 rotating proxy 풀에서 매 호출 새 IP 할당. IP geo 에 맞춰 timezone/언어 자동 매칭(예: 일본 IP → Asia/Tokyo + ja-JP). 사용자가 따로 timezone 안 박아도 일관됨.
사용자 proxy 직접 사용
자기 proxy 풀이 있으면 proxy 옵션으로 전달. 이 경우 timezone 자동매칭 안 됨 — timezone 옵션도 같이 지정 권장.
# client = Antidetect(api_key="sk_xxx...") # 위 예시처럼 먼저 초기화
s = client.launch_ephemeral(
os="windows",
proxy={"server": "http://proxy.example.com:8080", "username": "u", "password": "p"},
timezone="Asia/Tokyo",
accept_language="ja-JP,ja;q=0.9",
)에러 코드
| Code | HTTP | 의미 |
|---|---|---|
| MISSING_API_KEY | 401 | X-API-Key 헤더 없음 |
| INVALID_KEY | 401 | API 키 형식 오류 또는 없음 |
| LICENSE_REVOKED | 401 | 라이선스 정지됨 (API도 자동 비활성) |
| INTEGRITY_FAILED | 401 | 클라이언트 변조 감지 — 재발급 필요 |
| INSUFFICIENT_POINTS | 402 | 포인트 부족. 마이페이지에서 충전 |
| RATE_LIMITED | 429 | 분당 200회 초과 (서버) / 분당 100회 (로컬) |
| CLOUD_UNREACHABLE | 503 | 우리 서버 일시 장애 — 자동 복구 |
제한 사항 · 권장 사용
- Rate limit: API 키당 분당 200회 (서버) + 분당 100회 (로컬 1차 캡)
- 충전 단위: 1만/3만/5만/10만원만 가능
- 포인트 유효기간: 12개월 (미사용 시 자동 만료)
- 활성화 후 환불 불가 (환불 정책)
⚠ Acceptable Use Policy
합법적 목적 (SEO 모니터링 · 시장 조사 · 광고 검증 · 자기 사이트 부하 테스트)에만 사용. 광고 클릭 부풀리기 · 가짜 트래픽 생성 · 대량 계정 자동 생성 · 사이트 이용약관 위반에 사용 적발 시 즉시 키 회수 + 환불 X + 형사 고발 가능합니다.