Como Rastrear Tarefas com a Interação Humano-Computador?

O Scrapeless Scraping Browser agora suporta totalmente tarefas de automação através de fluxos de trabalho baseados em Sessão. Seja iniciado através do Playground ou da API, todas as execuções de programas podem ser rastreadas de forma síncrona no Painel.

• Abra a Visualização Ao Vivo para monitorar o status em tempo real.
• Compartilhe a URL Ao Vivo para interação remota do usuário—como páginas de login, preenchimento de formulários ou conclusão de pagamentos.
• Revise todo o processo de execução com a Repetição de Sessão.

Mas você pode se perguntar:

O que exatamente são esses recursos de Sessão? Como eles me beneficiam? E como eu os utilizo?

Neste blog, exploraremos a Sessão do Scrapeless Scraping Browser em profundidade, abordando:

• O conceito e propósito da Visualização Ao Vivo
• O que é a URL Ao Vivo
• Como usar a URL Ao Vivo para interação direta com o usuário
• Por que a Repetição de Sessão é essencial

Visualização Ao Vivo: Monitoramento de Programa em Tempo Real

O recurso de Visualização Ao Vivo no Scrapeless Scraping Browser permite que você rastreie e controle sessões do navegador em tempo real. Especificamente, ele permite observar cliques, entradas e todas as ações do navegador, monitorar fluxos de trabalho de automação, depurar scripts manualmente e tomar controle direto da sessão, se necessário.

Criando uma Sessão do Navegador

Primeiro, você precisa criar uma sessão. Existem duas maneiras de fazer isso:

Método 1: Criar uma sessão via Playground

Método 2: Criar uma sessão via API

Você também pode criar uma sessão usando nossa API. Consulte a documentação da API: Documentação da API do Scraping Browser. O nosso recurso de sessão ajudará você a gerenciar sua sessão, incluindo capacidades de visualização em tempo real.

Visualizar Sessões Ao Vivo

Na interface de gerenciamento de sessões do Scrapeless, você pode visualizar facilmente as sessões ao vivo:

Método 1: Visualizar Sessões Ao Vivo Diretamente no Painel

Depois de criar uma sessão no Playground, você verá a sessão em execução ao vivo no lado direito.

Ou, você pode verificar o status da sessão na página Sessões Ao Vivo.

Método 2: Visualizar Sessão via URL Ao Vivo

Uma URL Ao Vivo é gerada para uma sessão em execução, permitindo que você assista ao processo ao vivo em um navegador.

As URLs Ao Vivo são úteis para:

• Depuração e Monitoramento: Assista a tudo em tempo real ou compartilhe com os colegas.
• Interação Humana: Controle ou insira diretamente—deixe o usuário inserir informações sensíveis como senhas de forma segura.

Você pode copiar a URL Ao Vivo clicando no ícone "🔗" na página de Sessões Ao Vivo. Tanto as sessões criadas no Playground quanto na API suportam URL Ao Vivo.

1. Obter URL Ao Vivo do Painel

2. Obter URL Ao Vivo via API
   Você também pode recuperar a URL Ao Vivo através de chamadas da API. O código de exemplo abaixo busca todas as sessões em execução via a API de sessões, e então usa a API de URL Ao Vivo para recuperar a visualização ao vivo de uma sessão específica.

print("nenhum dado de URL ao vivo disponível para esta tarefa")
    except Exception as error:
        print(f"erro ao buscar URL ao vivo para a tarefa {task_id}: {str(error)}")
 
 
async def fetch_browser_sessions():
    try:
        session_response = requests.get(f"{API_CONFIG['host']}/browser/running", headers=API_CONFIG["headers"])
 
        if not session_response.ok:
            raise Exception(f"falha ao buscar sessões: {session_response.status_code} {session_response.reason}")
 
        session_result = session_response.json()
 
        sessions = session_result.get("data")
        if not sessions or not isinstance(sessions, list) or len(sessions) == 0:
            print("nenhuma sessão de navegador ativa encontrada")
            return
 
        task_id = sessions[0].get("taskId")
        if not task_id:
            print("id da tarefa não encontrado nos dados da sessão")
            return
 
        await fetch_live_url(task_id)
    except Exception as error:
        print(f"erro ao buscar sessões de navegador: {str(error)}")
 
 
import asyncio
 
asyncio.run(fetch_browser_sessions())

3. Obter URL ao vivo via comando CDP

Para obter a URL ao vivo enquanto o código está sendo executado, use o comando CDP Agent.liveURL:

import asyncio
 
from pyppeteer import launcher
 
 
async def main():
    try:
        browser = await launcher.connect(
            browserWSEndpoint="wss://browser.scrapeless.com/browser?token=APIKey&session_ttl=180&proxy_country=ANY"
        )
        page = await browser.newPage()
        await page.goto('https://www.scrapeless.com')
 
        client = await page.target.createCDPSession()
        result = await client.send('Agent.liveURL')
        print(result)
    except Exception as e:
        print(e)
 
 
asyncio.run(main())

Um Destaque Que Vale a Pena Mencionar:

A URL ao vivo não apenas permite monitoramento em tempo real, mas também interação homem-máquina.

Por exemplo: Você precisa que o usuário insira sua senha de login.

“Oh não! Você está tentando roubar minhas informações privadas? De jeito nenhum!”

Na verdade, o usuário pode inserir os dados ele mesmo na tela — e tudo permanece 100% privado. Esse método direto, mas seguro é o que a URL ao vivo possibilita — interação remota.

URL ao Vivo: Como Facilita a Colaboração e Interação com o Usuário

Vamos usar o registro e login no Scrapeless como exemplo e ver como interagir diretamente com os usuários.

Aqui está o código que você precisará:

const puppeteer = require("puppeteer-core");

(async () => {
    const fingerprint = {
        // impressão digital de tela personalizada
        screen: {
            width: 1920,
            height: 1080,
        },
        args: {
            // definir o tamanho da janela com o mesmo valor da impressão digital da tela
            "--window-size": "1920,1080",
        },
    };

    const query = new URLSearchParams({
        token: "APIKey",
        session_ttl: 600,
        proxy_country: "ANY",
        fingerprint: encodeURIComponent(JSON.stringify(fingerprint)),
    });
    const browserWsEndpoint = `wss://browser.scrapeless.com/browser?${query.toString()}`;

    try {
        const browser = await puppeteer.connect({
            browserWSEndpoint: browserWsEndpoint,
        });

        const page = await browser.newPage();
        await page.setViewport(null);

        await page.goto(`https://app.scrapeless.com/passport/register`, {
            timeout: 120000,
            waitUntil: "domcontentloaded",
        });

        const client = await page.createCDPSession();
        const result = await client.send("Agent.liveURL");

        // você pode compartilhar a URL ao vivo com qualquer usuário
        console.log(`${result.liveURL}`);

        // aguarde 5 minutos para o registro do usuário
        await page.waitForSelector("#none-existing-selector", {timeout: 300_000});
    } catch (e) {
        console.log(e);
    }
})()

Execute o código acima e compartilhe a URL ao vivo com o usuário, como: URL de Registro do Scrapeless.

Todos os passos anteriores, como:

• Navegar até o site
• Visitar a página inicial do Scrapeless
• Clicar em login e entrar na página de registro

Tudo isso pode ser feito diretamente criando uma sessão usando o código acima. O passo mais crítico é que o usuário precisa inserir seu email e senha para concluir o registro.

Depois que você compartilhar a URL ao vivo com o usuário, poderá monitorar remotamente o processo de execução do programa. O programa será executado automaticamente e pulará para a página que requer interação do usuário. A senha inserida pela outra parte ficará completamente oculta, e o usuário não precisa se preocupar com vazamento de senha.

Para refletir de forma mais intuitiva o processo de operação do usuário, consulte os seguintes passos de interação:

O seguinte processo interativo é totalmente executado na URL ao vivo

Replay de Sessão: Reproduza a Execução do Programa para Depurar Tudo

O Replay de Sessão é uma recriação em forma de vídeo de uma sessão de usuário construída usando a Biblioteca de Gravação. Os replays são criados com base em instantâneas do estado do DOM da aplicação web (a representação HTML na memória do navegador). Ao reproduzir cada instantânea, você verá um registro das ações realizadas durante toda a sessão: incluindo todos os carregamentos de página, atualizações e navegações que ocorreram durante sua visita ao site.

O Replay de Sessão pode ajudá-lo a solucionar todos os aspectos da operação do seu programa. Todas as operações de página serão registradas e salvas como um vídeo. Se você encontrar algum problema durante a sessão, pode solucionar e ajustar por meio da reprodução.

• Vá para Sessões

• Clique em Histórico de Sessões

• Localize a sessão

• Nos detalhes da sessão, clique no botão Reproduzir para assistir e revisar a execução:

Resumo

O Navegador Scrapeless Scraping permite que você monitore em tempo real, interaja remotamente e reproduza todos os passos.

• Visualização ao Vivo: Assista à atividade do navegador como uma transmissão ao vivo. Veja cada clique e input!
• URL ao Vivo: Gere um link compartilhável onde os usuários podem inserir seus dados diretamente. Totalmente privado, completamente seguro.
• Replay de Sessão: Depure como um profissional reproduzindo exatamente o que aconteceu — sem a necessidade de reexecutar o programa.

Se você é um desenvolvedor depurando, um PM fazendo uma demonstração, ou um suporte ao cliente orientando um usuário — as Sessões Scrapeless estão aqui para ajudá-lo.

É hora de tornar a automação inteligente e amigável.

Comece seu teste grátis agora!