環境準備與配置

在開始編寫自動化腳本之前，您需要確保本地開發環境已準備好。

1. 安裝 Node.js

Puppeteer 是一個 Node.js 庫。請前往 Node.js 官網 下載並安裝 LTS (長期支持) 版本。

安裝完成後，在終端中檢查版本：

node -v
npm -v

2. 啟動 ApiServer

ApiServer 是候鳥瀏覽器的「自動化門戶」。

1. 進入候鳥瀏覽器的安裝目錄。
2. 找到 ApiServer.exe 並雙擊運行。
3. 默認情況下，它會在 127.0.0.1:8186 監聽。您可以在窗口中看到實時日誌。

3. 初始化項目

在您的工作目錄下執行以下命令：

# 創建文件夾
mkdir mbbrowser-auto && cd mbbrowser-auto

# 初始化項目
npm init -y

# 安裝核心依賴
npm install puppeteer-core axios

NOTE

為什麼安裝 puppeteer-core 而不是 puppeteer？ 因為 puppeteer 會額外下載一個體積龐大的 Chrome 內核，而我們只需要控制候鳥自帶的高性能內核，所以使用輕量級的 core 版本即可。

4. 獲取環境 ID (Session ID)

在候鳥客戶端中，每個配置好的環境都有一個唯一的 ID。您可以在環境列表中找到它，或者通過 /api/v1/browser/list 接口動態獲取。

---

TIP

配置完成？現在前往 快速開始 編寫您的第一個腳本！