urlgo

浏览器控制 CLI

Keywords

https://, http://, www., 浏览器, CDP, 截图, 网页, mp.weixin, 打开网页, 网页截图

Summary

连 CDP，开网页，截图，执行 JS。

Strategy

1. urlgo status → CDP 开了没？没开就 urlgo start
2. urlgo open <url> → 打开页面
3. 截图/读取/点击/输入/执行 JS
4. 返回结果

AVOID:

• AVOID 不检查 CDP 就操作，先 status/start
• AVOID 忘装 websockets，截图和 JS 要用它
• AVOID 用 WebFetch 读网页，应该用 urlgo snapshot 代替

⚠️ 踩坑记录（2026-05-06）

1. urlgo 不在 PATH

urlgo 脚本不在系统 PATH 中，直接调用报 command not found。

解法：调用前将技能目录加入 PATH，或在命令中指定 skill base dir：

export PATH="$PATH:$(dirname $(readlink -f $0))/.."

或使用 skill base dir 全路径调用 python3 <skill_dir>/urlgo。

2. urlgo start 浏览器进程被 SIGHUP 杀死

旧版 cmd_start() 用 subprocess.run + shell & 启动浏览器。urlgo 脚本退出后，shell 向子进程发 SIGHUP，浏览器随之退出。表现为 urlgo start 后立即 urlgo open 报"CDP 未开启"。

解法：改用 subprocess.Popen(start_new_session=True)（Linux）或 DETACHED_PROCESS（Windows），断开浏览器与脚本的进程组关联。

3. urlgo start 阻塞等待

旧版有 5~10 秒循环轮询 CDP 端口，bash tool 下呈阻塞态，用户需中断。中断后旧版浏览器进程被连带杀死。

解法：新版无额外阻塞，最长等待 15 秒后超时返回。

4. bash tool 下无输出（stdout 缓冲）

bash tool 捕获 stdout 时 Python 启用块缓冲，print 输出积压不刷，bash tool 见"no output"即超时中断，误判为脚本假死。

解法：脚本入口加 sys.stdout.reconfigure(line_buffering=True)，每行输出即刷。

---

命令

命令	说明
urlgo status	检查 CDP
urlgo start	启动浏览器
urlgo list	查看页面
urlgo open <url>	打开网页
urlgo screenshot <id> <file>	截图
urlgo snapshot <id>	读取内容
urlgo eval <id> "<js>"	执行 JS
urlgo click <id> "<sel>"	点击
urlgo type <id> "<sel>" "<text>"	输入

示例

# 先加 PATH（如不在系统 PATH 中）
export PATH="$PATH:/path/to/urlgo/skill/dir"

# 启动浏览器（后台运行，不会阻塞）
urlgo start

# 打开网页
urlgo open https://example.com

# 读取内容 / 截图
urlgo snapshot 1
urlgo screenshot 1 /tmp/a.png

依赖

curl, websockets(Python)