Pular para o conteúdo
MultiloginCentral de ajuda

Exemplo de automação Puppeteer

Use o Puppeteer para automatizar um perfil de navegador Mimic do Multilogin: inicie o perfil com automation_type=puppeteer, obtenha a porta de automação na resposta de inicialização e conecte o Puppeteer a essa porta local.

➡️ Mantenha o aplicativo desktop do Multilogin em execução → inicie o perfil de navegador pela API → obtenha data.port na resposta → conecte o Puppeteer a http://127.0.0.1:<port>.

O Puppeteer funciona com perfis de navegador Mimic. Perfis Stealthfox legados não são compatíveis com o Puppeteer.

Para começar a automatizar, confira estes recursos primeiro: Primeiros passos na automação por scripts

Este guia aborda a automação de perfis de navegador. Para automatizar aplicativos Android nativos em telefones em nuvem do Multilogin, use ADB ou Appium.

Quem pode usar este script?

  • 👨‍💻 Proprietários da conta e membros de equipe
  • 💰 Planos Pro 10 ou superiores

Como funciona a conexão

  1. O script inicia o perfil de navegador do Multilogin com automation_type=puppeteer
  2. O Multilogin retorna a porta de automação em data.port
  3. O script cria http://127.0.0.1:<port>
  4. puppeteer.connect() se conecta ao perfil do Multilogin que já está em execução
  5. Depois disso, o Puppeteer pode abrir páginas e executar ações no navegador

Antes de começar

  1. Baixe o Node.js do site oficial e instale-o
  2. Certifique-se de que o Node.js e o npm (Node Package Manager) estejam instalados corretamente:
node -v 
npm -v
  1. Crie um diretório de projeto e execute este comando para inicializar um novo projeto Node.js e criar um arquivo package.json:
npm init -y
  1. Instale Puppeteer como uma dependência para seu projeto:
npm install puppeteer
  1. Instale o Axios:
npm install axios
  1. Insira seus valores nas variáveis abaixo no script:
    1. API_TOKEN: seu token da API do Multilogin
    2. folder_id, profile_id: encontre esses valores usando nossos guias no DevTools (pela interface) ou Postman
  2. Substitua https://multilogin.com/ pelo site que você precisa na seguinte linha:
await page.goto("https://multilogin.com/");

Precisa do ID do perfil? Você pode copiá-lo diretamente da interface do Multilogin. Saiba como: Como copiar ID de perfil no Multilogin.

Executando o script

  1. Certifique-se de que o aplicativo esteja aberto, pois isso possibilita a criação do perfil
  1. Use uma versão do Puppeteer compatível com a versão do Chromium usada pelo núcleo Mimic atual. Se o Puppeteer não conseguir se conectar após uma atualização do núcleo, verifique a compatibilidade entre o núcleo Mimic atual e o Puppeteer antes de alterar o script.
  2. Execute o arquivo .js com seu código de automação

    Certifique-se de executar o código de automação na mesma pasta/projeto que o arquivo package.json.

Exemplo de script

const puppeteer = require('puppeteer');
const axios = require('axios');

const HEADERS = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};
// Insert your automation token in the variable below
const API_TOKEN = "";
// Insert the Folder ID and the Profile ID below
const folder_id = "";
const profile_id = "";

async function start_browserProfile() {
    // Add the automation token to the request headers
    HEADERS.Authorization = 'Bearer ' + API_TOKEN;
    // Launch a profile defining "Puppeteer" as automation type
    const profileLaunch_URL = `https://launcher.mlx.yt:45001/api/v2/profile/f/${folder_id}/p/${profile_id}/start?automation_type=puppeteer&headless_mode=false`;
    try {
        const response = await axios.get(profileLaunch_URL, {
            headers: HEADERS
        });
        const browserURL = `http://127.0.0.1:${response.data.data.port}`;
        // if you prefer to connect with browserWSEndpoint, try to get the webSocketDebuggerUrl by following request
        // const {data : {webSocketDebuggerUrl}} = await axios.get(`${browserURL}/json/version`)
        const browser = await puppeteer.connect({
            browserURL: browserURL,
            timeout: 10000
        });
        const page = await browser.newPage();
        await page.goto("https://multilogin.com/");
        await page.screenshot({
            path: "example.png"
        })
        await page.close();
        // Disconnect Puppeteer so the script can exit
        await browser.disconnect();
        // Stop the profile
        await axios.get(`https://launcher.mlx.yt:45001/api/v1/profile/stop/p/${profile_id}`, { headers: HEADERS });
    } catch (error) {
        console.log("Error:", error.message);
        if (error.response) {
            console.log("Response data:", error.response.data);
        }
    }
};

start_browserProfile();

Resultado esperado: o Multilogin inicia o perfil de navegador Mimic selecionado, o Puppeteer se conecta à porta de automação retornada, abre a página de destino e salva example.png na pasta do seu projeto.

Solução de problemas

Por que o Puppeteer não consegue se conectar ao perfil?

Verifique se:

  • O aplicativo desktop do Multilogin está em execução
  • folder_id e profile_id estão corretos
  • O perfil de navegador usa Mimic
  • A solicitação de inicialização do perfil retornou um data.port válido
  • Seu Token da API é válido
  • Sua versão do Puppeteer é compatível com o núcleo Mimic atual

Por que o Puppeteer abre outro navegador?

Verifique se o script usa puppeteer.connect() com a porta retornada pelo Multilogin, em vez de iniciar um navegador separado pelo Puppeteer.

Fique por dentro

Veja as últimas atualizações, troque dicas e explore casos de uso práticos.

Novidades do produtoCanal no TelegramPergunte a outrosChat no TelegramExplore casos de usoComunidade no Discord