urlgo

通过CDP协议控制浏览器的命令行工具

安装使用

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

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

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

使用示例

'使用urlgo打开百度首页,截图保存为screenshot.png,并执行JS获取页面标题。' AI会执行命令:urlgo --url https://www.baidu.com --screenshot screenshot.png --js 'document.title',先打开百度首页,截图保存,再输出页面标题文本。

介绍

urlgo 是一个轻量级的命令行工具,通过 Chrome DevTools Protocol(CDP)直接连接浏览器,让你无需编写复杂脚本就能完成打开网页、截图、执行 JavaScript 等操作。它适合需要快速自动化浏览器操作但不想引入 Puppeteer 或 Playwright 等重型库的场景,比如网页截图、数据抓取、前端调试等。

使用方式非常简单:在终端中一行命令即可连接已开启 CDP 端口的浏览器,指定目标 URL 和操作(截图、执行 JS 等),结果直接输出到文件或标准输出。无需额外安装浏览器驱动,只要浏览器本身支持 CDP 即可。

适合前端开发、测试工程师、运维人员等需要快速验证网页效果、抓取页面内容、调试前端代码的用户。尤其适合在 CI/CD 流水线中做自动化截图对比、在本地开发时快速获取页面状态,或配合脚本做批量任务。

建议先确保本地浏览器已开启远程调试端口(如 Chrome 启动时添加 —remote-debugging-port=9222)。对于复杂交互(如多页面并行、表单填写、鼠标事件模拟),建议使用 Puppeteer 或 Playwright 等更完善的库。

核心特点

相比 Puppeteer/Playwright,urlgo 无需编写任何脚本,直接通过命令行参数即可完成浏览器操作,上手成本极低,特别适合快速调试和单次自动化任务。

注意事项

不适合需要复杂浏览器交互(如多标签页并行、高级事件模拟)的场景,且依赖浏览器手动开启 CDP 端口。

常见问题

如何安装 urlgo?

通常通过 npm 全局安装:npm install -g urlgo,或从 GitHub 仓库克隆后本地构建。

需要提前安装浏览器吗?

需要本地安装 Chrome 或 Chromium,并启动时添加 --remote-debugging-port=9222 参数开启远程调试。

给 AI 助手的安装指引

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

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