环境搭建与 API 配置

在开始写第一行代码之前，我们需要准备好基础环境。

1. 安装 Node.js

Puppeteer 运行在 Node.js 环境中。

• 下载地址：前往 Node.js 官网 下载并安装 LTS 版本。
• 验证安装：打开终端或命令行，输入：

  node -v
  npm -v

  如果显示版本号，说明安装成功。

2. 安装 Puppeteer

在您的项目文件夹下，运行以下命令（推荐使用 puppeteer-core，因为它更轻量，且不需要下载额外的 Chromium，我们将使用候鸟自带的内核）：

npm install puppeteer-core

3. 开启候鸟 ApiServer

候鸟的 API 功能是通过 ApiServer.exe 实现的。

1. 找到文件：进入候鸟浏览器的安装主目录。
2. 获取鉴权信息：
   • 登录候鸟客户端。
   • 进入“个人中心” -> “API设置”。
   • 获取您的 APP_ID 和 APP_KEY。
3. 命令行启动： 在候鸟安装目录下，使用管理员权限打开终端，运行：

   apiserver.exe --port=8186 --app_id=您的ID --app_key=您的KEY --hide=off

   • --port: 接口监听端口（默认 8186）。
   • --hide=off: 如果你想看到浏览器窗口运行，请设为 off。

4. 获取接口文档

ApiServer 启动后，您可以访问 http://127.0.0.1:8186/ 查看所有可用的 HTTP 接口列表。

IMPORTANT

自动化过程中，请务必保持 ApiServer.exe 终端窗口不要关闭。

---

TIP

环境准备就绪？下一章 快速上手：接管候鸟环境 教你写第一个脚本。