API获取浏览器实时信息

API获取浏览器实时信息

功能概述

新版本增加了以下功能:

1.每个浏览器分配唯一的端口标识符(从9230开始,仅作为ID)

2.浏览器运行状态管理(0暂停、-1停止、1正常)

3.API接口获取浏览器详细信息

4.全局快捷键控制浏览器状态


端口标识符说明

1.每个创建的浏览器都会分配一个从 9230 开始的端口标识符

2.这个端口仅作为浏览器ID,不是真实的服务端口

3.实际的CDP控制仍然通过统一端口 9220 进行

4.端口标识符按创建顺序递增:9230, 9231, 9232, ...


运行状态说明

API 接口

获取浏览器信息

请求方式: GET

请求地址: http://localhost:9999/api/browser?port={portId}

参数说明:http://localhost:9999/api/browser(这个接口可以获取所有浏览器)

  • port: 浏览器端口标识符(9230+)

响应示例(成功):

响应示例(失败):

字段说明:

  • accountId: 账号唯一标识
  • status: 浏览器状态(1正常/0暂停/-1停止)
  • url: 当前页面URL
  • title: 当前页面标题
  • platform: 平台类型(抖音/小红书/拼多多等)
  • portId: 端口标识符
  • runningState: 运行状态(1正常/0暂停/-1停止)
  • controlPort: CDP控制端口(固定9220)
  • isVisible: 是否当前可见
  • controlAvailable: 是否可控制

全局快捷键

注意:

  • 快捷键只对当前活动的浏览器有效
  • 状态变化会在界面上实时反映
  • 快捷键在整个应用范围内有效


使用示例

运行测试脚本检查API功能:

这个脚本会:

  1. 测试端口9230-9234的浏览器信息获取
  2. 显示每个浏览器的详细信息
  3. 提供使用指南和新格式示例


注意事项

  1. 端口标识符仅为ID:9230+端口不是真实服务端口,仅用于标识浏览器
  2. CDP统一端口:所有浏览器的CDP控制都通过端口9220
  3. 状态持久化:浏览器状态在应用重启后会重置为正常状态
  4. 快捷键范围:全局快捷键在整个系统范围内有效
  5. API可用性:API服务器运行在端口9999,确保端口未被占用
  6. 返回格式:成功时直接返回浏览器信息对象,失败时返回错误对象


← 返回文档列表