Hivebrowser 文档

把真实浏览器能力接进生产系统

用托管 Chromium 会话完成登录态抓取、可视化验证、产物生成和 AI 智能体浏览器动作。先在调试台验证，再把稳定工作流迁移到 API。

入门路径

三条最短路径

按目标进入文档，不需要先理解整个平台架构。

从 API 密钥开始，启动第一个托管 Chromium，并用 Playwright 或 Puppeteer 连接。

在调试台里验证目标网站、选择器、超时、截图和多页爬取边界。

用浏览器档案保存 cookies、localStorage 和指纹配置，让重复任务不再从空白浏览器开始。

生产路径

接入路径保持短链路：先验证，再固化，再观测。

先用调试台验证目标页面、登录态、超时和输出格式；稳定后迁移到服务端代码，并把会话、产物和错误写回你的业务系统。上线后用会话详情、日志、回放、截图和 API 参考定位失败原因。

核心模型

应用侧关注运行结果；浏览器调度、连接路由和状态持久化由平台处理。

一个托管 Chromium 实例，提供 CDP 连接地址、生命周期状态和实时预览。

持久化 cookies、localStorage、代理和指纹配置，用于复用登录态。

会话生成的截图、PDF 或提取内容，可通过 API 查询和下载。

创建会话、管理档案、生成产物、查询用量的完整 REST API。

Hivebrowser 的边界很明确：你调用 API、连接 CDP、读取会话状态和产物；平台负责运行节点选择、浏览器启动、连接网关、档案同步和用量记录。