Impressões Digitais de Navegador Personalizadas: Controle os Sinais que os Sites Leem

npm install puppeteer-core

export SCRAPELESS_API_KEY="seu_token_api_aqui"

import puppeteer from 'puppeteer-core';

const fingerprint = {
  userAgent:
    'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, como Gecko) Chrome/134.0.0.0 Safari/537.36',
  platform: 'Windows',
  screen: { width: 1280, height: 1024 },
  localization: { languages: ['pt-BR', 'pt'], timezone: 'Asia/Hong_Kong' },
  args: { '--window-size': '1280,1024' },
};

const params = new URLSearchParams({
  token: process.env.SCRAPELESS_API_KEY,
  sessionTTL: '180',
  proxyCountry: 'ANY',
  fingerprint: encodeURIComponent(JSON.stringify(fingerprint)),
});

const browser = await puppeteer.connect({
  browserWSEndpoint: `wss://browser.scrapeless.com/api/v2/browser?${params}`,
});
const page = await browser.newPage();
await page.goto('https://example.com', { waitUntil: 'domcontentloaded' });
await browser.close();

const reported = await page.evaluate(() => ({
  userAgent: navigator.userAgent,
  platform: navigator.platform,

Em uma execução ao vivo, os quatro valores retornaram como os valores da impressão digital — o user agent literalmente, `plataforma` como `Win32` (de `platform: 'Windows'`), o fuso horário resolvido como `Asia/Hong_Kong`, e o idioma como `en-US`. A substituição chega ao ambiente JavaScript que a página realmente lê, não apenas ao cabeçalho da solicitação.

> Obtenha sua chave de API no plano gratuito: [app.scrapeless.com](https://app.scrapeless.com/passport/login/?utm_source=website&utm_medium=blog&utm_campaign=scrapingbrowser&utm_term=custom-browser-fingerprint)

---

## Faça os sinais concordarem

Uma impressão digital ajuda apenas quando suas partes contam uma única história. As incompatibilidades comuns que fazem uma sessão ser sinalizada:

- **Fuso horário vs. IP** — um fuso horário de Hong Kong por trás de uma saída dos EUA é lido como inconsistente. Defina `proxyCountry` para uma região que corresponda ao fuso horário e idiomas ou defina o fuso horário para corresponder à saída. O manuseio do fuso horário segue as zonas IANA referenciadas por <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/resolvedOptions" rel="nofollow"><strong>a API Intl.DateTimeFormat</strong></a>.
- **Plataforma vs. user agent** — uma plataforma `Windows` com uma string UA macOS é uma contradição. Mantenha o campo da plataforma e o token do SO do UA alinhados; a gramática do UA é definida em <a href="https://datatracker.ietf.org/doc/html/rfc9110#name-user-agent" rel="nofollow"><strong>a especificação semântica HTTP</strong></a>.
- **Idioma vs. região** — ordene `languages` da forma como um usuário naquela região faria, com o local principal primeiro.
- **Tela vs. janela** — mantenha as dimensões da `screen` e o argumento `--window-size` sensatos para o dispositivo que você está simulando.

Esses sinais são exatamente o tipo de indícios de cliente automatizado catalogados em <a href="https://owasp.org/www-project-automated-threats-to-web-applications/" rel="nofollow"><strong>o projeto OWASP Automated Threats</strong></a> — a coerência entre eles é o que um verdadeiro navegador possui e um bot descuidado não tem.

---

## Padrões avançados

**Rotacione impressões digitais entre sessões, não dentro de uma.** Mantenha uma impressão digital estável durante a vida de uma sessão para que a história não mude durante a visita; varie-a entre sessões, em vez disso.

**Fixe a saída à região da impressão digital.** Defina `proxyCountry` (e `proxyState`/`proxyCity` quando necessário) para corresponder ao fuso horário e aos idiomas que você escolheu.

**Persistir uma identidade com um perfil.** Quando você precisar da mesma identidade em várias execuções, pare a impressão digital com um perfil de navegador para que cookies e armazenamento sejam preservados.

**Mantenha-o plausível.** Uma impressão digital que nenhum dispositivo real produziria é tão suspeita quanto uma padrão — use valores que descrevam um navegador que realmente existe.

---

## Conclusão: uma identidade coerente

Uma impressão digital personalizada não é um único truque — é a diferença entre um navegador que relata uma identidade consistente e um que se contradiz. Defina o user agent, plataforma, tela, fuso horário e idiomas juntos, fixe a saída para corresponder e os valores que um site lê concordam da mesma forma que os de um verdadeiro navegador. Combine isso com os controles de sessão do [Scraping Browser](https://www.scrapeless.com/pt/product/scraping-browser?utm_source=website&utm_medium=blog&utm_campaign=scrapingbrowser&utm_term=custom-browser-fingerprint) e saída residencial, informe-se sobre [por que a reputação do IP importa](https://www.scrapeless.com/pt/blog/what-is-a-cloud-proxy?utm_source=website&utm_medium=blog&utm_campaign=scrapingbrowser&utm_term=custom-browser-fingerprint), e a [documentação](https://docs.scrapeless.com) cobre todos os campos.

---

## Pronto para construir seu pipeline de dados alimentado por IA?

Junte-se à nossa comunidade para reivindicar um plano gratuito e conectar-se com desenvolvedores que constroem fluxos de trabalho de anti-detecção: [Discord](https://discord.gg/VU2vtbq7Q2) · [Telegram](https://t.me/scrapeless).

Inscreva-se em [app.scrapeless.com](https://app.scrapeless.com/passport/login/?utm_source=website&utm_medium=blog&utm_campaign=scrapingbrowser&utm_term=custom-browser-fingerprint) para um tempo de execução gratuito do Scraping Browser e veja [preços](https://www.scrapeless.com/pt/pricing?utm_source=website&utm_medium=blog&utm_campaign=scrapingbrowser&utm_term=custom-browser-fingerprint) para escala.

---

## FAQ

**P: O que é uma impressão digital de navegador?**
O conjunto de sinais que um site lê para identificar seu navegador — user agent, plataforma, tamanho da tela, fuso horário, idioma e valores mais profundos como canvas e WebGL. Os sites combinam eles em um identificador e sinalizam combinações que não parecem um dispositivo real.

**P: Definir a impressão digital realmente muda o que a página vê?**
Sim. Em uma execução ao vivo, `navigator.userAgent`, `navigator.platform`, o fuso horário resolvido e `navigator.language` retornaram todos os valores definidos na sessão — a substituição alcança o ambiente JavaScript, não apenas o cabeçalho da solicitação.

**P: O fuso horário deve corresponder ao país do proxy?**
Sim. Um fuso horário que contradiz a região do IP de saída é uma bandeira comum. Defina `proxyCountry` para corresponder ao fuso horário e idiomas da impressão digital, ou defina o fuso horário para corresponder à saída.

**P: Posso rotacionar impressões digitais?**
Rotacione entre sessões, não dentro de uma. Uma impressão digital que muda durante a sessão é um sinal por si só; mantenha-a estável por sessão e varie-a entre sessões.

**P: Eu preciso de um agente de IA ou SDK para isso?**
Não. A impressão digital é um parâmetro de consulta no endpoint padrão do Puppeteer WebSocket — use `puppeteer.connect()` puro, sem agente necessário.