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

​
概要

npx @refrainai/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ステップ間の待機時間（ミリ秒）
--headless <bool>truefalse でブラウザウィンドウを表示

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

引数デフォルト説明
--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

​
詳細設定

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

​
使用例

​
基本的な生成

npx @refrainai/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
環境変数でデフォルトモデル・プロバイダーを設定すれば、毎回指定する必要がなくなります。詳しくはデフォルトモデルの設定を参照してください。

​
ブラウザを表示して生成

npx @refrainai/cli generate -- \
  --url "https://staging.example.com" \
  --goal "「テストプロジェクト」という新しいプロジェクトを作成する" \
  --output ./create-project.yaml \
  --headless false

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

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

​
シークレット付き

npx @refrainai/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 @refrainai/cli generate -- \
  --url "https://app.example.com" \
  --goal "お問い合わせフォームに入力する" \
  --output ./contact-form.yaml \
  --model "gpt-4o" \
  --model-provider openai

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

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

​
環境変数

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