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

​
概要

npx @basemachina/agentic-browser-cli generate -- \
  --url <url> \
  --goal <goal> \
  --output <path> \
  [options]
AI がブラウザを開き、指定されたゴールを達成するために Web アプリを探索し、各操作を記録してレビューし、クリーンな手順書を出力します。

​
必須引数

引数説明
--url <url>探索を開始する URL
--goal <goal>達成するゴール（自然言語で記述）
--output <path>生成する手順書の出力パス

​
オプション引数

​
探索設定

引数デフォルト説明
--max-iterations <num>20最大探索ループ回数
--step-delay <ms>500ステップ間の待機時間（ミリ秒）
--stall-check-interval <num>3N イテレーションごとに停滞をチェック
--history-window <num>10AI に渡す直近ステップ履歴数
--max-failures <num>3連続失敗で探索を中断する回数
--headless <bool>truefalse でブラウザウィンドウを表示
--no-snapshot-filterfalseスナップショットフィルタを無効化（完全な DOM を AI に渡す）

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

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

​
出力・デバッグ

引数デフォルト説明
--screenshots <dir>-スクリーンショット保存ディレクトリ
--video <dir>-動画録画の出力先ディレクトリ

​
AI モデル

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

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

タスクごとに異なるモデルを使用してコストと品質を最適化：
引数説明
--enable-multi-modelマルチモデルルーティングを有効化
--model-selector <id>セレクタ解決用モデル
--model-extraction <id>データ抽出用モデル
--model-exploration <id>探索ループ用モデル
--model-exploration-light <id>軽量な探索用モデル
--model-review <id>レビュー・修正提案用モデル
--model-fallback <id>Agent Fallback 用モデル

​
詳細設定

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

​
使用例

​
基本的な生成

npx @basemachina/agentic-browser-cli generate -- \
  --url "https://app.example.com/login" \
  --goal "メールアドレスとパスワードでログインし、設定ページに移動する" \
  --output ./login-settings.yaml \
  --context ./context.md \
  --secrets ./secrets.json \
  --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 generate -- \
  --url "https://staging.example.com" \
  --goal "「テストプロジェクト」という新しいプロジェクトを作成する" \
  --output ./create-project.yaml \
  --headless false

​
コンテキストファイル付き

アプリの理解を助ける追加コンテキストを提供： 
npx @basemachina/agentic-browser-cli generate -- \
  --url "https://app.example.com" \
  --goal "月次レポートを CSV でエクスポートする" \
  --output ./export-report.yaml \
  --context ./app-guide.md

​
シークレット付き

npx @basemachina/agentic-browser-cli generate -- \
  --url "https://app.example.com/login" \
  --goal "ログインしてダッシュボードを表示する" \
  --output ./login.yaml \
  --secrets ./secrets.json
secrets.json の内容： 
{
  "email": "[email protected]",
  "password": "s3cret!"
}

​
OpenAI を使用

export OPENAI_API_KEY="sk-..."

npx @basemachina/agentic-browser-cli generate -- \
  --url "https://app.example.com" \
  --goal "お問い合わせフォームに入力する" \
  --output ./contact-form.yaml \
  --model "gpt-4o" \
  --model-provider openai

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

npx @basemachina/agentic-browser-cli generate -- \
  --url "https://app.example.com" \
  --goal "オンボーディングフローを完了する" \
  --output ./onboarding.yaml \
  --screenshots ./screenshots \
  --video ./videos

​
環境変数

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

​
出力

コマンドは指定された --output パスに手順書ファイルを出力します。手順書には以下が含まれます：
  • goal — 元のゴール
  • url — 開始 URL
  • variables — 抽出された変数（ある場合）
  • steps — セレクタ、値、説明付きのアクションの順序リスト
出力例はクイックスタートを参照してください。