环境搭建与 ApiServer 配置

在写第一行 Selenium 代码之前，我们需要配齐以下三样：Python 运行环境、Selenium 库和候鸟 ApiServer。全程大约 10 分钟。

---

第一步：安装 Python

Selenium 的 Python 绑定需要 Python 3.8 以上版本。

下载安装

1. 前往 Python 官网 下载 3.10 或 3.11 LTS 版本（推荐）
2. 安装时务必勾选：
   ✅ Add Python to PATH（不勾这个，之后所有命令都会报错！）
3. 安装完成后，打开 命令提示符（CMD） 验证：

python --version   # 应输出 Python 3.10.x 或更高版本
pip --version      # 应输出 pip 的版本信息

NOTE

如果 Windows 下 python 命令没反应，请在 系统环境变量 → Path 中手动添加 Python 安装目录（如 C:\Python310\ 和 C:\Python310\Scripts\）。

---

第二步：安装 Selenium 库

在 CMD 或 PowerShell 中运行：

pip install selenium requests

• selenium：核心自动化库
• requests：用来调用候鸟的 ApiServer HTTP 接口

关于 ChromeDriver（重要！）

Selenium 4.6+ 内置了 Selenium Manager，会自动下载匹配您候鸟浏览器版本的 ChromeDriver。

但候鸟使用的是定制 Chrome 内核，版本可能和官方 Chrome 不同，请按以下步骤处理：

方式 A（推荐）：使用候鸟安装目录自带的 chromedriver

候鸟安装目录下通常有 chromedriver.exe，路径类似：

C:\Program Files (x86)\Mbbrowser_vX.X.X\chromedriver.exe

在代码中直接指定路径（详见下一章）。

方式 B：手动下载

1. 登录候鸟客户端，查看"帮助 → 关于"，记录内核版本（如 Chrome 140）
2. 前往 Chrome for Testing 下载相同版本的 chromedriver
3. 将 chromedriver.exe 放到您的项目目录或 PATH 中

---

第三步：开启候鸟 ApiServer

候鸟暴露给外部脚本的接口是通过 ApiServer.exe 实现的。

IMPORTANT

必须先开启 ApiServer，脚本才能和候鸟通信！ 请勿关闭 ApiServer 的终端窗口。

获取 API 鉴权信息

1. 打开候鸟客户端，确保已登录
2. 点击左上角菜单 → 个人中心 → API 设置
3. 记录您的 APP_ID 和 APP_KEY（如果没有，点击"生成"）

启动 ApiServer

用管理员权限打开 CMD，进入候鸟安装目录，运行：

apiserver.exe --port=8186 --app_id=YOUR_APP_ID --app_key=YOUR_APP_KEY --hide=off

参数说明：

参数	说明	默认值
--port	ApiServer 监听的端口	8186
--app_id	您的鉴权 ID（从候鸟个人中心获取）	-
--app_key	您的鉴权密钥	-
--hide=off	off 表示浏览器窗口可见（便于调试），on 表示无头模式	off

启动成功后，CMD 窗口会显示类似：

ApiServer started at http://127.0.0.1:8186

验证 ApiServer 是否正常

在浏览器或 Postman 中访问：http://127.0.0.1:8186/，如果能看到 API 文档页面，说明启动成功。

---

第四步：获取环境的 Session_ID

每个候鸟环境都有一个唯一的 Session_ID，格式是 32 位十六进制字符串（如 373808cb37bd63f5f7d92415e736e85f）。

获取方法：

1. 在候鸟主面板找到您要操作的环境
2. 右键点击该环境 → 复制环境 ID（Session_ID）

---

第五步：项目目录结构推荐

建议在电脑上创建一个清晰的项目文件夹：

my-mbbrowser-selenium/
├── start_selenium.py     ← 主脚本
├── config.py             ← 配置文件（存放 API_URL、SESSION_ID 等）
├── utils.py              ← 公共工具函数（启动环境、截图等）
└── requirements.txt      ← 依赖清单

requirements.txt 内容：

selenium>=4.15.0
requests>=2.31.0

其他成员安装依赖只需：

pip install -r requirements.txt

---

环境搭建自检清单

在进入下一章之前，确认以下各项都已就绪：

• [ ] Python 3.8+ 已安装，python --version 正常输出
• [ ] pip install selenium requests 完成
• [ ] 找到候鸟安装目录中的 chromedriver.exe 路径（已记录）
• [ ] ApiServer 已正常启动，能访问 http://127.0.0.1:8186/
• [ ] 已获取到目标环境的 Session_ID

---

TIP

全部准备完毕？下一章 快速上手：接管候鸟环境 带您写出第一个能跑起来的完整脚本！