Wygeneruj fingerprint, wstrzyknij go, wtop się w tłum.
Pobierz spójny, prawdziwy fingerprint przeglądarki prostym wywołaniem REST, a następnie zastosuj jego pola w Playwright, Puppeteer lub Selenium, aby Twoja automatyzacja przedstawiała się jako jedna wiarygodna, spójna maszyna.
1. Pierwsze kroki
Pobierz klucz API z panelu, a następnie poproś o fingerprint. /generate syntetyzuje nową, unikalną tożsamość, a /random zwraca prawdziwą tożsamość z puli.
# 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"- Filtruj za pomocą tags (Windows, macOS, Linux, Android, iOS) i country (ISO alpha-2).
- format=chromium zwraca pola gotowe do wstrzyknięcia, a format=raw zwraca pełne dane.
- Limit jest pomniejszany tylko przy udanym wygenerowaniu.
2. Zastosuj go w automatyzacji
Ustaw w przeglądarce pola na poziomie maszyny (userAgent, viewport, locale, timezone), a następnie dopasuj widoczny dla JS navigator do tej samej maszyny, zanim uruchomi się jakikolwiek skrypt strony.
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()Fingerprinty Firefox i Safari działają tak samo. Pola możliwości dostępne w Chromium (deviceMemory, hardwareConcurrency, client hints) są pomijane tam, gdzie prawdziwa przeglądarka by ich nie udostępniała.
3. Formaty odpowiedzi
chromium gotowy do wstrzyknięcia
Dokładnie te pola, które ustawiasz w przeglądarce: userAgent, screen, intl, navigator, webgl. Użyj go w powyższych przykładach.
raw pełne dane
Kompletny ładunek fingerprintu (canvas, fonts, visitor_id, webgl_properties) do przechowywania lub własnego mechanizmu wstrzykiwania.
4. Zachowaj spójność
Fingerprint to jedna wiarygodna, prawdziwa maszyna, a nie worek losowych pól. Dwie zasady sprawiają, że pozostaje przekonujący:
Ustawiaj userAgent, client hints i navigator z tej samej odpowiedzi. Nadpisanie UA, gdy client hints zgłaszają oryginalną przeglądarkę, to najczęstsza oznaka automatyzacji.
Używaj tego samego fingerprintu dla danego profilu lub sesji. Zmiana pól w trakcie sesji wygląda jak maszyna, która zmieniła sprzęt.
Połącz wybrany kraj z wyjściowym IP z tego samego kraju, aby strefa czasowa, język i IP były zgodne.
5. FAQ
random czy generate: który endpoint?›
/fingerprint/random zwraca prawdziwe, wcześniej zebrane urządzenie z puli (tanio). /fingerprint/generate syntetyzuje nowe, unikalne urządzenie przy ścisłych ograniczeniach spójności (limit jest pomniejszany tylko przy sukcesie). Użyj generate, gdy potrzebujesz jedynej w swoim rodzaju tożsamości.
Format chromium czy raw?›
chromium jest gotowy do wstrzyknięcia: dokładnie te pola, które ustawiasz w przeglądarce (userAgent, screen, intl, navigator). raw zwraca pełne dane fingerprintu (canvas, fonts, visitor_id, webgl_properties) do przechowywania lub własnego mechanizmu wstrzykiwania.
Czy muszę też ustawić nagłówki Sec-CH-UA?›
Fingerprint jest wyprowadzany jako jedna maszyna, więc userAgent, nagłówki client hints i navigator są ze sobą zgodne. Najczęstszą wpadką jest nadpisanie UA przy pozostawieniu client hints, które zgłaszają oryginalną przeglądarkę, więc stosuj pola razem i nie edytuj ręcznie żadnego z osobna.
Jak wybrać kraj lub system?›
Przekaż country (ISO alpha-2, steruje językami, strefą czasową i głosami) oraz tags (Windows, macOS, Linux, Android, iOS). Zobacz tabelę parametrów na stronie Fingerprint API.
Gotowy, by zacząć?
Zdobądź klucz API i wygeneruj pierwszy spójny fingerprint.