本地 HTTP API
通过本机回环地址调用环境启停、状态查询与任务接口。任何能发 HTTP 请求的语言都可以接入。
安全防护 · 开放 API
把浏览器环境接进自动化流水线
本地 HTTP API、Playwright/CDP 与 MCP 三种方式，围绕同一批环境工作。接口只监听 127.0.0.1，脚本不必把浏览器控制权暴露到公网。
- 仅监听本机回环地址
- 可复用现有 Playwright 脚本
- 支持定时任务与任务编排
Playwright本地 APIMCP
本机连接
# 连接信息由客户端在环境启动后返回 ws = "ws://127.0.0.1:50325/..." from playwright.sync_api import sync_playwright with sync_playwright() as p: browser = p.chromium.connect_over_cdp(ws) page = browser.contexts[0].pages[0] page.goto("https://example.com") page.click("#publish") # 环境、指纹与代理保持原配置
127.0.0.1:50325
端口与路径以客户端显示为准
任务已进入队列3 个环境 · 仅本机可访问
3种接入方式
本机回环地址调用
定时任务按计划运行
回环不占用公网端口
01三种接入方式
不是另起一套浏览器，而是接管已有环境
无论用接口、自动化框架还是 AI 工具，操作的都是客户端里已经配置好指纹与代理的环境，不需要在脚本里重新搭一套身份。
复用现有脚本
连接已启动环境的调试端点，沿用 Playwright 或 CDP 的页面操作方式，迁移成本更低。
接入 AI 工具链
让支持 MCP 的客户端发现浏览器能力，在同一批隔离环境里执行打开、检查与采集任务。
02工作方式
一条自动化流水线的四个环节
- 01
客户端保持运行
API 依附于本机客户端，先确认服务与端口已就绪。
- 02
启动目标环境
按环境 ID 启动浏览器，拿到调试端点或任务句柄。
- 03
脚本执行任务
用现有框架完成页面操作，环境身份沿用原配置。
- 04
结果与日志归档
记录任务结果、异常与截图，便于复盘和重跑。
03核心能力
把环境控制权交给脚本，而不是交给公网
接口、调试连接与任务系统都围绕本机环境工作，既能接入现有工具，也保留账号资产的边界。
本地 HTTP 接口
在回环地址提供环境启停、状态与任务接口，适合用任意语言编写调度脚本。
Playwright 与 CDP
连接已启动环境的调试端点，复用现有选择器、等待与断言逻辑，减少重写。
MCP 接入
把浏览器操作暴露给支持 MCP 的 AI 工具，在同一套环境上完成受控任务。
定时任务
按计划执行打开、保活、巡检等重复动作，减少人工盯守与漏执行。
任务编排
把多个环境的动作按顺序组织，异常时暂停并保留现场，便于人工接管。
凭据不写进脚本
账号凭据保存在本地加密空间，脚本通过环境访问，不把密码散落在代码里。
04边界与注意事项
先把这三件事处理好，再上生产脚本
自动化失败往往不是接口问题，而是客户端状态、端口占用或超时处理没有兜底。
客户端必须保持运行
接口依附于本机客户端。客户端退出或重启后，脚本需要重新获取连接信息。
先排查端口占用
端口被其他程序占用时，环境启动与连接会失败。以客户端设置里显示的实际端口为准。
脚本要处理超时
页面加载、弹窗与任务执行都可能超时。为等待设置上限，并为失败保留截图与日志。
05适用场景
把重复动作交给脚本，把判断留给人
多环境批量执行
按环境列表分发同一套上架流程，失败任务单独重跑，不影响其他环境。
定时查看页面状态
按计划打开指定页面，采集状态、订单或库存信息，异常时留下截图。
低频动作按计划执行
把打开、浏览、检查等动作安排到固定时间，减少人工逐个环境操作。
06常见问题
关于开放 API
API 地址是固定的 127.0.0.1:50325 吗？
客户端默认在本机回环地址提供接口。实际端口可能因设置或占用情况调整，以客户端内显示的服务地址为准，脚本不要写死未经确认的端口。
需要把端口暴露到公网吗？
不需要。接口仅监听本机回环地址，脚本与客户端在同一台机器上运行即可。不要把调试端口映射到公网。
多个脚本可以同时操作同一个环境吗？
不建议。同一环境被多个任务争用时，页面状态会互相干扰。应按环境拆分任务，或让同一环境的任务串行执行。
支持哪些编程语言？
本地 HTTP API 可以被任何能发请求的语言调用；Playwright 支持 JavaScript/TypeScript 与 Python 等官方绑定；MCP 则取决于所使用的客户端工具。
脚本失败了，从哪里开始排查？
先看客户端日志与任务状态，再检查环境是否成功启动、端口是否可连、页面是否加载完成。保留失败截图与任务 ID，便于定位是环境问题还是脚本逻辑问题。