API CDP

O Scrapeless Scraping Browser estende a funcionalidade padrão do CDP (Chrome DevTools Protocol), adicionando uma série de poderosas funções personalizadas para aprimorar os recursos de automação do navegador. Este documento abrange principalmente as funções CDP relacionadas ao tratamento de CAPTCHA.

Recursos do resolvedor CAPTCHA

Visão geral dos recursos

O Scraping Browser inclui recursos avançados de solução CAPTCHA, capazes de lidar automaticamente com os tipos de CAPTCHA prevalentes encontrados em páginas da web.

Tipos de CAPTCHA suportados

reCaptcha
Cloudflare Turnstile
Cloudflare 5s Challenge
AWS WAF

Mecanismo de monitoramento de eventos

Eventos principais

O Scraping Browser fornece três eventos principais para monitorar o processo de resolução do CAPTCHA:

Nome do evento	Descrição
`Captcha.detected`	CAPTCHA detectado
`Captcha.solveFinished`	Resolução do CAPTCHA concluída
`Captcha.solveFailed`	Resolução do CAPTCHA falhou

Estrutura de dados de resposta do evento

Campo	Tipo	Descrição
`type`	string	Tipo de CAPTCHA: `recaptcha` `turnstile`
`success`	boolean	Resultado da resolução
`message`	string	Mensagem de status: `"NOT_DETECTED"` `"SOLVE_FINISHED"` `"SOLVE_FAILED"` `"INVALID"`
`token?`	string	Token retornado em caso de sucesso (opcional)

Exemplo de implementação

// Listen for CAPTCHA solving events
const client = await page.createCDPSession();
 
client.on('Captcha.detected', (result) => {
  console.log('Captcha detected:', result);
});
 
await new Promise((resolve, reject) => {
  client.on('Captcha.solveFinished', (result) => {
    if (result.success) resolve();
  });
  client.on('Captcha.solveFailed', () =>
    reject(new Error('Captcha solve failed'))
  );
  setTimeout(() =>
      reject(new Error('Captcha solve timeout')),
    5 * 60 * 1000
  );
});

API de configuração avançada

O Scraping Browser fornece uma série de APIs avançadas para controle preciso sobre o comportamento do resolvedor CAPTCHA. As seguintes APIs são suportadas:

Nome da API	Descrição
`Captcha.setAutoSolve`	Controla o comportamento de resolução automática do CAPTCHA
`Captcha.setToken`	Define o token de autenticação para o serviço CAPTCHA
`Captcha.setConfig`	Configura todos os parâmetros do resolvedor CAPTCHA
`Captcha.solve`	Aciona manualmente o processo de resolução do CAPTCHA

Descrição detalhada da API

1. `Captcha.setAutoSolve`

Interface de configuração para controlar o comportamento de resolução automática do CAPTCHA.

const client = await page.createCDPSession();
await client.send('Captcha.setAutoSolve', {
    autoSolve: false,
    options: [{
        type: 'recaptcha',  // Options: recaptcha | turnstile
        disabled: false,
    }]
});

2. `Captcha.setToken`

Define o token de autenticação para o serviço de resolução CAPTCHA.

await client.send('Captcha.setToken', {
    apiKey: 'your-token'
});

3. `Captcha.setConfig`

Configura todos os parâmetros do resolvedor CAPTCHA.

await client.send('Captcha.setConfig', {
    config: JSON.stringify(
        {
            apiKey: "your-token",
            autoSolve: true,
            enabledForRecaptcha: true,
            enabledForRecaptchaV3: true,
            enabledForTurnstile: true
        }
    )
});

4. `Captcha.solve`

Aciona manualmente o processo de resolução do CAPTCHA.

const result = await client.send('Captcha.solve', {
    detectTimeout: 10 * 1000,
    options: JSON.stringify([{
        type: 'rcaptcha',
        disabled: true,  // Disable rCaptcha solving
    }])
});
console.log(result);  // { type: 'recaptcha', success: true, message: 'solve_finished', token: 'xxx' }

Impressão digital personalizada Captcha Resolving