ローカル自動化 API
サイドバーで「自動化 API」を開き、「ローカル API を起動」をクリックします。Prism に API のアドレス（127.0.0.1 上のランダムなポート）と今回のアクセストークンが表示されます。トークンは一度しか表示されず、API を停止すると無効になります。
| リクエスト | 機能 |
|---|---|
| GET /v1/status | サービスの状態 |
| GET /v1/profiles | プロファイルの一覧：番号、名前、グループ、タグ、状態、最後に開いた日時 |
| GET /v1/profiles/{id}/status | 個別のプロファイルの状態を取得 |
| POST /v1/profiles/{id}/start | プロファイルを起動（画面から起動する場合と同じプロキシの事前チェックと同時起動数の制限を適用） |
| POST /v1/profiles/{id}/close | プロファイルを閉じる |
| POST /v1/profiles | 名前、グループ、プロキシ、フィンガープリントを指定してプロファイルを 1 つ作成（0.3.22 以降） |
| POST /v1/profiles/batch | 1 回で 1–50 個のプロファイルを作成。全件が検証を通過した場合のみ保存（0.3.22 以降） |
curl -H "Authorization: Bearer $PRISM_TOKEN" http://127.0.0.1:$PRISM_PORT/v1/profiles
curl -X POST -H "Authorization: Bearer $PRISM_TOKEN" http://127.0.0.1:$PRISM_PORT/v1/profiles/$PROFILE_ID/start- この PC からのリクエストのみを受け付けます。Host は API のアドレスと一致している必要があり、ブラウザの Origin ヘッダーまたはクエリパラメーターを含むリクエストは拒否されます（JSON のリクエストボディを受け付けるのは作成エンドポイントのみ）。そのため、ウェブページから直接呼び出すことはできません。
- リクエストは 1 分あたり最大 120 件です（MCP のローカルブリッジと共通の上限）。
- API でできるのはプロファイルの作成、照会、起動、終了で、プロファイルの編集や削除、ブラウザのデータの読み取りはできません。API 自体は Puppeteer / Playwright 用のデバッグエンドポイントを提供しません（Windows 版では内部制御のために 127.0.0.1 上でランダムなデバッグポートを開きますが、これは公開インターフェースではありません）。
- 「緊急停止」を使うと、API で起動したプロファイルが閉じられます。呼び出しの記録は、この PC の監査ログに書き込まれます。
リクエストのルール、レスポンスのフィールド、エラーコード、Python / Node.js のコード例はローカル API リファレンスをご覧ください。
ローカルのスケジュールタスク
| 設定 | 選択肢 |
|---|---|
| 実行するアクション | プロファイルを起動 / プロファイルを閉じる |
| 繰り返し | 1 回のみ / 毎日 / 毎週（日曜日～土曜日から複数選択可） |
| 実行時刻 | このデバイスの時刻とタイムゾーン |
| 実行されなかったタスク | 24 時間以内なら 1 回だけ遅れて実行 / 今回はスキップ |
| 失敗時の再試行 | 0–3 回、再試行の間隔は 1–60 分 |
- スケジュールタスクは Prism の起動中にのみ実行され、常駐するバックグラウンドプロセスはありません。実行時刻を迎えたタスクを 15 秒ごとに確認し、同時に実行するのは最大 2 件です。
- 「今すぐ実行」でタスクをテストできます。スケジュールタスクで使われているプロファイルを削除するには、先にそのタスクを削除する必要があります。
- Pro のライセンスが無効になるとスケジュール実行は一時停止しますが、タスクは保持され、無効化や削除は引き続き行えます。
組み合わせの例
始業時に作業用プロファイルを自動で起動
毎日 09:00 によく使うプロファイルを起動し、終業前に閉じます。手作業や、誤ったプロファイルを開くミスを減らせます。
スクリプトで一括起動・終了
自作のスクリプトでまず GET /v1/profiles を呼び出してプロファイル ID を取得し、順番に起動します。起動処理は画面から起動した場合と同じです。
続きは AI に任せる
プロファイルの起動後は、MCP を通じて、あなたが許可したプロファイル内で AI がページを読み取り、後続の手順を進めます。
よくある質問
- カスタムスクリプトや RPA フローを実行できますか？
- スケジュールタスクが対応しているのはプロファイルの起動と終了だけで、API もスクリプトは実行しません。ページ単位の操作が必要な場合は、Pro の MCP を使うか、プロファイルに拡張機能を自分でインストールしてください。
- 他のアンチディテクトブラウザの API と互換性はありますか？
- ありません。Prism は独自のローカルインターフェースを使用しています。パスは上の表をご覧ください。
- Prism を終了しても、スケジュールタスクは実行されますか？
- 実行されません。スケジュールタスクは Prism の起動中にのみ動作します。実行されなかったタスクは、設定に応じて 24 時間以内なら 1 回だけ遅れて実行できます。