Bir parmak izi oluşturun, enjekte edin, ortama karışın.
Basit bir REST çağrısıyla tutarlı, gerçek dünyadan bir tarayıcı parmak izi isteyin, ardından alanlarını Playwright, Puppeteer veya Selenium'a uygulayın; otomasyonunuz inandırıcı ve tutarlı tek bir makine olarak görünsün.
1. Başlarken
Panelinizden bir API anahtarı alın, ardından bir parmak izi isteyin. /generate yeni ve benzersiz bir kimlik sentezler; /random havuzdan gerçek bir kimlik döndürür.
# 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) ve country (ISO alpha-2) ile filtreleyin.
- format=chromium enjeksiyona hazır alanları döndürür; format=raw tam verileri döndürür.
- Kota yalnızca başarılı bir oluşturmada düşülür.
2. Otomasyonunuzda uygulayın
Makine düzeyindeki alanları (userAgent, viewport, locale, timezone) tarayıcıda ayarlayın, ardından herhangi bir sayfa betiği çalışmadan önce JS tarafından görülen navigator nesnesini aynı makineyle eşleştirin.
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 ve Safari parmak izleri de aynı şekilde çalışır. Chromium'da bulunan yetenek alanları (deviceMemory, hardwareConcurrency, client hints), gerçek bir tarayıcının bunları göstermeyeceği durumlarda çıkarılır.
3. Yanıt formatları
chromium enjeksiyona hazır
Tarayıcıda ayarladığınız alanların tam kendisi: userAgent, screen, intl, navigator, webgl. Yukarıdaki örnekler için bunu kullanın.
raw tam veri
Depolama veya kendi enjektörünüz için eksiksiz parmak izi yükü (canvas, fonts, visitor_id, webgl_properties).
4. Tutarlı tutun
Bir parmak izi, rastgele alanlardan oluşan bir yığın değil, inandırıcı gerçek tek bir makinedir. İki kural onu inandırıcı tutar:
userAgent, client hint'ler ve navigator değerlerini aynı yanıttan ayarlayın. Client hint'ler orijinal tarayıcıyı bildirirken UA'yı değiştirmek, otomasyonu ele veren bir numaralı işarettir.
Belirli bir profil/oturum için aynı parmak izini yeniden kullanın. Oturum ortasında alanları değiştirmek, donanımı değişmiş bir makine gibi görünür.
İstediğiniz ülkeyi o ülkedeki bir çıkış IP'siyle eşleştirin, böylece saat dilimi, dil ve IP uyumlu olur.
5. SSS
random mı generate mi: hangi uç nokta?›
/fingerprint/random, havuzdan daha önce toplanmış gerçek bir cihaz döndürür (ucuz). /fingerprint/generate, katı tutarlılık kısıtları altında yeni ve benzersiz bir cihaz sentezler (kota yalnızca başarılı olduğunda düşülür). Eşsiz bir kimliğe ihtiyacınız olduğunda generate kullanın.
chromium mu raw formatı mı?›
chromium enjeksiyona hazırdır: tarayıcıda ayarladığınız alanların tam kendisi (userAgent, screen, intl, navigator). raw, depolama veya kendi enjektörünüz için tam parmak izi verilerini (canvas, fonts, visitor_id, webgl_properties) döndürür.
Sec-CH-UA başlıklarını da ayarlamam gerekiyor mu?›
Parmak izi tek bir makine olarak türetilir, bu nedenle userAgent, client-hint başlıkları ve navigator birbiriyle uyumludur. En belirgin ele veren işaret, UA'yı değiştirip client hint'lerin orijinal tarayıcıyı bildirmeye devam etmesidir; bu yüzden alanları birlikte uygulayın ve birini tek başına elle düzenlemeyin.
Bir ülkeyi veya işletim sistemini nasıl hedeflerim?›
country (ISO alpha-2; dilleri, saat dilimini ve sesleri belirler) ve tags (Windows, macOS, Linux, Android, iOS) geçin. Fingerprint API sayfasındaki parametre tablosuna bakın.
Başlamaya hazır mısınız?
Bir API anahtarı alın ve ilk tutarlı parmak izinizi oluşturun.