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 及以上套餐
连接的工作方式
- 脚本使用 浏览器配置文件参数
automation_type=puppeteer启动 Multilogin 配置文件 - Multilogin 在
data.port中返回自动化端口 - 脚本构建
http://127.0.0.1:<port> puppeteer.connect()连接已运行的 Multilogin 配置文件- Puppeteer 随后即可打开网页并执行浏览器操作
开始之前
- 从官方网站下载并安装 Node.js
- 确保已正确安装 Node.js 和 npm(Node Package Manager):
node -v
npm -v- 创建项目目录,然后运行此命令初始化新的 Node.js 项目并创建
package.json文件:
npm init -y- 为项目安装 Puppeteer 依赖:
npm install puppeteer- 安装 Axios:
npm install axios- 在脚本的以下变量中填入你的值:
- 将以下代码行中的
https://multilogin.com/替换为目标网站:
await page.goto("https://multilogin.com/");需要配置文件 ID?可以直接从 Multilogin 界面复制。步骤请参见:如何在 Multilogin 中复制配置文件 ID。
运行脚本
- 启动应用,这样才能启动配置文件
- 使用与当前 Mimic 内核所用 Chromium 版本兼容的 Puppeteer 版本。内核更新后,如果 Puppeteer 无法连接,请先检查当前 Mimic 内核与 Puppeteer 的兼容性,再修改脚本。
- 运行包含自动化代码的
.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 浏览器。