urlgo

通过CDP协议控制浏览器的CLI工具

安装使用

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

帮我安装这个 AI Skill:urlgo。
它的用途是:通过CDP协议控制浏览器的CLI工具
完整的 Skill 内容见:https://321skill.com/skills/urlgo-x-7/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

'使用urlgo打开百度首页并截图保存为baidu.png',它会通过CDP连接Chrome,打开指定URL,执行截图命令并保存文件。或者说:'用urlgo访问example.com,执行document.title并返回结果',它会执行JS代码,将页面标题输出到终端。

介绍

urlgo 是一个基于 Chrome DevTools Protocol (CDP) 的命令行工具,让你无需打开浏览器界面即可远程操控浏览器。它主要解决 Web 开发与测试中的自动化难题:当你需要批量截图、抓取动态渲染的网页内容、或在无头环境下执行 JavaScript 脚本时,urlgo 能以最简洁的方式完成这些操作,避免了手动操作浏览器的繁琐流程。

使用方式非常直观:只需在终端中运行 urlgo 命令,指定目标 URL 和操作类型(如截图、执行 JS),工具会自动连接已启动的 Chrome 实例或启动一个新的无头浏览器,完成指令后返回结果。例如,urlgo screenshot https://example.com 即可保存页面截图,urlgo eval https://example.com 'document.title' 则会输出页面标题。它支持管道和脚本化调用,方便集成到 CI/CD 流水线中。

适合前端开发、测试工程师、全栈开发以及运维人员。在前端开发中,可用于快速验证页面布局在不同设备上的表现;测试工程师可以将其集成到自动化测试框架中,实现截图对比和动态内容校验;运维人员则可用它监控网页状态或执行简单的端到端检查。对于需要批量处理网页数据的场景(如爬虫、竞品分析),urlgo 的轻量级特性也很有优势。

建议在使用前确保本地已安装 Chrome/Chromium 浏览器,并了解 CDP 端口配置(默认 9222)。对于需要频繁截图或执行复杂 JS 的场景,可结合 cron 任务实现定时巡检。注意,该工具不适合处理需要登录态或复杂交互的页面(如多步骤表单),此时建议使用 Puppeteer 或 Playwright 等更完整的库。

核心特点

与其他浏览器控制工具(如 Puppeteer、Playwright)相比,urlgo 是一个极简的 CLI 工具,无需编写代码,一条命令即可完成截图、执行 JS 等操作,特别适合快速验证和脚本化使用。

注意事项

不适合需要复杂页面交互(如拖拽、多步骤表单)或高度定制化浏览器行为的场景,且依赖本地 Chrome 实例。

常见问题

urlgo 需要安装什么依赖?

需要本地安装 Chrome/Chromium 浏览器,并确保 Chrome 以远程调试模式启动(--remote-debugging-port=9222)。

如何用 urlgo 截取整个页面的长截图?

目前不支持长截图,仅能截取当前视口内的内容。如需全页面截图,可结合 JS 滚动分块拼接。

给 AI 助手的安装指引

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

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