360 Secure SkillHub
360 安全技能中心

Local Browser Manager

通过本地多账号矩阵管理工具启动或关闭指定账号的浏览器实例，获取 CDP 端口后用 Playwright 连接，执行导航、点击、输入、截图等自动化操作，并提供端口配置与配置查看命令；依赖本地 HTTP 服务与 Playwright。

wociaozhongyunonghaole
wociaozhongyunonghaole
热度 29.71
最近更新 2026-03-30 14:29:08
分类：自动化依赖：代码执行 / 联网浏览搜索 / 第三方 API应用场景：自动化脚本 / 工作流 / API 集成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add local-browser-manager
Metadata
name
local-browser-manager
version
1.0.0
description
本地浏览器账号管理工具。用于启动本地多账号管理工具中的浏览器实例，支持自动化测试操作。仅限本地localhost通信，不连接外部网络。MIT开源许可证。

本地浏览器账号管理工具

本地浏览器账号启动与管理工具，整合多账号管理和浏览器CDP控制功能。

安全声明

  • 仅本地通信：本工具仅与本地多账号管理工具通信 (localhost:1008)，不连接任何外部网络
  • 开发测试用途：专用于合法的浏览器自动化测试和开发场景
  • 开源透明：MIT 许可证，代码完全开源可查
  • 安全设计：仅连接已授权的本地浏览器实例，不执行未授权操作

功能特性

  1. 账号管理：启动、关闭、查询多账号工具中的账号
  2. 自动连接：启动后自动获取端口并连接浏览器
  3. 浏览器控制：支持导航、点击、输入、截图等操作
  4. 独立环境：每个账号运行在独立的浏览器环境中

使用方法

1. 启动并自动连接浏览器

python scripts/manager.py --start --account "654645645"

这会：

  • 启动指定账号的浏览器
  • 自动获取端口号
  • 通过CDP连接到浏览器

2. 执行浏览器操作

# 导航到URL
python scripts/manager.py --account "654645645" --goto "https://example.com"

# 截图
python scripts/manager.py --account "654645645" --screenshot "page.png"

# 点击元素
python scripts/manager.py --account "654645645" --click "#button-id"

# 输入文本
python scripts/manager.py --account "654645645" --fill "input[name='q']" "search text"

3. 关闭浏览器

python scripts/manager.py --stop --account "654645645"

4. Python API

from scripts.manager import AccountManager

manager = AccountManager()

# 启动并连接
browser, page, port = manager.launch_and_connect("654645645")

# 执行操作
page.goto("https://example.com")
page.screenshot(path="screenshot.png")
page.fill("input[name='q']", "search")
page.click("button[type='submit']")

# 关闭
manager.stop_account("654645645")

配置

修改默认端口

python scripts/manager.py --set-port 1009

查看配置

python scripts/manager.py --show-config

依赖

requests>=2.25.0
playwright>=1.40.0

安装 Playwright 浏览器：

playwright install chromium

注意事项

  1. 确保多账号矩阵管理工具已启动并开启HTTP服务
  2. 首次使用需要安装 Playwright 浏览器
  3. 每个账号运行在独立的端口和浏览器环境
  4. 软件官网介绍页：https://zmt.scys6688.com/

启动后浏览器信息说明

当使用 --start 参数启动浏览器后，工具会自动获取并返回以下浏览器信息：

返回信息字段

字段名 说明 示例值 用途
端口占用 / 端口 浏览器CDP调试端口 "35247" 最重要 - 用于连接和控制浏览器
进程id 浏览器进程ID "38312" 用于进程管理、监控
唯一id 账号唯一标识 "VJZYMKCDVP" 区分不同账号实例
指纹环境 浏览器User-Agent "Mozilla/5.0..." 了解浏览器环境配置
ck路径 Cookie文件路径 ".\软件缓存\ck\..." 读取/管理Cookie
账号名 账号显示名称 "654645645" 账号识别
分组 所属分组 "默认分组" 分组管理

如何使用端口控制浏览器

步骤1：获取端口号 启动后从返回数据中获取 端口 字段的值，如 35247。

步骤2：构建CDP连接地址

http://127.0.0.1:35247

步骤3：使用Playwright连接

from playwright.sync_api import sync_playwright

port = "35247"  # 从启动返回信息中获取
cdp_url = f"http://127.0.0.1:{port}"

with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp(cdp_url)
    page = browser.new_page()
    
    # 现在可以控制浏览器了
    page.goto("https://example.com")
    page.screenshot(path="screenshot.png")
    
    browser.close()

步骤4：执行浏览器操作 获得 page 对象后，可以执行：

  • page.goto(url) - 导航到指定网址
  • page.click(selector) - 点击元素
  • page.fill(selector, text) - 输入文本
  • page.screenshot(path) - 截图
  • page.evaluate(js_code) - 执行JavaScript

完整示例流程

# 1. 启动浏览器并获取信息
python scripts/manager.py --start --account "654645645"
# 输出: 浏览器已启动，端口: 35247

# 2. 使用该端口进行CDP连接（在其他脚本或技能中）
# CDP地址: http://127.0.0.1:35247

# 3. 完成操作后关闭浏览器
python scripts/manager.py --stop --account "654645645"

注意事项

  • 端口唯一性：每个账号启动后都有独立的端口号，不会冲突
  • 端口生命周期：浏览器关闭后，该端口会被释放
  • 本地连接：CDP连接仅限本地 (127.0.0.1)，不对外开放
  • 进程管理：可通过 进程id 在系统中查看和管理浏览器进程

许可证

MIT License - 详见 LICENSE 文件