urlgo

通过CDP协议控制浏览器,实现网页操作、截图和JS执行

安装使用

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

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

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

使用示例

‘帮我用urlgo打开https://example.com并截取全屏截图保存为example.png’,它会生成连接浏览器、打开指定URL并执行截图保存的命令。或者

对AI说:‘用urlgo执行一段JS,获取当前页面的标题’,它会构造命令连接到CDP,注入JS代码并返回页面标题结果。

介绍

urlgo是一个基于Chrome DevTools Protocol (CDP) 的命令行工具,它解决了在自动化脚本或CI/CD流程中需要以编程方式控制浏览器、获取网页内容或执行JavaScript的问题。通过连接到浏览器实例,它可以打开网页、截取屏幕截图、执行自定义JavaScript代码并获取结果,无需依赖复杂的浏览器自动化框架。

使用方式非常简单,通过命令行直接调用即可。用户需要先启动一个支持CDP的浏览器(如Chrome/Chromium),然后使用urlgo连接到其调试端口,之后便可执行打开网页、截图、运行JS等一系列操作。所有功能都通过清晰的命令行参数控制,输出结果可以是文件或标准输出。

它非常适合前端开发、测试工程师和运维开发人员。前端开发者可以用它来快速验证页面渲染或执行前端代码片段;测试工程师可以将其集成到自动化测试流程中,进行页面快照对比或功能验证;运维开发人员则可以用它来监控网页状态或执行定期的页面检查任务。

使用建议:由于需要连接CDP,请确保浏览器已以远程调试模式启动,并注意网络和端口安全。对于复杂的网页交互(如填写表单、点击等),可能需要结合其他工具或编写更复杂的JS脚本。在无头环境下运行时,注意处理可能的资源加载和渲染差异。

核心特点

与基于Selenium或Puppeteer的浏览器自动化工具不同,urlgo是一个轻量级、无依赖的单一CLI工具,直接通过CDP协议与浏览器通信,无需启动额外的驱动或服务,更适合集成到Shell脚本或简单的自动化任务中。

注意事项

不适合需要模拟复杂用户交互(如鼠标拖拽、多步表单填写)的端到端自动化测试场景。

常见问题

如何连接到远程的浏览器?

启动浏览器时指定`--remote-debugging-port=9222`,然后使用`urlgo --host 远程IP --port 9222`连接。

可以保存完整的网页(包括CSS和图片)吗?

urlgo主要提供截图和JS执行能力,保存完整网页需要依赖浏览器功能或编写JS脚本进行资源收集。

给 AI 助手的安装指引

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

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