从本地 API 到 MCP：把指纹浏览器接进自动化流水线

本地 HTTP API、Playwright/CDP 与 MCP 三种接入方式如何分工，五个自动化模块各管什么，以及一批任务怎样稳定跑完、失败后怎么查。

来源：无界指纹浏览器 2026-10-20 约 5 分钟阅读

无界指纹浏览器提供三种自动化接入方式：本地 HTTP API、MCP 与 Playwright/CDP。三者围绕同一批环境工作，区别只在调用形式与适合的工具链，可以按团队现有技术栈选择，也可以组合使用，不需要把浏览器控制权暴露到公网。

无论选择哪一种，客户端都必须保持运行，环境必须处于已启动状态。自动化脚本负责的是「调度与操作」，环境的创建、代理与指纹配置仍然在客户端内完成。

三种方式怎么选

本地 HTTP API：接入内部系统、批量启停环境、查询状态；仅监听回环地址，不要映射到公网；
Playwright / CDP：页面自动化、数据采集、流程回归；通过 CDP 调试端点连接已启动的浏览器；
MCP：让支持该协议的 AI 客户端调用浏览器工具；按客户端内提供的配置片段连接本机服务。

选择时先看任务形态：只需要启动环境、跑脚本、关环境，用本地 API 加 Playwright 的组合最直接；希望由 AI 客户端发起操作，再引入 MCP。三者并不互斥，同一条流水线里经常同时出现。

本地 API 的边界

客户端在本机启动 HTTP API，默认地址是 http://127.0.0.1:50325。该服务仅监听回环地址，外部网络无法直接访问。使用前需要在客户端设置中确认本地 API 已开启，并保持客户端运行。

适合把环境启动、状态查询与关闭接入内部工具；
请求与响应均为本地通信，不经过云端；
可以按环境标识查询运行状态，作为任务前置检查；
接口清单与字段说明以客户端内展示的 API 文档为准，不要凭记忆拼接路径。

接入时有两点容易忽略：一是请求要设置合理的超时，环境启动本身需要时间，超时过短会把正常启动误判为失败；二是调用方要处理客户端未启动、端口被占用、环境已被其他任务占用等返回结果，而不是只判断成功。

Playwright 与 CDP

环境启动后可以返回调试连接信息，Playwright 通过 CDP 连接到已启动的浏览器实例：

from playwright.sync_api import sync_playwright

# ws_endpoint 由本地 API 的启动结果提供
with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp(ws_endpoint)
    page = browser.contexts[0].pages[0]
    page.goto("https://example.com")
    browser.close()

已有 Chrome 自动化体系也可以直接使用 CDP 调试端点接入，不必重写脚本结构。脚本编写建议：