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.