BroSDK 指纹浏览器 SDK

把独立浏览器环境接入你的产品。指纹、代理、Cookie、内核与自动化控制，共用同一套 envId 模型。

阅读快速开始 查看 GitHub
Windows / macOS / Linux Chrome 环境 / 指纹 / 代理 / 会话 SDK / HTTP / CDP / MCP
BroSDK Dashboard Demo · 环境管理 开源参考实现
基于 BroSDK 构建的 Dashboard Demo，展示环境状态、CDP、代理和环境操作

从 API Key 到持久化环境，四步完成核心闭环

BroSDK 以 envId 贯穿应用初始化、环境配置、浏览器运行和数据保存。每一步都有明确接口、状态与事件。

跟随快速开始接入
01 / INIT

初始化应用

在控制台创建应用并获取 API Key，初始化本地 Runtime。应用配置还可控制自定义 Logo 与浏览器内核自动更新。

sdk_init · API Key
准备动态库 / 工作目录 / APP 配置
02 / ENV

创建与配置环境

按 envId 创建、更新、查询和销毁环境，并配置平台、内核版本、代理和指纹参数；可先查询各字段的可选值。

/sdk/v1/env/create · /sdk/v1/env/update
模型环境 / 指纹 / 代理 / 内核
03 / OPEN

启动并连接浏览器

启动时可传入 URL、Cookie、扩展、Chromium 参数和临时 forward。收到启动成功事件后，再通过 CDP、Playwright 或 Puppeteer 连接。

/sdk/v1/browser/open
就绪browser-open-success · CDP ready
04 / CLOSE

关闭并持久化数据

关闭环境后提取 Cookie 与 Storage 快照。自托管写入本地；全托管在本地持久化后进入云端同步，回调与事件用于追踪全过程。

/sdk/v1/browser/close
完成browser-close-success · 本地持久化完成

用开源参考 Demo 验证 BroSDK 的能力

BroSDK Dashboard 是基于 SDK 构建的参考 Demo，以可运行界面展示环境管理、Runtime 状态、MCP 与 AI Agent 接入。你可以查看源码，再把对应能力组合进自己的产品。

调用同一套 SDK 环境、指纹、代理、内核和浏览器操作均来自 BroSDK。
实现路径可参考 源码展示 Runtime 状态、事件回调和 MCP 工具调用。
BroSDK Dashboard MCP 与 Agent Demo，展示固定环境范围、自动执行模式、MCP 工具参数与执行步骤

Agent Demo：查看 MCP 工具的完整调用过程

示例会话固定全局或单环境范围，展示工具名称、调用参数、执行状态与结果，便于参考 Agent 接入方式。

查看 Demo 源码 阅读快速开始

按宿主系统选择接入层，环境模型保持一致

桌面客户端、业务服务和 AI Agent 可以使用不同入口，但都围绕同一个 envId 操作环境与浏览器生命周期。

01 / NATIVE

原生 SDK

通过统一 C ABI 嵌入桌面客户端或本地服务，多语言封装负责类型转换，底层运行时与事件语义保持一致。

接入端
C++ / Rust / TypeScript / Python / Go
入口
brosdk.dll / .dylib / .so
结果
异步结果回调、事件码与错误码
查看原生集成
02 / HTTP

本地 HTTP API

已有 ERP、CRM 或自动化服务可直接调用本地接口，无需把浏览器运行时逻辑重新封装到每一种业务语言。

接入端
业务后台 / 脚本 / 本地服务
入口
/sdk/v1/env/* · /sdk/v1/browser/*
模型
与原生 SDK 共用 envId 和环境配置
查看接口参考
03 / MCP

MCP Server

通过 brosdk-mcp-go 把环境管理、浏览器打开与录制回放能力暴露为工具，让 MCP 客户端按明确范围调用。

接入端
AI Agent / MCP Client
入口
brosdk-mcp-go
事件
SSE 返回异步进度与最终结果
查看 MCP 指南

按数据边界选择部署方式

本地自托管强调数据主权，全托管强调跨节点同步。接口能力和环境模型保持一致。

本地数据边界

自托管 Self-Hosted

SDK 本地化部署，Cookies、LocalStorage 和浏览器数据仅保存在本地，不上传云端。

  • 环境数据不经过第三方，数据边界清晰
  • 适合高频启动与隐私敏感业务
  • 环境启动 ¥0.01 / 次，内网流量免费
云端状态同步

全托管 Fully-Managed

环境数据由云端托管，切换机器或扩容节点后自动同步 Cookie、LocalStorage 与登录状态。

  • 浏览器状态自动同步和还原
  • 适合弹性扩容与多节点调度
  • 无需重新登录或手动导入数据

消耗明细

接口 / 服务 自托管单价 全托管单价
环境创建 ¥ 1.00 / 次 ¥ 1.00 / 次
环境启动 ¥ 0.01 / 次 ¥ 0.01 / 次
云端流量 免费（内网） ¥ 0.01 / MB

开始接入 BroSDK

注册即赠新手体验额度，企业接入可预约架构评估。

免费注册 预约演示