AutomatiQ 网页流程记录器

把真实浏览过程和网络流量整理成可供 AI 编写网页自动化的证据。

Star 数
★ 171
最近更新
1 个月前
License
MIT
主语言
Python

30 秒速览

运行形态
MCP 服务器命令行工具
可在哪里用
通用 · 跨平台Codex
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
Python 3.11+BraveShell / 命令行网络访问本地文件系统MCP Server
典型场景
需要理解目标网站请求流程的数据工程师,可录制一次人工操作,再据会话产物编写 HTTP 抓取脚本。
不适合
  • 不能接受录制内容明文保存的团队
  • 需要稳定、非 Alpha 工具的生产团队

这个 Agent 能做什么,适合哪些场景?

AutomatiQ 是一个 Alpha 阶段的 Python 工具,通过 MCP stdio 服务器让 AI 客户端调用录制和状态查询工具。它会启动一个可见的 Brave 浏览器,并记录用户操作、网络请求、WebSocket 数据以及可选的视频片段。录制结束后,工具会把解码后的流量和会话说明编译到工作目录下的会话文件夹;配置视觉模型时,还能为操作片段添加注释。MCP 客户端可先读取生成的 README,再据此编写直接使用 HTTP 的自动化脚本。它要求 Python 3.11+,浏览器录制依赖 Brave;录制数据保存在本地会话目录,但配置的视觉模型服务会参与分析。

运行 automatiq 启动 MCP stdio 服务器。客户端调用 start_recording(url, session_name?, proxy?, include_video?) 后,AutomatiQ 打开可见的 Brave 窗口并捕获网络、WebSocket、用户操作和视频;用 stop_recording(session_id) 请求结束录制,再通过 wait_for_completion(session_id?, timeout_s?) 等待编译完成。随后读取 ./automatiq_sessions/<session_name>/ 中的 README.md 和产物;如果配置了视觉模型,可调用 annotate_user_interactions(session_id?, focus?) 补做视觉分析。会话文件可能包含未脱敏的请求和响应正文、Cookie、凭据以及输入的密码。

  1. 需要理解目标网站请求流程的数据工程师,可录制一次人工操作,再据会话产物编写 HTTP 抓取脚本。
  2. 为 AI 助手构建网页自动化的开发者,可让助手读取操作和网络记录,减少对页面行为的猜测。
  3. 排查 WebSocket 交互的工程师,可捕获浏览期间的 WebSocket 数据并检查生成的会话文件。
  4. 需要复现用户操作的测试人员,可录制可见浏览器操作,并在配置视觉模型时查看带注释的片段。
  5. 希望让 MCP 客户端生成抓取脚本的团队,可在本地运行服务器并把会话目录作为脚本编写依据。

如何安装或部署这个 Agent?

需要 Python 3.11+。安装包后,将 AutomatiQ 注册为 MCP stdio 服务器;首次启动时,如果系统未找到 Brave,工具会下载托管的 Brave 浏览器。可选的视觉分析需要在配置文件中填写与所选 LiteLLM 提供方匹配的 API 密钥。

pip install automatiq

在 MCP 客户端配置中添加:

{
  "mcpServers": {
    "automatiq": {
      "command": "automatiq"
    }
  }
}

要使用视觉分析,在 ~/.automatiq/config.toml 设置模型及其提供方密钥:

[models]
recorder = "gemini/gemini-3.1-flash-lite"
recorder_api_key = "your-key-here"

如何使用这个 Agent?

重启 MCP 客户端后,确认 AutomatiQ 的工具可用。调用 start_recording 并传入目标网址;浏览器打开后完成要记录的操作。之后调用 wait_for_completion 轮询状态,或在结束操作后调用 stop_recording 并继续等待。任务完成时先读取返回的 readme_path 指向的会话 README,再查看会话目录中的其他产物。视觉分析需要提供匹配模型的密钥;include_video 默认为 true,设为 false 可跳过动作视频片段。录制结束后若补充了密钥,可调用 annotate_user_interactions 重新分析。

start_recording(url="https://example.com")
wait_for_completion(session_id="<session_id>")

这个 Agent 有哪些优点和局限?

优点
  • 同时记录用户操作、网络请求和 WebSocket 数据,可将页面行为与流量对应起来。
  • 输出会话目录和 README,便于 MCP 客户端直接读取并据此编写脚本。
  • 支持可选的视频片段和视觉模型注释,补充原始网络日志看不到的屏幕上下文。
  • 可用 LiteLLM 支持的提供方配置视觉模型,也记录了本地 OpenAI 兼容端点的配置方式。
局限
  • 项目明确标为 Alpha,功能可能变化或失效。
  • 录制内容不做脱敏,可能明文保存密码、Cookie、凭据及请求响应正文,需严格保护会话目录。
  • 录制器限定使用 Brave;首次运行可能需要下载浏览器,macOS 还会请求屏幕录制权限。
  • 视觉分析依赖提供方 API 密钥,且模型需支持图像;模型配置变更需要重启服务器。

这个 Agent 与同类方案有什么区别?

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
AutomatiQ 网页流程记录器 当前 55 · 缺口较多 MCP 服务器免费 + 模型费 ★ 171 1 个月前 Python Codex
Flyto2 Core 64 · 存在缺口 命令行工具免费版 + 付费版 ★ 484 1 天前 Python Claude Code
Obscura 无头浏览器 75 · 表现良好 命令行工具免费 ★ 29k 今天 Rust Claude.ai
AIHawk – AI 浏览器代理 59 · 缺口较多 MCP 服务器免费 + 模型费 ★ 32k 今天 TypeScript Codex · Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
55/ 100 五分制 2.8 / 5
信任安全 13/29
可靠稳定 8/14
适用触发 12/18
规范维护 11/18
有效结果 7/13
证据核验 4/8
查看各维度的扣分理由
信任安全13 / 29 · 2.2/5

README说明录制会保存请求/响应体、Cookie和凭据,且未脱敏;配置、代理、遥测与文件输出路径有说明,但没有展示字段级访问限制或脱敏,因此最小权限和敏感数据处理仅得1。录制由用户调用工具启动并打开可见浏览器,未见单独的高风险操作确认,所以确认得1。遥测明确列出采集项和禁用方式,录制与模型数据流也有说明,数据流透明度得2;依赖有精确或范围版本约束,但材料未提供漏洞审查或锁定文件内容,依赖安全得1。浏览器访问网站、MCP写入会话文件、可选代理及模型调用均有说明,但默认遥测开启且录制效果会向外部网站发请求,外部影响控制得1。重注释会备份原始文件,配置升级会保留.bak,回滚得2。pyproject和许可证列出作者及版权,来源归属得2;注册表未验证的发布者身份不据此加减分。

可靠稳定8 / 14 · 2.9/5

README、配置和工具说明对录制、等待、状态查询及输出目录总体一致;alpha声明降低了稳定性承诺,故自洽得2。提供Python最低版本和依赖清单,但未给出锁文件内容或不可用依赖的备用方式,依赖可用性得1。README说明初始化等待、崩溃报告和重注释失败情形,测试片段也覆盖未知会话、无视频、未配置视觉模型等错误提示,失败消息得2。

适用触发12 / 18 · 3.3/5

项目明确面向开发者和MCP客户端,场景是把用户浏览过程转成可供Agent编写HTTP自动化的资料;适用人群与场景得2。工具、视觉模型、代理、遥测及输出职责有界定,也说明录制器仅用Brave及视频分析的作用,能力边界得2。MCP工具有明确名称、参数和录制到读取产物的工作流,触发精度得2。Python版本、多个客户端配置、环境变量、配置文件和本地模型端点都有说明;但浏览器限定Brave且macOS屏幕录制权限需用户处理,环境适配得2。

规范维护11 / 18 · 3.1/5

README按工作流、安装、MCP配置、工具、配置和开发组织,结构清晰但FAQ较少,信息架构得2。提供pip安装、Python版本、首次下载提示及多客户端配置,安装说明得2。项目名、MCP服务器名、命令和包名保持一致,命名稳定得2。提供配置样例和工具工作流,但未见系统化FAQ,示例与FAQ得2。明确alpha状态、未脱敏数据风险、Brave限制、首次下载等待和模型配置要求,已知限制得2。pyproject与LICENSE均标示MIT并给出完整许可文本,许可证得3。版本从配置模块动态读取,但材料没有变更日志或发布流程,版本与变更记录得1。作者和联系方式可见,但未明确维护责任、响应承诺或更新路径,维护责任得1。

有效结果7 / 13 · 2.7/5

录制产物包含会话README、网络数据、动作和可选视觉注释,且客户端可先读README,输出可供后续自动化使用,得2。把可见浏览记录转成可复用的HTTP自动化资料有明确附加价值,但“更高准确度、更快”等收益主要是项目主张,缺少此材料中的比较证据,边际价值得2。首次下载浏览器、可选视觉模型/API密钥、视频采集与遥测带来设置、时间或费用成本;没有成本估算或效益测量,成本收益得1。

证据核验4 / 8 · 2.5/5

主要产品、配置、遥测和限制主张在README及pyproject中可追溯;测试文件展示了错误分支、隔离方式和重注释行为,但不据此声称已执行,主张可追溯性得2。README、项目元数据、工作流和测试能部分相互印证,但没有运行结果、发布记录或独立来源支持关键效益主张,交叉佐证得1。alpha、匿名遥测字段、敏感数据未脱敏、Brave限定等明确事实与性能/准确度目标的主张可区分,事实与推断区分得2。

风险与缓解建议
  • 录制会原样保存请求/响应内容、Cookie和凭据;按秘密资料保护会话目录,分享或提交前应先检查其中的敏感信息。
  • 遥测默认开启;若不需要,可通过配置或 AUTOMATIQ_TELEMETRY=0 关闭。
证据充分度:低 评估于 2026年10月13日 审查版本 e1029d3fbce9
查看完整评分方法 →

常见问题

使用视觉注释是否需要付费模型?
README 未说明价格。视觉注释需要配置 LiteLLM 提供方对应的 API 密钥;也可以设置本地 OpenAI 兼容端点,但模型仍需支持图像。
录制时会保存哪些敏感信息?
请求和响应正文、Cookie、凭据以及输入的密码都会未经脱敏保存。应将每个会话目录视为机密,不要提交或分享。
可以不使用 MCP 客户端吗?
可以直接运行 automatiq 或 python -m automatiq 启动 stdio 服务器;README 介绍的工具调用流程仍通过 MCP 客户端进行。
如果浏览器崩溃,录制会丢失吗?
README 表示崩溃的会话仍会保存录制内容和 crash_report.txt;首次启动下载 Brave 时,初始化也可能持续约一分钟。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents