メインコンテンツへスキップ

​
概要

npx @basemachina/agentic-browser-cli execute -- \
  --runbook <path> \
  [options]
手順書を読み込み、変数を解決し、自己修復セレクタ解決で各ステップをブラウザ上で実行します。

​
必須引数

引数説明
--runbook <path>手順書ファイルのパス

​
オプション引数

​
実行設定

引数デフォルト説明
--headless <bool>truefalse でブラウザウィンドウを表示
--step-delay <ms>YAML の値YAML の pauseBetweenSteps を上書き
--skip-confirmationfalse全ての承認プロンプトを自動承認
--output-dir <path>-ダウンロード・エクスポートファイルの保存先ディレクトリ
--merge-downloadsfalseダウンロードした CSV ファイルを1つにマージ

​
バッチ実行

引数デフォルト説明
--data <path>-バッチ実行用の CSV/JSON データファイル
--reuse-sessiontrueバッチ行間でブラウザセッションを再利用
--no-reuse-session-各バッチ行で新しいブラウザを起動

​
コンテキスト・シークレット

引数デフォルト説明
--context <path>-補足情報マークダウンファイルのパス
--secrets <path>-secrets JSON ファイルのパス（全値 sensitive）

​
出力・デバッグ

引数デフォルト説明
--screenshots <dir>-スクリーンショット保存ディレクトリ
--video <dir>-動画録画の出力先ディレクトリ
--reportfalse実行レポートを強制生成（Markdown）

​
自己修復

引数デフォルト説明
--self-healfalse自動修正モード（アグレッシブリトライ + AI 修正提案生成）
--max-retries <num>-（self-heal 時: 5）セレクタ解決のリトライ上限
--retry-warning-threshold <num>-（self-heal 時: 3）警告を出すリトライ回数
--enable-selector-cacheプラン依存セレクタキャッシュを有効化（成功した ref を永続化）
--enable-agent-fallbackプラン依存Agent Fallback を有効化（AI 代替パス探索）
--enable-vision-fallbackプラン依存Vision Fallback を有効化（スクリーンショットベースの解決）
--self-heal は全ての自己修復機能を有効化し、アグレッシブなデフォルト値を設定します。プラン要件については自動修正モードを参照してください。

​
承認・通知

引数デフォルト説明
--approval-mode <mode>cli承認モード: cli, slack, teams, discord
--notify <mode>-完了通知モード: slack, teams, discord
--callback-port <port>3100Webhook コールバックサーバーのポート
--approval-timeout <ms>300000承認タイムアウト（デフォルト 5 分）
Slack/Teams/Discord 承認は Business プラン以上が必要です。通知は Team プラン以上が必要です。

​
プラットフォーム設定

export SLACK_BOT_TOKEN="xoxb-..."
export SLACK_SIGNING_SECRET="..."
export SLACK_CHANNEL_ID="C01234567"

​
AI モデル

引数デフォルト説明
--model <id>claude-sonnet-4-6AI モデル ID
--model-provider <provider>anthropicAI プロバイダー
--model-base-url <url>-OpenAI 互換エンドポイントのベース URL

​
用途別モデルオーバーライド

引数説明
--model-selector <id>セレクタ解決用モデル
--model-extraction <id>データ抽出用モデル
--model-review <id>レビュー・修正提案用モデル（self-heal 時のみ）
--model-fallback <id>Agent Fallback 用モデル
--model-vision <id>Vision Fallback 用モデル

​
詳細設定

引数デフォルト説明
--locale <code>enUI・AI プロンプトの言語: en または ja
--stealthfalseステルスモード（bot 検出回避パッチ適用）
--proxy <url>-プロキシ URL（例: http://user:pass@host:port）
--skill <names>-スキルプラグイン名（カンマ区切り）
--api-key <key>-Pro/Team/Business/Enterprise 機能の API キー

​
使用例

​
基本的な実行

npx @basemachina/agentic-browser-cli execute -- \
  --runbook ./login-flow.yaml \
  --context ./context.md \
  --secrets ./secrets.json \
  --headless false \
  --model "claude-sonnet-4-6" \
  --model-provider anthropic
--model と --model-provider を毎回指定する代わりに、環境変数でデフォルトを設定できます：
export AI_MODEL_ID="claude-sonnet-4-6"
export AI_MODEL_PROVIDER="anthropic"
詳しくは環境変数を参照してください。

​
スクリーンショット付き

npx @basemachina/agentic-browser-cli execute -- \
  --runbook ./login-flow.yaml \
  --screenshots ./screenshots

​
CSV によるバッチ実行

npx @basemachina/agentic-browser-cli execute -- \
  --runbook ./create-users.yaml \
  --data ./users.csv
users.csv の内容： 
name,email,role
Alice,[email protected],admin
Bob,[email protected],member

​
自動修正モード

npx @basemachina/agentic-browser-cli execute -- \
  --runbook ./login-flow.yaml \
  --self-heal

​
Slack 承認付き

export SLACK_BOT_TOKEN="xoxb-..."
export SLACK_CHANNEL_ID="C01234567"

npx @basemachina/agentic-browser-cli execute -- \
  --runbook ./payment-flow.yaml \
  --approval-mode slack \
  --notify slack

​
シークレット付き

npx @basemachina/agentic-browser-cli execute -- \
  --runbook ./login-flow.yaml \
  --secrets ./secrets.json

​
環境変数で認証情報を指定

手順書で： 
variables:
  email:
    source: env
    key: APP_EMAIL
  password:
    source: secrets
    key: APP_PASSWORD
実行： 
export APP_EMAIL="[email protected]"

npx @basemachina/agentic-browser-cli execute -- \
  --runbook ./login-flow.yaml \
  --secrets '{"APP_PASSWORD": "s3cret!"}'

​
環境変数

変数説明
AI_MODEL_ID--model のデフォルト値
AI_MODEL_PROVIDER--model-provider のデフォルト値
AGENTIC_BROWSER_LOCALE--locale のデフォルト値（en または ja）
AGENTIC_BROWSER_API_KEY--api-key のデフォルト値