firefox-cli

firefox-cli を使うと、インストール済みの Firefox 拡張機能を通じて、エージェントがユーザーの実際に認証済みの Firefox セッションにターミナルからアクセスできます。

コマンドの確認

CLI のヘルプが、コマンド、構文、例、使用方法に関するガイダンスの正式な情報源です。

まず、次を実行します。

firefox-cli -h

コマンドに関する状況に応じたヘルプを表示するには、次を実行します。

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

別のプログラムやエージェントが出力を利用する場合は、--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 の実行を求めた場合は、ユーザーに権限の確認を表示するために、そのコマンドを一度だけ実行してください。承認されると、コマンドは終了します。いかなる方法でも拒否を回避しないでください。