mini-browser(mb)是面向 AI 智能体的浏览器命令行工具,每条命令都像一个小型 Unix 工具,底层通过 puppeteer-core 经 CDP(默认端口 9222)连接 Chrome。
用途:让智能体浏览网页、截图、抓取文本、填表单、点击元素、录制屏幕等。
安装与启动:未安装时执行 npm install -g @runablehq/mini-browser;Chrome 未运行时执行 mb-start-chrome(带 --remote-debugging-port=9222、独立配置与 1024×768 窗口),重启用 mb-restart-chrome。可用 which mb 和访问 http://127.0.0.1:9222/json/version 检查就绪状态。
主要命令:导航 mb go <url>、mb url、mb back/forward;观察 mb text [selector]、mb shot [file]、mb snap;交互 mb click <x> <y>、mb type、mb fill <k=v...>、mb key、mb move、mb drag、mb scroll;录制 mb record start/stop/status;标签页 mb tab list/new/close;其他 mb js、mb wait、mb audit、mb logs。支持 --timeout、--tab、--json、--right、--double、--fps、--scale 等标志。
典型用法:先 mb snap 获取可交互元素坐标,再点击并 mb wait networkidle,循环观察—操作。可用 mb fill "Email=..." "Password=..." 配合 mb key Enter 提交表单;用 mb js 执行页面脚本;记录状态存于 ~/.mb-recorder.json。
限制:视口固定 1024×768,snap 只返回当前视口内元素,需滚动后重新 snap;text 用 querySelector 只返回首个匹配;go 等待 networkidle,重 SPA 需再 wait 选择器;一次只能录制一个;tab close 不能关闭最后一个标签页。环境变量包括 CHROME_PORT、CHROME_BIN、CHROME_PID_FILE、CHROME_USER_DATA_DIR。收费、价格与平台支持等资料暂未提供。