Genera un fingerprint, inyéctalo y pasa desapercibido.
Solicita un fingerprint de navegador coherente y real con una simple llamada REST y luego aplica sus campos a Playwright, Puppeteer o Selenium para que tu automatización se presente como una única máquina plausible y coherente.
1. Primeros pasos
Consigue una API key en tu panel y solicita un fingerprint. /generate sintetiza una identidad nueva y única; /random devuelve una real del 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"- Filtra con tags (Windows, macOS, Linux, Android, iOS) y country (ISO alpha-2).
- format=chromium devuelve campos listos para inyectar; format=raw devuelve los datos completos.
- La cuota solo se descuenta cuando la generación tiene éxito.
2. Aplícalo en tu automatización
Define los campos a nivel de máquina (userAgent, viewport, locale, timezone) en el navegador y haz que el navigator visible desde JS coincida con la misma máquina antes de que se ejecute cualquier script de la página.
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()Los fingerprints de Firefox y Safari funcionan igual. Los campos de capacidades presentes en Chromium (deviceMemory, hardwareConcurrency, client hints) se omiten donde un navegador real no los expondría.
3. Formatos de respuesta
chromium listo para inyectar
Los campos exactos que defines en el navegador: userAgent, screen, intl, navigator, webgl. Úsalo en los ejemplos de arriba.
raw datos completos
El payload completo del fingerprint (canvas, fonts, visitor_id, webgl_properties) para almacenarlo o usarlo en tu propio inyector.
4. Mantenlo coherente
Un fingerprint es una máquina real plausible, no un conjunto de campos aleatorios. Dos reglas lo mantienen creíble:
Define userAgent, client hints y navigator a partir de la misma respuesta. Sobrescribir el UA mientras los client hints informan del navegador original es la señal de automatización número uno.
Reutiliza el mismo fingerprint para un perfil/sesión determinado. Rotar campos a mitad de sesión parece una máquina que cambió de hardware.
Combina el país que solicitas con una IP de salida de ese país para que la zona horaria, el idioma y la IP coincidan.
5. Preguntas frecuentes
random o generate: ¿qué endpoint?›
/fingerprint/random devuelve un dispositivo real recopilado previamente del pool (económico). /fingerprint/generate sintetiza uno nuevo y único con estrictas restricciones de coherencia (la cuota solo se descuenta si tiene éxito). Usa generate cuando necesites una identidad única.
¿Formato chromium o raw?›
chromium está listo para inyectar: los campos exactos que defines en el navegador (userAgent, screen, intl, navigator). raw devuelve los datos completos del fingerprint (canvas, fonts, visitor_id, webgl_properties) para almacenarlos o usarlos en tu propio inyector.
¿También tengo que definir los headers Sec-CH-UA?›
El fingerprint se deriva como una sola máquina, así que el userAgent, los headers de client hints y navigator coinciden. La señal delatora número 1 es sobrescribir el UA pero dejar que los client hints sigan informando del navegador original, así que aplica los campos juntos y no edites uno a mano por separado.
¿Cómo me dirijo a un país o SO concreto?›
Pasa country (ISO alpha-2, determina idiomas + zona horaria + voces) y tags (Windows, macOS, Linux, Android, iOS). Consulta la tabla de parámetros en la página de Fingerprint API.
¿Listo para empezar?
Obtén una API key y genera tu primer fingerprint coherente.