# クラウドブラウザ

MoreLogin API を使用して、クラウドブラウザ環境の起動、停止、接続、管理をプログラムから行えます。

## 概要

クラウドブラウザ API は、MoreLogin のブラウザプロファイルをリモートホスト上で実行します。環境を起動した後、Chrome DevTools プロトコル（CDP）で接続し、Puppeteer、Playwright、Selenium などの自動化フレームワークから操作できます。

**クラウドブラウザは 2 種類の API アクセス方法に対応しています：**

| 方法 | Base URL | ユースケース |
|  --- | --- | --- |
| **オープン API**（リモート） | `https://api.morelogin.com` | どこからでもアクセス可能、OAuth2 認証 |
| **ローカル API**（ローカル） | `http://127.0.0.1:40000` | MoreLogin クライアントを実行しているマシンからアクセス |


> リモートアクセスやサーバー間連携が必要な場合は**オープン API** を選択してください。
MoreLogin クライアントと同じマシンで自動化を実行する場合は**ローカル API** を選択してください。


認証の詳細については、[認証](/ja/api-reference/getting-started/authentication)を参照してください。

## 機能

| 操作 | 説明 |
|  --- | --- |
| **起動** | クラウドブラウザ環境を起動します |
| **停止** | 実行中の環境を停止します（強制解放も選択可能） |
| **ページ** | 名前、グループ、キーワードで絞り込んで環境をページ単位で取得します |
| **接続** | 実行中の環境の CDP アドレスを取得し、自動化ツールを接続します |


## 一般的なワークフロー

1. `envId` を指定して環境を**起動**します。環境は `STARTING` 状態になります。
2. `cloudBrowserStatus` が `RUNNING` になるまでページ一覧を**ポーリング**します。
3. **接続**して `cdpUrl` を取得し、CDP 経由で Puppeteer / Playwright / Selenium を接続します。
4. 自動化が完了したら環境を**停止**します。


## 環境ステータス

| ステータス | 説明 |
|  --- | --- |
| `STARTING` | 起動中 |
| `RUNNING` | 実行中 |
| `CLOSED` | 終了済み |


## 接続情報

接続エンドポイントは 2 つのアドレスを返します：

```json
{
  "code": 0,
  "msg": null,
  "data": {
    "cdpUrl": "https://runtime1.morelogin.com:16167?token=c62fedaaac524e41a0f02fc4345d41cb",
    "accessUrl": "https://official-website.morelogin.com/browser-remote?token=eyJkZXNrdG9wVXJsIjoi...ZW52SWQiOiIyMDczMzk1NDg5NzM4OTE5OTM2In0%3D&envName=P-1267&lang=en-US"
  }
}
```

| フィールド | 説明 |
|  --- | --- |
| `cdpUrl` | アクセス `token` を含む CDP エンドポイント。Puppeteer、Playwright、Selenium に渡します。 |
| `accessUrl` | セッションを表示・操作するためのブラウザベースのリモートデスクトップページ。未設定の場合は空です。 |


> `accessUrl` の `token` は、デスクトップ URL、デスクトップトークン、有効期限、チーム・ユーザー・メンバー・環境の各 ID を含む Base64 エンコードされたペイロードです。どちらの URL も資格情報として扱い、共有しないでください。


## API リファレンス

| API | 説明 |
|  --- | --- |
| [クラウドブラウザ オープン API](/ja/api-reference/cloud-browser/open-api) | `https://api.morelogin.com` 経由のリモートアクセス、OAuth2 認証 |
| [クラウドブラウザ ローカル API](/ja/api-reference/cloud-browser/local-api) | `http://127.0.0.1:40000` 経由のローカルアクセス、トークン認証 |


> **注意**：両方の API は同じ操作を提供します。ローカル API のパスは `/api/cloudbrowser/...` プレフィックスを使用し、オープン API のパスは `/cloudbrowser/...` を使用します。正確なパスとパラメータは、必ず該当する API リファレンスを参照してください。


## 関連ガイド

| ガイド | 説明 |
|  --- | --- |
| [認証](/ja/api-reference/getting-started/authentication) | OAuth2 トークン設定（オープン API）とトークン認証（ローカル API） |
| [クイックスタート](/ja/api-reference/getting-started/quickstart) | 最初の MoreLogin API 呼び出しを実行します |