browser-cdp
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseBrowser CDP 操作工具
Browser CDP 操作工具
通过 CDP 协议控制 Chrome，复用已有登录态，执行浏览器自动化操作。
通过 CDP 协议控制 Chrome，复用已有登录态，执行浏览器自动化操作。
前置条件
前置条件
- macOS，已安装 Google Chrome
- 命令行工具已安装
agent-browser
- macOS，已安装 Google Chrome
- 命令行工具已安装
agent-browser
第一步：启动 CDP Chrome 环境
第一步：启动 CDP Chrome 环境
bash
bash {SKILL_DIR}/scripts/setup_cdp_chrome.sh 9222成功后所有 命令带 。
agent-browser--cdp 9222bash
bash {SKILL_DIR}/scripts/setup_cdp_chrome.sh 9222成功后所有 命令带 。
agent-browser--cdp 9222常用操作
常用操作
打开页面并等待加载
打开页面并等待加载
bash
agent-browser --cdp 9222 open "<URL>"
agent-browser --cdp 9222 wait 3000bash
agent-browser --cdp 9222 open "<URL>"
agent-browser --cdp 9222 wait 3000提取页面文本内容
提取页面文本内容
bash
agent-browser --cdp 9222 eval 'document.body.innerText.substring(0, 8000)'bash
agent-browser --cdp 9222 eval 'document.body.innerText.substring(0, 8000)'提取 Auth Token
提取 Auth Token
bash
undefinedbash
undefined从 localStorage 或 cookie 提取
从 localStorage 或 cookie 提取
agent-browser --cdp 9222 eval 'localStorage.getItem("token") || document.cookie'
undefinedagent-browser --cdp 9222 eval 'localStorage.getItem("token") || document.cookie'
undefined页面截图 / 交互式快照
页面截图 / 交互式快照
bash
undefinedbash
undefined查找页面元素（用于登录按钮等交互）
查找页面元素（用于登录按钮等交互）
agent-browser --cdp 9222 snapshot -i
undefinedagent-browser --cdp 9222 snapshot -i
undefined点击元素
点击元素
bash
agent-browser --cdp 9222 click "<CSS selector>"bash
agent-browser --cdp 9222 click "<CSS selector>"填写表单
填写表单
bash
agent-browser --cdp 9222 type "<CSS selector>" "<text>"bash
agent-browser --cdp 9222 type "<CSS selector>" "<text>"常见问题
常见问题
| 问题 | 解决方案 |
|---|---|
| CDP 端口未监听 | 重新运行 |
| 页面跳转到登录页 | |
| eval 返回 null | 检查 localStorage key 名称，或改用 |
| Chrome 进程残留 | |
| 问题 | 解决方案 |
|---|---|
| CDP 端口未监听 | 重新运行 |
| 页面跳转到登录页 | |
| eval 返回 null | 检查 localStorage key 名称，或改用 |
| Chrome 进程残留 | |