Mbbrowser + Playwright 自動化：入門指南

如果說 Selenium 是經典的老將，Puppeteer 是輕量級的快手，那麼 Playwright 就是微軟出品的「下一代旗艦」，結合了兩者的長處。候鳥瀏覽器在 v7.8 版本正式支持 Playwright 引擎，讓您能在目前最強大的自動化框架上輕鬆管理成千上萬個帳號。

---

1. 什麼是候鳥指紋瀏覽器？（回顧）

指紋瀏覽器的核心價值：為每個帳號提供一個「獨立的數字身份」，讓目標平台無法偵測到您正在管理多個帳號。

每個候鳥環境都是獨立維護的：

隔離維度	說明
瀏覽器指紋	Canvas, WebGL, AudioContext, 字體, 插件等均獨立且隨機化。
代理 IP	每個環境配置不同的代理，不暴露真實 IP。
Cookie / 存儲	帳號數據完全隔離，永久保存登錄狀態。
User-Agent	可模擬 Windows, Mac, iPhone 等任何設備。
時區 / 語言	與代理 IP 地理位置匹配，規避時區偵測。

---

2. 什麼是 Playwright？為什麼選擇它？

Playwright 是微軟在 2020 年推出的開發原始碼瀏覽器自動化框架，目前是前端自動化領域增長最快的框架。

Playwright 的核心優勢

優勢	說明
自動等待 (Auto-waiting)	內置智能等待機制，大多數操作前無需手動寫 sleep，它會自動等待元素可交互。
Locator API	全新的 Locator API 比傳統選取器更穩定，支持自動重試，抗動態內容性強。
網絡攔截	輕鬆攔截、修改和模擬任何網絡請求，方便繞過驗證或調試接口。
官方多語言支持	官方維護 JavaScript, Python, Java, C#, .NET 綁定。
多標籤頁 / 多上下文	原生支持跨標籤頁操作和上下文隔離，非常適合多帳號場景。
速度極快	通過 CDP 協議直接控制瀏覽器，響應速度比 Selenium WebDriver 快 30-50%。

三大引擎橫向對比

維度	Puppeteer	Selenium	Playwright (推薦)
支持語言	主要是 Node.js	Python/Java/JS 等	JS/Python/Java/C#/.NET
連接方式	WebSocket 協議	debuggerAddress	CDP (ws_endpoint)
自動等待	手動 waitForSelector	有限的顯式等待	內置，默認開啟
網絡攔截	基礎支持	幾乎沒有	強大，支持修改響應
選取器穩定性	中	中	高 (Locator 自動重試)
社區活躍度	高	極高	高且增長極快 (微軟)
候鳥支持度	✅ 全面支持	✅ 全面支持	✅ v7.8 新增，全面支持

---

3. 候鳥 + Playwright 如何協同工作？

技術架構鏈

您的腳本 (JS / Python / Java)
        ↓ HTTP 請求 (告訴候鳥：開啟哪個環境)
候鳥 ApiServer (apiserver.exe)
        ↓ 返回 WebSocket 地址 (ws://127.0.0.1:端口/devtools/browser/ID)
Playwright  chromium.connectOverCDP(ws_endpoint)
        ↓ 通過 CDP 協議「接管」內核
候鳥指紋環境 (指紋+代理+Cookie 全就緒)
        ↓ 帶著真實指紋發起請求
      目標網站 (感知為真實用戶訪問)

關鍵入口：connectOverCDP

這是候鳥 + Playwright 的核心方法。與普通的 Playwright 啟動新瀏覽器進程不同，我們使用 connectOverCDP 來接管已經運行的候鳥實例：

// 普通 Playwright (啟動新瀏覽器，無指紋) ❌
const browser = await chromium.launch();

// 候鳥 + Playwright (接管指紋環境) ✅
const browser = await chromium.connectOverCDP("ws://127.0.0.1:9223/...");

---

4. 多語言支持

候鳥官方對 Playwright 的支持涵蓋了三種主流語言：

JavaScript / TypeScript (Node.js)

const { chromium } = require('playwright');
const browser = await chromium.connectOverCDP(ws_endpoint);

✅ 原生支持，性能最佳，用法與 Puppeteer 相似。

Python

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp(ws_endpoint)

✅ Python 開發者的首選，候鳥會自動處理 Python 虛擬環境。

Java

import com.microsoft.playwright.*;
Browser browser = playwright.chromium().connectOverCDP(ws_endpoint);

✅ 企業級 Java 開發者可直接上手，候鳥會自動處理驅動提取。

---

5. 典型業務場景

• 🛍️ 電商多店鋪：管理 Amazon, Shopee, Lazada 等賣家帳號。
• 📱 社交媒體矩陣：TikTok, Twitter, Instagram 自動發帖、互動與監控數據。
• 🔐 自動登錄維護：定期登錄保持帳號活躍度。
• 🧪 大量表單提交：批量註冊、問卷填寫。
• 📊 數據採集：登錄後的後台數據抓取與報表導出。
• 🌐 網絡調試：攔截和修改請求以模擬特定場景。

---

TIP

準備好了嗎？下一章 環境準備與 ApiServer 將帶您一步步安裝所有必要環境。選擇您的語言，最快 10 分鐘即可跑通第一個腳本！