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 を選択してください。
認証の詳細については、認証を参照してください。
| 操作 | 説明 |
|---|---|
| 起動 | クラウドブラウザ環境を起動します |
| 停止 | 実行中の環境を停止します（強制解放も選択可能） |
| ページ | 名前、グループ、キーワードで絞り込んで環境をページ単位で取得します |
| 接続 | 実行中の環境の CDP アドレスを取得し、自動化ツールを接続します |
envIdを指定して環境を起動します。環境はSTARTING状態になります。cloudBrowserStatusがRUNNINGになるまでページ一覧をポーリングします。- 接続して
cdpUrlを取得し、CDP 経由で Puppeteer / Playwright / Selenium を接続します。 - 自動化が完了したら環境を停止します。
| ステータス | 説明 |
|---|---|
STARTING | 起動中 |
RUNNING | 実行中 |
CLOSED | 終了済み |
接続エンドポイントは 2 つのアドレスを返します：
{
"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 | https://api.morelogin.com 経由のリモートアクセス、OAuth2 認証 |
| クラウドブラウザ ローカル API | http://127.0.0.1:40000 経由のローカルアクセス、トークン認証 |
注意：両方の API は同じ操作を提供します。ローカル API のパスは
/api/cloudbrowser/...プレフィックスを使用し、オープン API のパスは/cloudbrowser/...を使用します。正確なパスとパラメータは、必ず該当する API リファレンスを参照してください。