Local API 怎么用:一个 HTTP 请求拉起指纹环境,Puppeteer 直接接管
脚本本身没问题,问题是它跑在一个没有指纹、没有登录态、所有账号共用一个出口的裸浏览器里。NexBrowser 把环境这一层做成了标准接口:一次本地 HTTP 调用启动指定环境,返回调试端口,你熟悉的框架照常连上去。接口随客户端开放,免费、不限调用次数,免费档账号一样能用。
Local API 免费开放、不限调用次数,免费档账号同样可用。
Local API免费不限调用
POST http://127.0.0.1:port/browser/start
{ "envId": "Store-US-01" }
200 OK
{ "ws": "ws://127.0.0.1:9222/devtools/...",
"debugPort": 9222 }Selenium / Puppeteer / Playwright直接接管
调用次数不限
自动化跑不起来,多半卡在环境这一层
下面四件事几乎是每个写过采集或批量脚本的人都踩过的坑,它们都不是代码水平的问题。
脚本一上线就被识别
Selenium 启动的浏览器带着一堆自动化特征,navigator.webdriver、缺失的插件列表、异常的字体与 Canvas 组合,页面还没加载完就已经被判定成机器人。
自动化接口按套餐卖
想用 API 先升级套餐,升级完还有每日调用上限。批量任务跑到一半被掐断,重跑一次又要重新计费,成本完全不可控。
登录态每次都要重来
脚本每次拉起干净浏览器,Cookie 全空。跑之前先过一遍登录、验证码、二次验证,几十个账号排下来,真正的业务逻辑反而只占一小部分时间。
环境只能人工点开
没有接口就没法编排:要跑任务得先有人手动打开客户端、逐个双击环境。CI 里跑不了,凌晨的定时任务也得有人守着。
自动化接入,别再卡在接口这一步
以往的做法
- 自动化接口按套餐售卖,想调用先升级
- 调用次数每日限额,批量任务跑一半被掐断
- 文档缺失,环境只能靠人工点开
- 脚本自带自动化特征,落地页第一跳就被拦
使用 NexBrowser 后
- Local API 完全免费,调用次数不设上限
- 一次请求拉起环境,直接返回调试端口
- Selenium、Puppeteer、Playwright 原样接管
- 指纹、代理与登录态由环境负责,脚本只写业务逻辑
开发者要的能力,一个都不少
从环境启动到 AI 智能体接入,全流程都能用代码跑通。
免费不限调用
接口随客户端开放,不额外收费、不限调用次数,免费版也能跑通完整自动化链路。
兼容主流自动化框架
返回标准调试端口,Selenium、Puppeteer、Playwright、WebDriver 无需改写既有脚本。
程序化管理环境生命周期
启动、关闭、查询运行状态全部走接口,批量任务可按需拉起与回收环境。
对接 AI Agent 与企业系统
可接入 browser-use、Playwright MCP 等智能体框架,也能嵌入内部系统与 CI 流程。
指纹浏览器 API 怎么用:一次请求拉起环境,拿到调试端口
调用流程只有三步,也只需要知道三件事。第一,客户端在本机监听一个 HTTP 端口,接口地址形如 http://127.0.0.1:port/browser/start,端口号在客户端设置里能看到。第二,请求体里给出要启动的环境 ID,这个环境的指纹参数、代理绑定、Cookie 目录会自动加载,不需要你在脚本里再配一遍。第三,响应里返回该环境的调试端口与 WebSocket 地址,接下来就是标准的 CDP 接管。
环境的生命周期也全部走接口:启动、关闭、查询运行状态都有对应调用,批量任务可以按需拉起再回收,跑完就关,不占窗口。接口免费开放且不限调用次数,所以完全可以在循环里放心地起停环境,不用担心某一天突然撞上配额。
- 一次 POST 启动指定环境,指纹与代理配置自动加载
- 响应返回调试端口与 WebSocket 地址,直接用于 CDP 接管
- 启动、关闭、查询状态全部走接口,批量任务按需拉起与回收
Local API免费不限调用
POST http://127.0.0.1:port/browser/start
{ "envId": "Store-US-01" }
200 OK
{ "ws": "ws://127.0.0.1:9222/devtools/...",
"debugPort": 9222 }Selenium / Puppeteer / Playwright直接接管
调用次数不限
selenium 被检测、playwright 反检测:问题通常不在脚本里
把 Selenium 或 Playwright 直接指向本机 Chrome,被拦下来几乎是必然:自动化启动参数、navigator.webdriver 标志、缺失的插件与权限列表、和真实用户对不上的字体与 Canvas 组合,再加上二十个账号共用一个出口 IP 和一套指纹。这些信号和你脚本写得好不好没有关系,它们属于环境层。
换成 Local API 之后分工就清楚了:环境层负责「像一台真实设备」——真实 Chrome 内核、20 多项彼此自洽的指纹参数、独立数据目录、各绑各的住宅代理、长期保留的登录态;脚本层只负责业务逻辑,翻页、取数、填表。你原来的 Selenium 或 Playwright 代码基本不用改,把连接目标从自己启动的浏览器换成接口返回的调试端口即可。
- 自动化特征、指纹一致性与出口 IP 属于环境层,改脚本解决不了
- 真实 Chrome 内核 + 20+ 项自洽指纹参数,每个环境各绑各的代理
- 既有 Selenium/Playwright 脚本无需重写,改连接目标即可
Canvas独立噪声
WebGL / 显卡按环境生成
字体列表按系统匹配
时区 / 语言随出口 IP
WebRTC按环境配置
Audio / 屏幕独立取值
把浏览器环境接进自有系统、CI 与 AI Agent
接口化之后,浏览器环境就成了你系统里的一个普通组件。内部工单系统可以在某个状态变更时自动拉起对应店铺的环境跑一段检查;CI 流水线可以在每次发版后用真实指纹环境跑一遍端到端用例;调度系统可以在凌晨低峰期批量起停几十个环境采数据,跑完自动回收。
AI Agent 也是同一条路径。browser-use、Playwright MCP 这类框架本身就通过调试端口操作浏览器,把目标换成 NexBrowser 返回的端口,智能体就从一个裸浏览器换到了带指纹、带代理、带登录态的真实环境里。不想写代码的部分,交给客户端内置的无代码 RPA,两条路可以在同一批环境上混用。
- 内部系统、调度任务与 CI 流水线都能直接调用,无需人工开客户端
- browser-use、Playwright MCP 等 Agent 框架通过调试端口直接接管
- 不写代码的部分交给无代码 RPA,两种方式可在同一批环境上混用
你说
把这 24 个店铺的首图标题按新模板改一遍,改完给我一份清单。
生成的流程可保存复用
执行范围仅授权环境
下载客户端,十分钟接通第一个环境
Local API 免费开放、不限调用次数,免费档账号同样可用。
两段代码跑通:启动环境并用 Puppeteer 接管
下面是一次完整调用:先用 fetch 请求本地接口拉起环境,拿到响应里的调试端口,再用 Puppeteer 连上去。Selenium、Playwright、WebDriver 的写法不同,思路完全一样。
Node.js 示例免费不限调用
import puppeteer from 'puppeteer-core'; // 1) 启动指定环境:该环境的指纹、代理与 Cookie 目录会自动加载const res = await fetch('http://127.0.0.1:PORT/browser/start', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ envId: 'Store-US-01' }),});const { debugPort } = await res.json(); // 2) 用返回的调试端口接管,脚本里只写业务逻辑const browser = await puppeteer.connect({ browserURL: 'http://127.0.0.1:' + debugPort, defaultViewport: null,});const [page] = await browser.pages();await page.goto('https://seller.example.com/orders');PORT 为客户端设置里显示的本机接口端口;envId 是环境列表里的环境 ID。Selenium 与 Playwright 同理,把连接目标指向返回的调试端口即可。
接口能做哪几件事
启动环境返回调试端口
关闭环境释放窗口占用
查询运行状态判断是否在运行
调用次数不限
指纹参数、代理绑定与 Cookie 隔离都在环境层处理好,脚本不需要再配一遍;批量任务可以在循环里按需拉起环境,跑完就关。
三步把浏览器环境接进你的代码
典型调用流程只有三步:启动环境 → 拿到调试端口 → 用你熟悉的框架接管。剩下的指纹、代理、Cookie 隔离由 NexBrowser 在环境层面处理好,脚本只管业务逻辑。
第一步:调用本地接口启动指定环境,该环境的指纹与代理配置会自动加载。
第二步:接口返回该环境的调试端口,无需人工打开客户端窗口。
第三步:用 Selenium、Puppeteer 或 Playwright 连上端口,照常执行既有脚本。
Local API 常见问题
Local API 是免费的吗?有调用次数限制吗?
完全免费,且不限调用次数。接口随 Windows 客户端一起开放,免费版账号同样可以使用,你不需要为自动化能力单独购买套餐,也不必担心批量任务跑到一半撞上配额。
支持哪些自动化框架?
接口返回标准调试端口,Selenium、Puppeteer、Playwright、WebDriver 都可以直接接管环境。已有脚本基本无需改写,把连接目标指向返回的端口即可,业务逻辑那部分代码一行都不用动。
Selenium 老是被检测,换成 Local API 就能解决吗?
被检测的原因大多在环境层:自动化启动参数、缺失的插件与字体、前后矛盾的指纹、多个账号共用一个出口 IP。Local API 让脚本接管的是一个带真实 Chrome 内核、自洽指纹参数和独立代理的环境,这些信号才会正常。脚本里过于机械的操作节奏仍然需要你自己控制。
可以接入 AI 智能体吗?
可以。browser-use、Playwright MCP 等主流 AI Agent 框架都能通过调试端口接管 NexBrowser 环境,让智能体在带指纹和代理的真实环境里操作,多账号任务也就能交给 AI 批量执行。
如果不想写代码,还有别的自动化方式吗?
有。NexBrowser 内置无代码 RPA,支持拖拽式流程搭建、步骤录制、定时执行、失败重试与变量传参,可跨多个环境批量运行。不会写代码的团队成员也能独立配置任务,和 Local API 可以混用。
还有其他问题?我们随时为您解答联系客服支持 →
