pi-browser-harness
通过CDP协议控制真实Chrome浏览器的自动化工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-browser-harness。 它的用途是：通过CDP协议控制真实Chrome浏览器的自动化工具 完整的 Skill 内容见：https://321skill.com/skills/pi-browser-harness/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“使用浏览器工具打开GitHub趋势页面，抓取今日排名前5的仓库名称和星数。”，它会启动Chrome，导航到指定页面，执行JavaScript提取DOM中的数据，并以结构化的格式（如JSON）返回给你。或者
对AI说：“对我们的登录页面进行截图，并测试一下错误密码的提示是否出现。”，它会自动完成打开页面、输入错误信息、点击登录、验证页面元素和截图等一系列操作。
介绍
pi-browser-harness 是一个浏览器控制扩展，旨在解决在自动化流程中需要与真实网页进行交互的难题。传统无头浏览器或模拟环境有时无法完美复现真实用户的操作环境，导致自动化脚本在测试或数据抓取时失效。该工具通过Chrome DevTools Protocol (CDP) 直接连接和控制一个真实的Chrome浏览器实例，从而执行导航、点击、输入、截图和数据提取等操作，确保了交互的真实性和可靠性。
使用方式非常直接。开发者通过npm安装此包，并在代码中引入。随后，工具会启动或连接到一个现有的Chrome实例，通过CDP发送指令来驱动浏览器。你可以编程式地让浏览器访问特定URL，在页面上查找元素并模拟点击或键盘输入，捕获完整或局部的页面截图，以及从DOM中提取结构化数据。整个过程就像有一个无形的用户在操作浏览器。
它非常适合需要进行端到端测试、网页监控、数据爬取或自动化工作流的开发者和测试工程师。特别是那些需要绕过反爬虫机制、测试复杂前端交互（如单页应用），或验证在真实渲染环境下页面行为的团队。对于质量保证和运维人员来说，它也是一个强大的验证工具。
使用建议方面，请注意确保运行环境已安装Chrome或Chromium浏览器。由于控制的是真实浏览器，会消耗一定的系统资源，不建议在资源受限的服务器上大规模并发运行。另外，频繁的自动化访问可能触发目标网站的安全机制，请合理设置操作间隔，遵守网站的robots协议和服务条款。
核心特点
其核心区别在于直接通过CDP控制“真实”的Chrome浏览器，而非无头模式或模拟环境，能更好地处理复杂JavaScript渲染、应对反爬措施，并完美模拟人类用户的操作环境。
注意事项
不适合对执行速度和资源消耗有极端要求的轻量级、高并发爬虫场景。
常见问题
pi-browser-harness 和 Puppeteer 有什么区别？
它底层也使用CDP，但更侧重于作为pi框架的扩展，提供与pi AI智能体集成的浏览器控制能力，强调在自动化流程中嵌入智能决策。
需要单独安装Chrome吗？
是的，需要系统已安装Chrome或Chromium浏览器，因为工具通过CDP连接并控制其实例。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-browser-harness/raw/index.md 读取 pi-browser-harness 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-browser-harness/raw/index.md（查看排版版本）