urlgo

一个通过Chrome DevTools协议控制浏览器,实现网页操作、截图和JS执行的命令行工具。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:urlgo。
它的用途是:一个通过Chrome DevTools协议控制浏览器,实现网页操作、截图和JS执行的命令行工具。
完整的 Skill 内容见:https://321skill.com/skills/urlgo-x-2/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'用 urlgo 打开 https://example.com 并全屏截图保存为 example.png',它会通过 CDP 连接浏览器,加载该网页,然后截取整个可视区域并保存为图片文件。或者

对AI说:'执行一段 JS 来获取页面标题',它会注入并运行你提供的 JavaScript 代码,并将执行结果返回到终端。

介绍

urlgo 是一个基于 Chrome DevTools Protocol (CDP) 的命令行浏览器控制工具。它解决了在自动化脚本或服务器环境中,需要以编程方式控制浏览器进行网页导航、截图和 JavaScript 执行的需求,而无需依赖图形界面或复杂的浏览器自动化框架。

使用 urlgo 非常简单,通过命令行传入目标 URL 和操作指令即可。例如,你可以让它打开一个网页,等待特定元素加载,然后截图保存,或者注入并执行一段 JavaScript 代码来提取页面数据或模拟用户交互。整个过程在终端中完成,易于集成到 Shell 脚本或 CI/CD 流程中。

它非常适合需要在无头(headless)环境下进行网页抓取、自动化测试、性能监控或批量生成网页截图的开发者、测试工程师和运维人员。对于不熟悉 Selenium 或 Puppeteer 等大型框架,但又需要快速实现轻量级浏览器控制的用户来说,urlgo 是一个高效的选择。

使用建议:确保目标 Chrome/Chromium 浏览器已启动并开启远程调试端口。注意,由于依赖 CDP,网络环境或页面复杂的 JavaScript 可能会影响操作的稳定性和响应时间,建议在可控的内部网络环境中使用,并对关键操作添加超时和错误处理。

核心特点

与 Puppeteer 或 Selenium 等完整的浏览器自动化框架相比,urlgo 是一个轻量级的 CLI 工具,无需编写额外的脚本代码,通过命令行参数即可完成常见操作,更易于集成到 Shell 脚本和自动化流程中。

注意事项

不适合需要复杂交互逻辑(如多步表单填写、拖拽)或高度模拟真人行为的场景。

常见问题

urlgo 和 curl/wget 有什么区别?

curl/wget 主要用于 HTTP 请求获取原始 HTML,而 urlgo 能控制真实浏览器,执行页面 JavaScript 并渲染后截图,适合动态网页。

需要提前启动浏览器吗?

是的,需要先启动 Chrome/Chromium 并开启 `--remote-debugging-port` 参数,urlgo 才能连接控制。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/urlgo-x-2/raw/index.md 读取 urlgo 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。