firefox-cli

firefox-cli 可让 Agent 通过已安装的 Firefox 扩展，在终端中访问用户已登录的真实 Firefox 会话。

命令发现

CLI 帮助是命令、语法、示例和使用指南的权威来源。

从以下命令开始：

firefox-cli -h

查看特定上下文的命令帮助：

firefox-cli snapshot -h
firefox-cli tab -h
firefox-cli click -h
firefox-cli wait -h

如果由其他程序或 Agent 使用输出，请使用 --json。

启动模式

对于读取页面的任务：

firefox-cli open "https://example.com"
firefox-cli snapshot -i

对于当前活动页面：

firefox-cli snapshot -i

对于规划操作：

firefox-cli snapshot -i --json

请将特定命令的帮助作为后续每项操作的参考。

目标定位

只有在所需窗口或标签页唯一时，才可以省略选择器。如果存在多个窗口或标签页，请传入 ID 或明确指定 active。

仅使用各命令提供的 --window 和 --tab 标志。取值可以是 active、firefox-cli tab 或 firefox-cli window 返回的索引，或 id:<id>。

如需隔离操作，请新建一个窗口，并在之后的每条命令中明确指定目标：

firefox-cli window new
firefox-cli open --window id:<window-id> https://example.com
firefox-cli snapshot --window id:<window-id> -i

tab select 会在其所属窗口中选中标签页。--focus 还会请求将窗口置于前台。window select 会将对应窗口置于前台。对于 open、tab new、window new 和 screenshot，--focus 会请求将窗口置于前台。不使用此标志时，导航不会改变标签页选择状态，新建的标签页不会被选中，新窗口不会收到置于前台的请求，而截图会选中目标标签页，但不会将其窗口置于前台。如果人工检查或依赖焦点的渲染需要浏览器显示在前台，请使用 --focus。之后执行依赖目标的命令时，请明确传入 --window/--tab。

设置状态

firefox-cli setup -h
firefox-cli doctor -h

使用规则

• snapshot -i 返回的元素引用可用作后续操作的句柄，但页面导航或重新加载可能会使其失效。
• 请谨慎处理用户数据：你使用的 Firefox 实例包含真实 Cookie、身份验证凭据、登录信息、标签页和个人身份信息（PII）。在任何情况下，都不得执行可能损害用户或泄露其数据的操作。在每次执行此类操作前，必须先征得用户明确批准；这类操作包括付款、资金转账，以及其他危险、破坏性或不可逆的操作，也包括泄露 PII。
• 如果需要使用 Firefox，但遇到标签页切换或打开了真实用户标签页等干扰，请为自己打开一个新的 Firefox 窗口。浏览器操作可能会改变标签页选择状态或将窗口置于前台。如果需要让用户看到浏览器，请使用 --focus。
• 如果 CLI 因审批要求而拒绝请求，并提示你运行 firefox-cli connect，请仅调用该命令一次，以向用户显示权限提示。获批后命令会退出。请勿以任何方式尝试规避拒绝。