Сгенерируйте отпечаток, внедрите его, сливайтесь с толпой.
Запросите согласованный реалистичный отпечаток браузера простым 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, client hints), опускаются там, где настоящий браузер их не раскрывает.
3. Форматы ответа
chromium готов к внедрению
Ровно те поля, которые вы задаёте браузеру: userAgent, screen, intl, navigator, webgl. Используйте его для примеров выше.
raw полные данные
Полные данные отпечатка (canvas, fonts, visitor_id, webgl_properties) для хранения или собственного инжектора.
4. Сохраняйте согласованность
Отпечаток: это одна правдоподобная реальная машина, а не набор случайных полей. Два правила делают его убедительным:
Задавайте userAgent, client hints и navigator из одного ответа. Подмена UA при client hints, сообщающих исходный браузер: главный признак автоматизации.
Используйте один и тот же отпечаток для конкретного профиля или сессии. Смена полей посреди сессии выглядит так, будто машина сменила железо.
Сочетайте запрошенную страну с исходящим 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, заголовки client hints и navigator согласованы между собой. Признак №1: подменить UA, но оставить client hints, сообщающие исходный браузер. Поэтому применяйте поля вместе и не редактируйте одно отдельно от остальных.
Как выбрать страну или ОС?›
Передайте country (ISO alpha-2, определяет языки, часовой пояс и голоса) и tags (Windows, macOS, Linux, Android, iOS). Таблица параметров есть на странице Fingerprint API.
Готовы начать?
Получите API-ключ и сгенерируйте первый согласованный отпечаток.