# 经验：CDP 9222 连接与 browser-use 基础操作

> 场景：需要对用户已登录的真实 Chrome（远程调试端口 9222）做自动化操作。

## 连接检查

```bash
curl -s http://127.0.0.1:9222/json/version   # 通了即可用
curl -s http://127.0.0.1:9222/json           # 列出页面 target
```

## browser-use 调用模式

CLI 名为 `browser-use`，用 heredoc 传 Python 代码，helpers 已预导入：

```bash
browser-use <<'PY'
for t in list_tabs():            # 列出所有页面 tab
    print(t["targetId"], t["url"][:80])
PY
```

## 关键 API

| API | 用途 |
| --- | --- |
| `list_tabs()` | 列出页面 tab，返回完整 targetId |
| `switch_tab(targetId)` | attach 到指定 tab（不改变 Chrome 可见 tab）；**必须传完整 targetId**，8 位前缀会报 `No target with given id found` |
| `activate_tab(targetId)` | 把 tab 切到前台（用户可见） |
| `js(expression)` | 在当前页面执行 JS，自动 await Promise |
| `capture_screenshot(path)` | 截图保存到本地文件 |
| `click_at_xy(x, y)` | 视口坐标点击（CDP 鼠标事件，穿透 iframe/shadow DOM） |
| `cdp("Domain.method", ...)` | 任意 CDP 协议调用 |
| `wait_for_load(15)` | 等待导航完成 |

## 坑：js() 顶层 let/const 会跨调用残留

`Runtime.evaluate` 在页面全局作用域执行，顶层 `let out = []` 会留下全局词法绑定，
下次调用再写 `let out` 直接 `SyntaxError: Identifier 'out' has already been declared`。

**解法：所有多行 JS 一律包 IIFE：**

```python
r = js("""
(() => {
  let out = [];
  ...
  return out.join('\\n');
})()
""")
```

## 注意

- 每个 `browser-use <<'PY'` 是独立 Python 进程，Python 变量不跨调用保留；
  页面状态（DOM、JS 全局变量）跨调用保留。
- CDP target 顺序 ≠ Chrome 可见 tab 标签页顺序，用 `list_tabs()` 认 URL。