在 Nullprint 里使用 Playwright

是什么

Playwright 是微软开源的浏览器自动化库。由 Nullprint 启动环境，Playwright 通过 Chrome DevTools 协议接上去。

在 Nullprint 里设置

1. 保持 Nullprint 运行。端口和 key 在 ~/.nullprint/daemon.json（Windows：%USERPROFILE%\.nullprint\daemon.json），key 也能在「自动化」页面找到。
2. 给这个环境打开外部调试接入：进环境详情页，展开专家模式，勾上「外部调试接入」（会要求二次验证）。脚本里做同样两件事：先 POST /profiles/{name}/external-debug-grant 带 x-np-stepup 票，再 PATCH /profiles/{name} 传 {"launch": {"externalDebug": true}}。两样缺一个，cdp_endpoint 都一直是 null——环境默认不开调试端口。
3. 安装：pip install requests playwright
4. 启动环境、等 CDP 地址、接上去：

   import json, os, time, requests
   from playwright.sync_api import sync_playwright
   
   cfg = json.load(open(os.path.expanduser("~/.nullprint/daemon.json")))
   BASE = f"http://127.0.0.1:{cfg['port']}"
   H = {"X-API-Key": cfg["api_key"]}
   NAME = "shop-01"  # the internal ID from GET /profiles, not the display label
   
   requests.post(f"{BASE}/profiles/{NAME}/launch", json={"headless": False}, headers=H).raise_for_status()
   while True:  # launch is asynchronous
       p = requests.get(f"{BASE}/profiles/{NAME}", headers=H).json()
       if p.get("status") == "running" and p.get("cdp_endpoint"):
           break
       time.sleep(1)
   
   with sync_playwright() as pw:
       browser = pw.chromium.connect_over_cdp(p["cdp_endpoint"])
       ctx = browser.contexts[0]
       page = ctx.pages[0] if ctx.pages else ctx.new_page()
       page.goto("https://example.com")
       print(page.title())
       browser.close()  # only disconnects
   
   requests.post(f"{BASE}/profiles/{NAME}/stop", headers=H)  # this closes the browser

5. Node.js 同样步骤，用 chromium.connectOverCDP(endpoint)。

完整 API 文档： 本地 API 文档

为什么搭配好用

• 脚本跑在真实、持久的环境里，cookie、指纹、代理每次都一样。
• 时区、语言、地理位置已经跟着环境的代理走，脚本不用自己伪装。
• 长时间任务要固定端口？给环境设 launch.debugPort。