/install auto-fill
auto-fill
帮你填表。你来点击导航,我来识别字段和填写内容。
使用方式
/auto-fill 公司名: ACME, 邮箱: [email protected], 备注: 测试订单
数据格式自由,键值对 / 自然语言描述都行,我来匹配字段。
重要:必须使用 playwright-cdp 工具集
所有浏览器操作必须使用 playwright-cdp 的工具(连接真实 Chrome),不要使用 cursor-ide-browser 的内置浏览器工具。
- ✅ 用:
playwright-cdp提供的browser_navigate、browser_snapshot、browser_fill等 - ❌ 禁止:
cursor-ide-browser的同名工具(沙盒浏览器,没有登录态)
工作流程
第一步:检查 Chrome debug 是否在线
curl -s http://127.0.0.1:9222/json/version
- ✅ 有响应 → 继续
- ❌ 无响应 → 直接用 Shell 启动 Chrome,不要让用户手动跑命令
直接执行(后台启动):
nohup /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
--remote-debugging-port=9222 \
--user-data-dir="/tmp/chrome_debug_profile" \
> /tmp/chrome_debug.log 2>&1 &
等 2 秒后重新 curl 确认启动成功,再继续。
第二步:导航到目标页面
根据用户的描述推断目标 URL,直接 browser_navigate 过去,不要问用户要链接。
- 「打开 Google」→
https://www.google.com - 「去 Wise 注册」→
https://wise.com/register - 「打开 Creem」→
https://creem.io - 模糊描述 → 用常识判断最合理的 URL,导航后截图确认
只有完全无法推断时,才问用户要链接。
第三步:读取页面结构
browser_snapshot
获取无障碍树,识别所有可填写字段(input、textarea、select 等)。
第四步:匹配字段
把用户提供的数据与页面字段对应:
- 字段名/placeholder/label → 语义匹配,不要求精确
- 不确定的字段:列出来问用户,不要乱填
- 没有对应数据的字段:跳过,保持原值
第五步:填写
使用 browser_fill 逐字段填入。
规则:
- 密码类字段:填前确认
- 下拉框(select):用
browser_select_option - 文件上传:用
browser_upload_file,需用户确认路径
第六步:截图确认
browser_take_screenshot
展示填写结果,明确告知:「填完了,请你来点提交」。
边界规则
| 操作 | Agent 做 | 用户做 |
|---|---|---|
| 识别表单字段 | ✅ | |
| 填写内容 | ✅ | |
| 截图确认 | ✅ | |
| 点击导航 / 翻页 | ✅ | |
| 点击提交按钮 | 除非明确说「帮我提交」 | ✅ 默认 |
| 处理弹窗 / 验证码 | ✅ |
环境配置(首次)
如果 ~/.cursor/mcp.json 里没有 playwright-cdp 配置,添加:
"playwright-cdp": {
"command": "npx",
"args": ["-y", "@playwright/mcp@latest", "--cdp-endpoint", "http://127.0.0.1:9222"]
}
添加后提示用户重载 MCP(Cursor 设置 → MCP → Reload)。
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install auto-fill - 安装完成后,直接呼叫该 Skill 的名称或使用
/auto-fill触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
auto-fill 是什么?
通过 Chrome Debug 模式(CDP)读取当前页面的表单结构并自动填写。由用户显式调用(/auto-fill),不自动触发。用户负责导航和点击,Agent 负责识别字段、填写内容、截图确认。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 284 次。
如何安装 auto-fill?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install auto-fill」即可一键安装,无需额外配置。
auto-fill 是免费的吗?
是的,auto-fill 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
auto-fill 支持哪些平台?
auto-fill 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 auto-fill?
由 fanzhuo(@scottliu007)开发并维护,当前版本 v1.0.0。