> ## Documentation Index
> Fetch the complete documentation index at: https://docs.therefrain.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# generate

> AI によるブラウザ探索で手順書を生成します。

## 概要

```bash theme={null}
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>`      | `true` | `false` でブラウザウィンドウを表示 |

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

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

### 出力・デバッグ

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

### AI モデル

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

### 詳細設定

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

<Note>
  `--stealth` と `--proxy` は Pro プラン以上が必要です。`--skill` は Pro プラン以上が必要です。
</Note>

## 使用例

### 基本的な生成

```bash theme={null}
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
```

<Tip>
  環境変数でデフォルトモデル・プロバイダーを設定すれば、毎回指定する必要がなくなります。詳しくは[デフォルトモデルの設定](/ja/guides/ai-setup#デフォルトモデル)を参照してください。
</Tip>

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

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

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

アプリの理解を助ける追加コンテキストを提供：

```bash theme={null}
npx @refrainai/cli generate -- \
  --url "https://app.example.com" \
  --goal "月次レポートを CSV でエクスポートする" \
  --output ./export-report.yaml \
  --context ./app-guide.md
```

### シークレット付き

```bash theme={null}
npx @refrainai/cli generate -- \
  --url "https://app.example.com/login" \
  --goal "ログインしてダッシュボードを表示する" \
  --output ./login.yaml \
  --secrets ./secrets.json
```

`secrets.json` の内容：

```json theme={null}
{
  "email": "admin@example.com",
  "password": "s3cret!"
}
```

### OpenAI を使用

```bash theme={null}
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
```

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

```bash theme={null}
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`） |