Use Puppeteer to automate a Multilogin Mimic browser profile by starting the profile with automation_type=puppeteer, getting the automation port from the start response, and connecting Puppeteer to that local port.

➡️ Keep the Multilogin desktop app running → start the browser profile through the API → get data.port from the response → connect Puppeteer to http://127.0.0.1:<port>.

Puppeteer works with Mimic browser profiles. Legacy Stealthfox profiles don't support Puppeteer.

How the connection works

1. The script starts the Multilogin browser profile with automation_type=puppeteer
2. Multilogin returns the automation port in data.port
3. The script builds http://127.0.0.1:<port>
4. puppeteer.connect() connects to the already-running Multilogin profile
5. Puppeteer can then open pages and run your browser actions

Before you start

1. Download Node.js from the official website and install it
2. Ensure Node.js and npm (Node Package Manager) are installed correctly:

node -v 
npm -v

3. Create a project directory, then run this command to initialize a new Node.js project and create a package.json file: 

npm init -y

4. Install Puppeteer as a dependency for your project: 

npm install puppeteer

5. Install Axios: 

npm install axios

6. Insert your values into the below variables in the script:
   1. API_TOKEN: your Multilogin API token
   2. folder_id, profile_id: find these values using our guides on DevTools (for GUI) or Postman
7. Replace https://multilogin.com/ with the website you need in the following line:

await page.goto("https://multilogin.com/");

Running the script

1. Launch the app, as it makes profile launching possible
2. Use a Puppeteer version compatible with the Chromium version used by the current Mimic core. If Puppeteer fails to connect after a core update, check the current Mimic core and Puppeteer compatibility before changing the script.
3. Run the .js file with your automation code
   

   Make sure to run the automation code in the same folder/project as package.json file.

    

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();

Expected result: Multilogin starts the selected Mimic browser profile, Puppeteer connects to its returned automation port, opens the target webpage, and saves example.png in your project folder.

Troubleshooting

Why can't Puppeteer connect to the profile?

Check that:

• The Multilogin desktop app is running
• folder_id and profile_id are correct
• The browser profile is Mimic
• The profile start request returned a valid data.port
• Your API token is valid
• Your Puppeteer version is compatible with the current Mimic core

Why does Puppeteer open a different browser?

Make sure your script uses puppeteer.connect() with the port returned by Multilogin rather than launching a separate Puppeteer browser.