跳转到内容
Multilogin帮助中心

Puppeteer 自动化示例

使用 Puppeteer 自动化操作 Multilogin Mimic 浏览器配置文件:通过 automation_type=puppeteer 启动配置文件,从启动响应获取自动化端口,再将 Puppeteer 连接到该本地端口。

➡️ 保持 Multilogin 桌面应用运行 → 通过 API 启动浏览器配置文件 → 从 API 响应中获取 data.port → 将 Puppeteer 连接到 http://127.0.0.1:<port>。

Puppeteer 适用于 Mimic 浏览器配置文件。旧版 Stealthfox 配置文件不支持 Puppeteer。

开始自动化之前,先查看:自动化脚本入门。

本指南介绍浏览器配置文件自动化。要在 Multilogin 云手机上自动化操作原生 Android 应用,请使用 ADB 或 Appium。

谁可以使用此脚本?

  • 👨‍💻 账户所有者和团队成员
  • 💰 Pro 10 及以上套餐

连接的工作方式

  1. 脚本使用 浏览器配置文件参数 automation_type=puppeteer 启动 Multilogin 配置文件
  2. Multilogin 在 data.port 中返回自动化端口
  3. 脚本构建 http://127.0.0.1:<port>
  4. puppeteer.connect() 连接已运行的 Multilogin 配置文件
  5. Puppeteer 随后即可打开网页并执行浏览器操作

开始之前

  1. 从官方网站下载并安装 Node.js
  2. 确保已正确安装 Node.js 和 npm(Node Package Manager):
node -v 
npm -v
  1. 创建项目目录,然后运行此命令初始化新的 Node.js 项目并创建 package.json 文件:
npm init -y
  1. 为项目安装 Puppeteer 依赖:
npm install puppeteer
  1. 安装 Axios:
npm install axios
  1. 在脚本的以下变量中填入你的值:
    1. API_TOKEN:你的 Multilogin API 令牌
    2. folder_id、profile_id:按照 DevTools(适用于图形界面)或 Postman 指南查找这些值
  2. 将以下代码行中的 https://multilogin.com/ 替换为目标网站:
await page.goto("https://multilogin.com/");

需要配置文件 ID?可以直接从 Multilogin 界面复制。步骤请参见:如何在 Multilogin 中复制配置文件 ID。

运行脚本

  1. 启动应用,这样才能启动配置文件
  2. 使用与当前 Mimic 内核所用 Chromium 版本兼容的 Puppeteer 版本。内核更新后,如果 Puppeteer 无法连接,请先检查当前 Mimic 内核与 Puppeteer 的兼容性,再修改脚本。
  3. 运行包含自动化代码的.js文件

    确保自动化代码与 package.json 文件位于同一文件夹或项目中。

脚本示例

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

预期结果:Multilogin 启动所选的 Mimic 浏览器配置文件,Puppeteer 连接其返回的自动化端口,打开目标网页,并将 example.png 保存到项目文件夹。

问题排查

为什么 Puppeteer 无法连接配置文件?

请检查:

  • Multilogin 桌面应用正在运行
  • folder_id 和 profile_id 正确
  • 该浏览器配置文件使用 Mimic
  • 配置文件启动请求返回了有效的 data.port
  • 你的 API 令牌有效
  • 你的 Puppeteer 版本与当前 Mimic 内核兼容

为什么 Puppeteer 打开了另一个浏览器?

确保脚本使用 puppeteer.connect() 和 Multilogin 返回的端口,而不是单独启动一个 Puppeteer 浏览器。

随时掌握最新动态

获取最新动态,交流经验,了解实际使用场景。

获取产品更新Telegram频道向其他用户提问Telegram聊天查看使用场景Discord社区