Como Resolver CAPTCHA no BrowserCloud com a API CapSolver

BrowserCloud é uma plataforma de automação de navegador baseada em nuvem e de alto desempenho, projetada para automação web escalável e distribuída. Permite que desenvolvedores executem centenas de navegadores Chrome headless em paralelo para casos de uso como web scraping, testes automatizados, monitoramento de SEO, extração de dados e geração de conteúdo. Com suporte integrado para Puppeteer, Selenium e Playwright, o BrowserCloud simplifica fluxos de trabalho de automação complexos, oferecendo rotação de proxy, gerenciamento de sessão e monitoramento em tempo real.

No entanto, CAPTCHAs, sistemas de detecção de bots e medidas avançadas anti-automação frequentemente interrompem essas tarefas de automação de navegador, exigindo interações semelhantes às humanas para verificar a autenticidade. Essas barreiras podem bloquear scripts de scraping, diminuir as pipelines de teste e interromper envios de formulários automatizados, resultando em perda de tempo e redução de eficiência.

CapSolver, um serviço de bypass de detecção de CAPTCHA e bot com tecnologia de IA, fornece uma solução confiável. Ele detecta e resolve programaticamente uma ampla gama de tipos de CAPTCHA — incluindo reCAPTCHA v2/v3, Cloudflare Turnstile e quebra-cabeças baseados em imagens — garantindo fluxos de trabalho de automação de navegador ininterruptos.

Neste artigo, forneceremos um guia de integração passo a passo para conectar o CapSolver ao BrowserCloud usando o Puppeteer, juntamente com um exemplo de código totalmente funcional. Seguindo este guia, você poderá contornar os desafios de CAPTCHA, derrotar as medidas anti-bot e maximizar a eficiência de seus scripts de automação.

Visão geral do BrowserCloud e casos de uso

O BrowserCloud é uma plataforma versátil que gerencia uma grade de navegadores Chrome completos em infraestrutura de alto desempenho, eliminando a necessidade de lidar com dependências de navegadores locais, vazamentos de memória ou manutenção de infraestrutura. Seus principais recursos incluem:

• Escalabilidade: Execute até 100 navegadores headless simultaneamente para processamento paralelo.
• Suporte a Frameworks: Compatível com Puppeteer, Selenium e Playwright para automação flexível.
• Gerenciamento de Proxy: Oferece rotação inteligente de proxy e proxies premium para evitar detecção e bloqueios de IP.
• Geração de Conteúdo: Gere PDFs, capturas de tela e imagens de páginas da web ou HTML personalizado via API.
• Monitoramento em Tempo Real: Fornece ferramentas para gerenciamento de sessão e depuração.

Casos de uso

O BrowserCloud suporta uma variedade de tarefas de automação, incluindo:

• Web Scraping: Extraia dados de sites para pesquisa de mercado, monitoramento de preços ou agregação de conteúdo, aproveitando o suporte a proxy para evitar bloqueios.
• Testes Automatizados: Realize testes de ponta a ponta em vários navegadores e configurações para garantir a confiabilidade do aplicativo.
• Renderização de Conteúdo: Crie milhares de relatórios em PDF, faturas ou capturas de tela automatizadas de URLs para fins de relatórios ou marketing.
• Automação de Tarefas: Automatize tarefas repetitivas como envios de formulários, logins de conta ou validação de links.

Esses casos de uso geralmente encontram CAPTCHAs, tornando a integração do CapSolver essencial para a automação ininterrupta.

Por que a resolução de CAPTCHA é necessária

Os sites implantam CAPTCHAs e defesas anti-bot para se proteger contra acesso automatizado, spam e atividades maliciosas, representando um desafio significativo para tarefas de automação como web scraping. Os CAPTCHAs exigem interações como clicar em caixas de seleção ou resolver quebra-cabeças de imagens, o que pode interromper os scripts do BrowserCloud se não forem tratados. Os tipos comuns de CAPTCHA incluem:

Para web scraping e outras tarefas de automação, os CAPTCHAs podem impedir o acesso a dados críticos, exigindo intervenção manual que frustra o objetivo da automação. Embora a rotação de proxy do BrowserCloud ajude a reduzir os gatilhos de CAPTCHA, ela pode não eliminá-los completamente. A API do CapSolver fornece uma solução confiável, resolvendo CAPTCHAs programaticamente, permitindo que os scripts do BrowserCloud contornem essas barreiras e continuem extraindo dados ou executando tarefas perfeitamente.

Como usar o CapSolver para lidar com CAPTCHAs

A API do CapSolver pode ser integrada ao BrowserCloud em um script Puppeteer/Playwright/Selenium para lidar com CAPTCHAs de forma eficaz. O processo envolve:

1. Detectando o CAPTCHA: Identifique a presença de um CAPTCHA na página, como um elemento reCAPTCHA.
2. Extraindo Informações: Recupere os detalhes necessários, como a chave do site e o URL da página, necessários para resolver o CAPTCHA.
3. Chamando a API do CapSolver: Envie uma solicitação ao CapSolver para criar uma tarefa e obter um token de solução.
4. Injetando a Solução: Insira o token na página para contornar o CAPTCHA.
5. Continuando a Automação: Prossiga com tarefas como envio de formulário ou extração de dados.

Essa integração utiliza a infraestrutura de navegador escalável do BrowserCloud e os recursos de resolução de CAPTCHA baseados em IA do CapSolver para garantir fluxos de trabalho de automação robustos.

Exemplo de código completo + Explicação passo a passo

Abaixo está um exemplo de código completo que demonstra como integrar o CapSolver ao BrowserCloud para resolver um reCAPTCHA v2 em uma página de demonstração. O código é baseado no script fornecido, com pequenas melhorias para clareza e confiabilidade.

Pré-requisitos

Instale as dependências necessárias:

npm install puppeteer node-fetch@2 dotenv

Crie um arquivo .env com suas chaves de API:

BROWSER_CLOUD_TOKEN=seu_token_browsercloud
CAPSOLVER_API_KEY=sua_chave_api_capsolver

Exemplo de código

import puppeteer from 'puppeteer';
import fetch from 'node-fetch';
import dotenv from 'dotenv';
dotenv.config();

const BROWSER_CLOUD_TOKEN = process.env.BROWSER_CLOUD_TOKEN;
const CAPSOLVER_API_KEY = process.env.CAPSOLVER_API_KEY;

async function solveCaptcha(sitekey, pageUrl) {
    const createTaskRes = await fetch('https://api.capsolver.com/createTask', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({
            clientKey: CAPSOLVER_API_KEY,
            task: {
                type: 'ReCaptchaV2TaskProxyless',
                websiteURL: pageUrl,
                websiteKey: sitekey
            }
        })
    });
    const createTask = await createTaskRes.json();
    if (!createTask.taskId) throw new Error(`CapSolver: Falha ao criar tarefa: ${JSON.stringify(createTask)}`);

    let solution = null;
    while (true) {
        await new Promise(resolve => setTimeout(resolve, 2000));
        const resultRes = await fetch('https://api.capsolver.com/getTaskResult', {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({
                clientKey: CAPSOLVER_API_KEY,
                taskId: createTask.taskId
            })
        });
        const result = await resultRes.json();
        if (result.status === 'ready') {
            solution = result.solution.gRecaptchaResponse;
            break;
        }
        if (result.status === 'failed') throw new Error(`CapSolver: Falha ao resolver: ${JSON.stringify(result)}`);
    }
    if (!solution) throw new Error('CapSolver: Tempo limite aguardando solução');
    return solution;
}

(async () => {
    try {
        const browser = await puppeteer.connect({
            browserWSEndpoint: `wss://chrome-v2.browsercloud.io?token=${BROWSER_CLOUD_TOKEN}`
        });

        const page = await browser.newPage();
        await page.goto('https://recaptcha-demo.appspot.com/recaptcha-v2-checkbox.php', { waitUntil: 'networkidle2' });

        const sitekey = await page.$eval('.g-recaptcha', el => el.getAttribute('data-sitekey'));
        console.log('Sitekey:', sitekey);

        const solution = await solveCaptcha(sitekey, page.url());
        console.log('Solução CAPTCHA:', solution);

        await page.evaluate(token => {
            const textarea = document.getElementById('g-recaptcha-response');
            if (textarea) {
                textarea.value = token;
                textarea.innerHTML = token;
                textarea.style.display = '';
                textarea.dispatchEvent(new Event('input', { bubbles: true }));
            }
        }, solution);

        const submitBtn = await page.$('body > main > form > fieldset > button');
        if (submitBtn) {
            await Promise.all([
                page.waitForNavigation({ waitUntil: 'networkidle2' }),
                submitBtn.click()
            ]);
            console.log('Botão de envio clicado!');
        } else {
            console.log('Botão de envio não encontrado!');
        }

        console.log('Conteúdo da página após o envio:', await page.content());

        await browser.close();
    } catch (error) {
        console.error('Erro:', error);
    }
})();

Explicação passo a passo

Observação: O código original usava page.waitForTimeout(3000) após clicar no botão de envio, o que pode não aguardar a navegação de forma confiável. Este exemplo o melhora usando page.waitForNavigation() para garantir que a página foi totalmente carregada após o envio.

Descrição da demonstração

Esta seção descreve a execução do script em uma página de demonstração com uma caixa de seleção reCAPTCHA v2:

1. Conectar ao BrowserCloud: O script estabelece uma conexão com uma instância de navegador BrowserCloud usando o Puppeteer.
2. Navegar para a página de demonstração: Ele carrega a página de demonstração reCAPTCHA v2 (https://recaptcha-demo.appspot.com/recaptcha-v2-checkbox.php).
3. Detectar e extrair a chave do site: O script identifica o elemento reCAPTCHA e extrai sua chave do site.
4. Resolver CAPTCHA: Ele envia a chave do site e o URL da página para o CapSolver, recebendo um token de solução após a pesquisa.
5. Injetar token: O token é injetado na textarea g-recaptcha-response, simulando uma verificação de CAPTCHA bem-sucedida.
6. Enviar formulário: O script clica no botão de envio, acionando o envio do formulário.
7. Verificar sucesso: Após a navegação, o conteúdo da página é registrado, mostrando um envio bem-sucedido (por exemplo, uma mensagem de confirmação).

Na prática, você observaria o navegador navegando para a página de demonstração, a caixa de seleção reCAPTCHA sendo marcada automaticamente e o formulário sendo enviado com sucesso, tudo sem intervenção manual.

Seção de perguntas frequentes

Conclusão

A integração do CapSolver com o BrowserCloud cria uma combinação poderosa para automatizar tarefas da web que encontram CAPTCHAs. A resolução de CAPTCHA baseada em IA do CapSolver garante que seus scripts Puppeteer no BrowserCloud possam contornar as medidas anti-bot, enquanto a infraestrutura escalável e o suporte a proxy do BrowserCloud aprimoram a confiabilidade da automação. Isso é particularmente valioso para web scraping, testes automatizados e geração de conteúdo, onde os CAPTCHAs são obstáculos comuns.

Para começar, inscreva-se no BrowserCloud e CapSolver, obtenha suas chaves de API e implemente o exemplo de código fornecido. Explore a documentação do CapSolver e a documentação do BrowserCloud para recursos avançados e tipos de tarefas adicionais. Experimente essa integração em seu próximo projeto de automação e experimente fluxos de trabalho contínuos e sem interrupções!

Bônus para usuários do Browser: Use o código promocional BROWSERCLOUD ao recarregar sua conta CapSolver e receba um crédito bônus exclusivo de 6% — sem limites, sem expiração.

Navegadores e ferramentas suportados

• BrowserCloud: Suporta Puppeteer, Selenium e Playwright, executando navegadores Chrome.

• CapSolver: Compatível com qualquer cliente com capacidade HTTP, incluindo extensões de navegador para Chrome e Firefox.