コンテンツへスキップ

ブラウザ RPA

ブラウザ RPA は、ローカルの Chromium ブラウザプロファイルで繰り返し行う作業を自動化します。ページを開いて要素を操作し、結果を読み取り、条件やループでフローを制御できます。ワークフローはテンプレートとして作成して MoreLogin アカウントに保存し、デスクトップクライアントまたはブラウザ RPA Local API からブラウザプロファイル上で実行します。

このセクションは、プログラムからテンプレートを作成して実行する開発者と AI エージェントを対象としています。Android クラウドスマホを自動化する場合は、クラウドスマホ RPAを参照してください。

前提条件

  • MoreLogin デスクトップクライアント V2.73.0 以降が起動していて、ログインしている必要があります。テンプレートはログイン中のアカウントに保存され、クライアントのカスタムテンプレートに表示されます。
  • Local API に http://127.0.0.1:<port>/api/rpa/browser/v1 でアクセスできる必要があります。ポートには、クライアントの設定に表示される Local API のポートを使用してください。既定値は 40000 です。
  • 認証は、ほかの Local API と同じ方法で行います。認証を参照してください。
  • 実行には Chromium ブラウザプロファイル(browserTypeId: 1)が必要です。
  • GET /capabilities は、お使いのクライアントとアカウントで利用できる操作、上限、ドキュメントの URL を返します。テンプレートを作成する前に確認してください。

主な概念

概念意味
テンプレートタイトル、説明、子テンプレートへの依存関係を持つ保存済みのワークフローです。保存するたびに新しいバージョンが作成されます。
ワークフローテンプレート内のノードを順序どおりに並べたツリーです。1 つの start ノードで始まり、1 つの end ノードで終わります。
ノードURL を開く、要素をクリックするといった 1 つのステップです。各ノードタイプには、入力と出力を定義する契約があります。
環境実行で使用するブラウザプロファイルです。environmentId は、ブラウザ Local API におけるプロファイルの envId です。
実行保存済みテンプレートの特定のバージョンを、ある環境で 1 回実行したものです。実行にはノード実行記録と成果物があります。
リクエスト受領記録Idempotency-Key を付けて送信した書き込みリクエストについて、保存された処理結果です。タイムアウトの後に実際に何が起きたかを確認するために使用します。

この API とほかの Local API エンドポイントの違い

ブラウザ RPA のエンドポイントは、共通レスポンス形式で説明している {code, msg, data} 形式を使用しません。

  • 201、202、409、412、422、429、503 などの実際の HTTP ステータスコードを返します。
  • 成功時の本文は {data, meta}、エラー時の本文は {error, meta} です。エラーコードは RPA_VALIDATION_FAILED のような文字列です。エラーコードを参照してください。
  • 書き込みリクエストでは、Idempotency-Key、If-Match、X-RPA-Catalog-Revision の各ヘッダーを使用します。書き込みリクエストに必要なヘッダーを参照してください。
  • 認証に失敗した場合は、Local API 標準の 401 形式で返されます。

はじめに

  1. クイックスタート:機能とノード契約を確認し、最終的なページ URL を返すテンプレートを検証して保存します。
  2. API でテンプレートを実行:保存したバージョンを事前検証し、実行を開始して結果を読み取ります。
  3. 共通フィールドとワークフロー構造:ワークフローの構成、参照、タイムアウト、再試行について学びます。
  4. ノードカタログ:各ノードの入力、既定値、参照、出力を調べます。
  5. Local API リファレンス:すべてのエンドポイント、書き込みに必要なヘッダー、タイムアウトやバージョン競合からのリカバリー方法を確認します。

テンプレートを手動で実行する場合は、デスクトップクライアントでテンプレートを実行を参照してください。