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

# Browser Use（クラウド）

> Browser Use クラウド API による AI ブラウザ自動化

## 概要

Browser Use ツールは、ホスティングされた [Browser Use](https://browser-use.com) のクラウド API を通じてブラウザ自動化タスクを実行します。やりたいことを自然言語で記述するだけで、エージェントが Web サイトを操作し、フォーム入力やデータ抽出を行います。E2B サンドボックス内で実行するセルフホスト版（セッションの再利用やスクリーンショットに対応）については [Browser Use（サンドボックス）](/ja/pages/tools/sandbox/browser_use_sandbox) を参照してください。

## 主な機能

* `BROWSER_USE_RUN_TASK`
  * 自然言語の `task` から Browser Use のタスクを作成し、デフォルトでは完了まで待機
  * `max_steps` でエージェントのステップ数の上限を指定（デフォルト: 100）
  * `wait_for_completion`（デフォルト: `true`）でタスク完了までポーリング。`false` にするとタスク作成直後に結果を返却
  * `timeout_seconds`（デフォルト: 300）で完了を待つ最大時間を指定

## 認証

config の `api_key` に Browser Use の API キー（シークレットタイプ `BROWSER_USE`）を設定します。空欄にすると Jinba クレジットで実行され、`max_steps` に応じたクレジットが予約されます（デフォルトの 100 ステップで 320 クレジット）。

**注意**: API キーは機密情報として扱い、公開リポジトリにコミットしないでください。

## 使用例

### 例：Web サイトからデータを抽出する

```yaml theme={null}
- id: browse
  name: browse
  tool: BROWSER_USE_RUN_TASK
  config:
    - name: api_key
      value: "{{secrets.BROWSER_USE}}"
  input:
    - name: task
      value: https://news.ycombinator.com を開き、上位 5 件の記事のタイトルと URL を JSON 配列で返してください。
    - name: max_steps
      value: 30
    - name: timeout_seconds
      value: 300

- id: summarize
  name: summarize
  tool: OPENAI_INVOKE
  config:
    - name: version
      value: gpt-4
  input:
    - name: prompt
      value: |
        次の記事を 1 段落で要約してください：
        {{steps.browse.result.output}}
```

### 例：完了を待たずにタスクを開始する

```yaml theme={null}
- id: start_task
  name: start_task
  tool: BROWSER_USE_RUN_TASK
  input:
    - name: task
      value: https://example.com を開いてページタイトルを報告してください。
    - name: wait_for_completion
      value: false
```

## 注意事項

* `result` には `task_id`、`status`、`output`（エージェントの最終回答テキスト）、`steps` が含まれます。`steps` はエージェントのステップごとに `number`、`memory`、`evaluationPreviousGoal`、`nextGoal`、`url`、`screenshotUrl`、`actions` を持ちます。`wait_for_completion: false` の場合は `task_id` と `status: created` のみが返されます。
* 完了は 3 秒間隔でポーリングされます。完了したタスクは `status: finished` または `status: failed` を返します。先に `timeout_seconds` を超えた場合は `status: timeout` とエラーを返し、タスク自体は Browser Use 側で実行が続きます。
* `task` のテキストは、組織の設定に従って個人情報をマスクしたうえで Browser Use に送信されます。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.