快速开始 | Hivebrowser 文档

目标先证明托管浏览器可控

输出会话 ID 和页面标题；浏览器运行在 Hivebrowser 托管环境中。

路径只跑一条最短链路

创建 API 密钥、启动会话、通过 CDP 连接 Playwright，然后显式停止会话。

边界示例只放服务端运行

API 密钥只放后端、Worker 或任务队列；前端页面不应该直接调用这些示例。

准备工作

你需要一个 Hivebrowser 账号、Node.js 20+ 服务端运行环境，以及只保存在服务端环境变量或密钥管理系统中的 API 密钥。示例代码只应运行在后端、Worker 或任务队列，不要放到浏览器前端。

1. 获取 API 密钥

在 hivebrowser.ai 注册账号，然后进入控制台 API 密钥页面创建一个 API 密钥。所有 API 请求都需要这个密钥。

export HIVEBROWSER_API_KEY="hb_your_api_key_here"

2. 安装依赖

npm install playwright-core

3. 创建并连接会话

通过 API 创建一个浏览器会话，然后用 Playwright 连接：

import { chromium } from 'playwright-core';

const API = 'https://api.hivebrowser.ai';
const API_KEY = process.env.HIVEBROWSER_API_KEY;

// 创建会话
const res = await fetch(`${API}/v1/sessions`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    timeoutSec: 300,
  }),
});

const { data: session } = await res.json();
console.log('会话已创建：', session.id);

// 通过 Playwright 连接
const browser = await chromium.connectOverCDP(session.connectUrl);
const context = browser.contexts()[0];
const page = context.pages()[0] || (await context.newPage());

await page.goto('https://example.com');
console.log('页面标题：', await page.title());

// 清理资源
await browser.close();
await fetch(`${API}/v1/sessions/${session.id}/stop`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${API_KEY}` },
});