Gere um fingerprint, injete-o e passe despercebido.
Solicite um fingerprint de navegador coerente e real por meio de uma simples chamada REST e aplique seus campos ao Playwright, Puppeteer ou Selenium para que sua automação apresente uma única máquina plausível e consistente.
1. Primeiros passos
Pegue uma chave de API no seu painel e solicite um fingerprint. /generate sintetiza uma identidade nova e única; /random retorna uma identidade real do pool.
# 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"- Filtre com tags (Windows, macOS, Linux, Android, iOS) e country (ISO alpha-2).
- format=chromium retorna campos prontos para injeção; format=raw retorna os dados completos.
- A cota só é descontada quando a geração é bem-sucedida.
2. Aplique na sua automação
Defina os campos de nível de máquina (userAgent, viewport, localidade, fuso horário) no navegador e depois ajuste o navigator visível ao JS para a mesma máquina antes que qualquer script da página seja executado.
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()Fingerprints de Firefox e Safari funcionam da mesma forma. Os campos de capacidade presentes no Chromium (deviceMemory, hardwareConcurrency, client hints) são omitidos quando um navegador real não os exporia.
3. Formatos de resposta
chromium pronto para injeção
Exatamente os campos que você define no navegador: userAgent, screen, intl, navigator, webgl. Use-o nos exemplos acima.
raw dados completos
O payload completo do fingerprint (canvas, fonts, visitor_id, webgl_properties) para armazenamento ou para o seu próprio injetor.
4. Mantenha a coerência
Um fingerprint é uma única máquina real e plausível, não um conjunto de campos aleatórios. Duas regras o mantêm convincente:
Defina userAgent, client hints e navigator a partir da mesma resposta. Sobrescrever o UA enquanto os client hints informam o navegador original é o principal sinal de automação.
Reutilize o mesmo fingerprint para um determinado perfil/sessão. Trocar campos no meio da sessão parece uma máquina que mudou de hardware.
Combine o país solicitado com um IP de saída nesse país para que fuso horário, idioma e IP sejam coerentes.
5. Perguntas frequentes
random ou generate: qual endpoint?›
/fingerprint/random retorna um dispositivo real, coletado anteriormente, do pool (barato). /fingerprint/generate sintetiza um dispositivo novo e único sob rígidas restrições de consistência (a cota só é descontada em caso de sucesso). Use generate quando precisar de uma identidade única.
Formato chromium ou raw?›
chromium é pronto para injeção: exatamente os campos que você define no navegador (userAgent, screen, intl, navigator). raw retorna os dados completos do fingerprint (canvas, fonts, visitor_id, webgl_properties) para armazenamento ou para o seu próprio injetor.
Preciso definir os cabeçalhos Sec-CH-UA também?›
O fingerprint é derivado como uma única máquina, então o userAgent, os cabeçalhos de client hints e o navigator são todos coerentes entre si. O principal sinal de automação é sobrescrever o UA e deixar os client hints informando o navegador original, então aplique os campos em conjunto e não edite um isoladamente à mão.
Como escolho um país ou sistema operacional?›
Passe country (ISO alpha-2, define idiomas + fuso horário + vozes) e tags (Windows, macOS, Linux, Android, iOS). Veja a tabela de parâmetros na página da Fingerprint API.
Pronto para começar?
Obtenha uma chave de API e gere seu primeiro fingerprint coerente.